.TH "DOVEADM-MAILBOX-CRYPTOKEY" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm\-mailbox\-cryptokey \- مدیریت افزونه رمزنگاری ایمیل (Mail crypt)
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fB\-o\fR \fIcrypt_user_key_password=password\fR\[rB] \[lB]\fIگزینه‌های_عمومی\fR\[rB] \fImailbox cryptokey export|generate|list|password\fR \[lB]\fIگزینه‌ها\fR\[rB] \[lB]\fIآرگومان‌ها\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
تولید جفت‌کلید جدید برای کاربر یا پوشه. جفت‌کلید جدید به عنوان فعال علامت‌گذاری می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.P
دستور \fBdoveadm mailbox cryptokey\fR می‌تواند برای مدیریت کلیدهای رمزنگاری کاربر استفاده شود.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی \fBdoveadm\fR(1):
.P
\fB\-D\fR
.RS 0
.RS 4
.P
پیام‌های اشکال‌زدایی (debug) و پرگویی (verbosity) را فعال می‌کند.
.RE 0

.RE 0

.P
\fB\-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی را نمی‌خواند و فقط از مقادیر پیش‌فرض استفاده می‌کند. مقدار تنظیم \fBdovecot_storage_version\fR به طور پیش‌فرض روی آخرین نسخه قرار دارد، اما می‌توان آن را با \fB\-o\fR بازنویسی کرد.
.RE 0

.RE 0

.P
\fB\-k\fR
.RS 0
.RS 4
.P
تمام محیط را برای doveadm حفظ می‌کند، نه فقط مقدار تنظیم \fBimport_environment\fR را.
.RE 0

.RE 0

.P
\fB\-v\fR
.RS 0
.RS 4
.P
پرگویی را فعال می‌کند، شامل شمارنده پیشرفت.
.RE 0

.RE 0

.P
\fB\-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چندین نمونه Dovecot، فایل پیکربندی را بر اساس نام این نمونه انتخاب می‌کند.
.P
برای اطلاعات بیشتر تنظیم \fBinstance_name\fR را ببینید.
.RE 0

.RE 0

.P
\fB\-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از \fIconfig-file\fR داده‌شده می‌خواند. به طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و سپس در صورت عدم دسترسی از \fI/etc/dovecot/dovecot.conf\fR استفاده می‌کند. همچنین می‌توانید آن را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند هدایت کنید.
.RE 0

.RE 0

.P
\fB\-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیم پیکربندی \fIsetting\fR را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با مقدار \fIvalue\fR داده‌شده بازنویسی می‌کند. برای بازنویسی چندین تنظیم، گزینه \fB\-o\fR می‌تواند چندین بار مشخص شود.
.RE 0

.RE 0

.P
\fB\-f\fR \fIformatter\fR
.RS 0
.RS 4
.P
قالب‌بند (\fIformatter\fR) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:
.P
\fBflow\fR
.RS 4
.P
هر خط را به صورت جفت‌های \fIkey\fR\fB=\fR\fIvalue\fR چاپ می‌کند.
.RE 0

.P
\fBjson\fR
.RS 4
.P
یک آرایه JSON از اشیاء JSON چاپ می‌کند.
.RE 0

.P
\fBpager\fR
.RS 4
.P
هر جفت \fIkey\fR: \fIvalue\fR را در خط جداگانه چاپ کرده و رکوردها را با نویسه فرم‌فید (\fB^L\fR) از هم جدا می‌کند.
.RE 0

.P
\fBtab\fR
.RS 4
.P
یک سربرگ جدول و به دنبال آن خطوط مقادیر جداشده با تب را چاپ می‌کند.
.RE 0

.P
\fBtable\fR
.RS 4
.P
یک سربرگ جدول و به دنبال آن خطوط مقادیر تراز شده را چاپ می‌کند.
.RE 0

.RE 0

.RE 0

.P
\fB\-o\fR \fIcrypt_user_key_password=password\fR
.RS 0
.RS 4
.P
گزینه Dovecot، در صورت استفاده از کلیدهای محافظت‌شده با گذرواژه مورد نیاز است.
.RE 0

.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
\fB\-A\fR
.RS 0
.RS 4
.P
اگر گزینه \fB\-A\fR مشخص شود، \fIدستور\fR برای همه کاربران اجرا خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم \fBfirst_valid_uid\fR نیز می‌شود.
.P
هنگام استفاده از ماژول SQL userdb، مطمئن شوید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه‌داده شما مطابقت دارد.
.P
هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیمات \fBuserdb_fields\fR و \fBuserdb_ldap_iterate_fields\fR با طرحواره LDAP شما مطابقت دارند. در غیر این صورت \fBdoveadm\fR(1) قادر به پیمایش روی همه کاربران نخواهد بود.
.RE 0

.RE 0

