borg-key-change-passphrase(1) borg backup tool borg-key-change-passphrase(1)

borg-key-change-passphrase - تغییر عبارت عبور کلید مخزن Borg

borg [common options] key change-passphrase [options] [REPOSITORY]

فایل‌های کلید که برای رمزگذاری مخزن به کار می‌روند، به‌طور اختیاری با عبارت عبور محافظت می‌شوند. از این دستور می‌توان برای تغییر این عبارت عبور استفاده کرد.

لطفاً توجه داشته باشید که این دستور فقط عبارت عبور را تغییر می‌دهد، نه هیچ‌یک از اسرار محافظت‌شده توسط آن (مانند کلیدهای رمزگذاری/MAC یا سید قطعه‌ساز [chunker seed]). بنابراین، تغییر عبارت عبور پس از افشا شدن یا به خطر افتادن عبارت عبور و کلید Borg، از نسخه‌های پشتیبان آینده (و گذشته) در همان مخزن محافظت نخواهد کرد.

برای مشاهده گزینه‌های عمومی دستورات Borg به borg-common(1) مراجعه کنید.

REPOSITORY

# ایجاد یک مخزن محافظت‌شده با فایل کلید
$ borg init --encryption=keyfile -v /path/to/repo
Initializing repository at "/path/to/repo"
Enter new passphrase:
Enter same passphrase again:
Remember your passphrase. Your data will be inaccessible without it.
Key in "/root/.config/borg/keys/mnt_backup" created.
Keep this key safe. Your data will be inaccessible without it.
Synchronizing chunks cache...
Archives: 0, w/ cached Idx: 0, w/ outdated Idx: 0, w/o cached Idx: 0.
Done.
# تغییر عبارت عبور فایل کلید
$ borg key change-passphrase -v /path/to/repo
Enter passphrase for key /root/.config/borg/keys/mnt_backup:
Enter new passphrase:
Enter same passphrase again:
Remember your passphrase. Your data will be inaccessible without it.
Key updated
# وارد کردن یک کلید از پیش برون‌بری‌شده به فایل کلید مشخص‌شده
# (ایجاد یا بازنویسی کلید خروجی)
# (فقط برای مخازن keyfile)
$ BORG_KEY_FILE=/path/to/output-key borg key import /path/to/repo /path/to/exported

کاملاً خودکار با استفاده از متغیرهای محیطی:

$ BORG_NEW_PASSPHRASE=old borg init -e=repokey repo
# اکنون "old" عبارت عبور فعلی است.
$ BORG_PASSPHRASE=old BORG_NEW_PASSPHRASE=new borg key change-passphrase repo
# اکنون "new" عبارت عبور فعلی است.

borg-common(1)

The Borg Collective

2026-07-18