.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "borg-key-change-passphrase" "1" "2026-07-18" "" "borg backup tool"
.SH "نام (NAME)"
borg-key-change-passphrase \- تغییر عبارت عبور کلید مخزن Borg
.SH "خلاصه دستور (SYNOPSIS)"
.sp
borg [common options] key change\-passphrase [options] [REPOSITORY]
.SH "توضیحات (DESCRIPTION)"
.sp
فایل‌های کلید که برای رمزگذاری مخزن به کار می‌روند، به‌طور اختیاری با عبارت عبور محافظت می‌شوند. از این دستور می‌توان برای تغییر این عبارت عبور استفاده کرد.
.sp
لطفاً توجه داشته باشید که این دستور فقط عبارت عبور را تغییر می‌دهد، نه هیچ‌یک از اسرار محافظت‌شده توسط آن (مانند کلیدهای رمزگذاری/MAC یا سید قطعه‌ساز [chunker seed]). بنابراین، تغییر عبارت عبور پس از افشا شدن یا به خطر افتادن عبارت عبور و کلید Borg، از نسخه‌های پشتیبان آینده (و گذشته) در همان مخزن محافظت نخواهد کرد.
.SH "گزینه‌ها (OPTIONS)"
.sp
برای مشاهده گزینه‌های عمومی دستورات Borg به \fIborg\-common(1)\fP مراجعه کنید.
.SS "آرگومان‌ها (arguments)"
.sp
REPOSITORY
.SH "مثال‌ها (EXAMPLES)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# ایجاد یک مخزن محافظت‌شده با فایل کلید
$ borg init \-\-encryption=keyfile \-v /path/to/repo
Initializing repository at \(dq/path/to/repo\(dq
Enter new passphrase:
Enter same passphrase again:
Remember your passphrase. Your data will be inaccessible without it.
Key in \(dq/root/.config/borg/keys/mnt_backup\(dq 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
.EE
.UNINDENT
.UNINDENT
.sp
کاملاً خودکار با استفاده از متغیرهای محیطی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ BORG_NEW_PASSPHRASE=old borg init \-e=repokey repo
# اکنون \(dqold\(dq عبارت عبور فعلی است.
$ BORG_PASSPHRASE=old BORG_NEW_PASSPHRASE=new borg key change\-passphrase repo
# اکنون \(dqnew\(dq عبارت عبور فعلی است.
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fIborg\-common(1)\fP
.SH "نویسندگان (AUTHORS)"
The Borg Collective
.\" End of generated man page.