.P
\fB\-F\fR \fIfile\fR
.RS 0
.RS 4
.P
\fIدستور\fR را برای همه کاربران موجود در \fIfile\fR اجرا می‌کند. این شبیه به گزینه \fB\-A\fR است، اما به جای دریافت فهرست کاربران از userdb، اسامی از \fIfile\fR داده‌شده خوانده می‌شوند. این \fIfile\fR شامل یک نام کاربری در هر خط است.
.RE 0

.RE 0

.P
\fB\-\-no\-userdb\-lookup\fR
.RS 0
.RS 4
.P
جستجوی userdb انجام نمی‌شود. از متغیر محیطی \fBUSER\fR برای تعیین نام کاربری استفاده کنید.
.RE 0

.RE 0

.P
\fB\-S\fR \fIsocket_path\fR
.RS 0
.RS 4
.P
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت دامنه یونیکس (UNIX domain socket) محلی است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR)، جهت اتصال به میزبان راه دور از طریق سوکت TCP.
.P
این به مدیر سیستم اجازه می‌دهد دستورات پستی \fBdoveadm\fR(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

.P
\fB\-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
\fIدستور\fR را فقط برای \fIکاربر\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عمومی «\fB*\fR» و «\fB?\fR» وجود دارد (مثلاً ‎-u *@example.org‎).
.RE 0

.RE 0

.SH "زیردستورها (SUBCOMMANDS)"
.P
\fBexport\fR \[lB]\fB\-U\fR\[rB] | \fImailbox\-mask\fR
.P
\fB\-U\fR
.RS 0
.RS 4
.P
فقط روی جفت‌کلید کاربر عمل می‌کند.
.RE 0

.RE 0

.P
جفت‌کلید(های) کاربر یا پوشه را در قالب PEM صادر می‌کند (خروجی می‌گیرد). اگر کلیدها با گذرواژه محافظت شده باشند، \fB\-o\fR مورد نیاز است.
.P
\fBgenerate\fR \[lB]\fB\-Rf\fR \[lB]\fB\-U\fR\[rB] | \fImailbox\-mask\fR\[rB]
.P
\fB\-U\fR
.RS 0
.RS 4
.P
فقط روی جفت‌کلید کاربر عمل می‌کند.
.RE 0

.RE 0

.P
\fB\-R\fR
.RS 0
.RS 4
.P
رمزگذاری مجدد تمام کلیدهای پوشه با کلید کاربری فعال فعلی.
.RE 0

.RE 0

.P
\fB\-f\fR
.RS 0
.RS 4
.P
اجبار به ایجاد جفت‌کلید؛ به طور معمول جفت‌کلید تنها زمانی ایجاد می‌شود که هیچ کلیدی یافت نشود.
.RE 0

.RE 0

.P
تولید جفت‌کلید جدید برای کاربر یا پوشه. اگر می‌خواهید یک کلید کاربری جدید تولید کنید و از آن برای ایمن‌سازی کلیدهای پوشه خود بهره ببرید، از ‎generate \-u username \-UR‎ استفاده کنید.
.P
اگر می‌خواهید کلید خود را در اینجا با گذرواژه محافظت کنید، از \fB\-o\fR استفاده کنید.
.P
\fBlist\fR \[lB]\fB\-U\fR\[rB] | \fImailbox\-mask\fR
.P
\fB\-U\fR
.RS 0
.RS 4
.P
فقط روی جفت‌کلید کاربر عمل می‌کند.
.RE 0

.RE 0

.P
فهرست کردن تمام کلیدها برای کاربر یا پوشه. نیازی به گذرواژه نیست.
.P
\fBpassword\fR \[lB]\fB\-N\fR | \fB\-n\fR \fIpassword\fR\[rB] \[lB]\fB\-O\fR|\fB\-o\fR \fIpassword\fR\[rB] \[lB]\fB\-C\fR\[rB]
.P
\fB\-O\fR
.RS 0
.RS 4
.P
درخواست گذرواژه قدیمی.
.RE 0

.RE 0

.P
\fB\-o old\-password\fR
.RS 0
.RS 4
.P
ارائه گذرواژه قدیمی.
.RE 0

.RE 0

.P
\fB\-N\fR
.RS 0
.RS 4
.P
درخواست گذرواژه جدید.
.RE 0

.RE 0

.P
\fB\-n new\-password\fR
.RS 0
.RS 4
.P
ارائه گذرواژه جدید.
.RE 0

.RE 0

.P
\fB\-C\fR
.RS 0
.RS 4
.P
پاک کردن (حذف) گذرواژه. کلید شما با گذرواژه محافظت نخواهد شد.
.RE 0

.RE 0

.P
تنظیم، تغییر یا پاک کردن گذرواژه از کلید کاربری شما.
.SH "همچنین ببینید (SEE ALSO)"
.P
\fBdoveadm\fR(1), \fBdoveadm\-mailbox\fR(1)