DOVEADM-MAILBOX-CRYPTOKEY(1) Dovecot DOVEADM-MAILBOX-CRYPTOKEY(1)

doveadm-mailbox-cryptokey - مدیریت افزونه رمزنگاری ایمیل (Mail crypt)

doveadm [-o crypt_user_key_password=password] [گزینه‌های_عمومی] mailbox cryptokey export|generate|list|password [گزینه‌ها] [آرگومان‌ها]

تولید جفت‌کلید جدید برای کاربر یا پوشه. جفت‌کلید جدید به عنوان فعال علامت‌گذاری می‌شود.

دستور doveadm mailbox cryptokey می‌تواند برای مدیریت کلیدهای رمزنگاری کاربر استفاده شود.

گزینه‌های عمومی doveadm(1):

-D

پیام‌های اشکال‌زدایی (debug) و پرگویی (verbosity) را فعال می‌کند.

-O

هیچ فایل پیکربندی را نمی‌خواند و فقط از مقادیر پیش‌فرض استفاده می‌کند. مقدار تنظیم dovecot_storage_version به طور پیش‌فرض روی آخرین نسخه قرار دارد، اما می‌توان آن را با -o بازنویسی کرد.

-k

تمام محیط را برای doveadm حفظ می‌کند، نه فقط مقدار تنظیم import_environment را.

-v

پرگویی را فعال می‌کند، شامل شمارنده پیشرفت.

-i instance-name

در صورت استفاده از چندین نمونه Dovecot، فایل پیکربندی را بر اساس نام این نمونه انتخاب می‌کند.

برای اطلاعات بیشتر تنظیم instance_name را ببینید.

-c config-file

پیکربندی را از config-file داده‌شده می‌خواند. به طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و سپس در صورت عدم دسترسی از /etc/dovecot/dovecot.conf استفاده می‌کند. همچنین می‌توانید آن را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند هدایت کنید.

-o setting=value

تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از userdb با مقدار value داده‌شده بازنویسی می‌کند. برای بازنویسی چندین تنظیم، گزینه -o می‌تواند چندین بار مشخص شود.

-f formatter

قالب‌بند (formatter) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:

flow

هر خط را به صورت جفت‌های key=value چاپ می‌کند.

json

یک آرایه JSON از اشیاء JSON چاپ می‌کند.

pager

هر جفت key: value را در خط جداگانه چاپ کرده و رکوردها را با نویسه فرم‌فید (^L) از هم جدا می‌کند.

tab

یک سربرگ جدول و به دنبال آن خطوط مقادیر جداشده با تب را چاپ می‌کند.

table

یک سربرگ جدول و به دنبال آن خطوط مقادیر تراز شده را چاپ می‌کند.

-o crypt_user_key_password=password

گزینه Dovecot، در صورت استفاده از کلیدهای محافظت‌شده با گذرواژه مورد نیاز است.

-A

اگر گزینه -A مشخص شود، دستور برای همه کاربران اجرا خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از userdb { driver = passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم first_valid_uid نیز می‌شود.

هنگام استفاده از ماژول SQL userdb، مطمئن شوید که تنظیم userdb_sql_iterate_query با ساختار پایگاه‌داده شما مطابقت دارد.

هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیمات userdb_fields و userdb_ldap_iterate_fields با طرحواره LDAP شما مطابقت دارند. در غیر این صورت doveadm(1) قادر به پیمایش روی همه کاربران نخواهد بود.

-F file

دستور را برای همه کاربران موجود در file اجرا می‌کند. این شبیه به گزینه -A است، اما به جای دریافت فهرست کاربران از userdb، اسامی از file داده‌شده خوانده می‌شوند. این file شامل یک نام کاربری در هر خط است.

--no-userdb-lookup

جستجوی userdb انجام نمی‌شود. از متغیر محیطی USER برای تعیین نام کاربری استفاده کنید.

-S socket_path

آرگومان این گزینه یا یک مسیر مطلق به یک سوکت دامنه یونیکس (UNIX domain socket) محلی است، یا یک نام میزبان و درگاه (hostname:port)، جهت اتصال به میزبان راه دور از طریق سوکت TCP.

این به مدیر سیستم اجازه می‌دهد دستورات پستی doveadm(1) را از طریق سوکت داده‌شده اجرا کند.

-u user/mask

دستور را فقط برای کاربر داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عمومی «*» و «?» وجود دارد (مثلاً ‎-u *@example.org‎).

export [-U] | mailbox-mask

-U

فقط روی جفت‌کلید کاربر عمل می‌کند.

جفت‌کلید(های) کاربر یا پوشه را در قالب PEM صادر می‌کند (خروجی می‌گیرد). اگر کلیدها با گذرواژه محافظت شده باشند، -o مورد نیاز است.

generate [-Rf [-U] | mailbox-mask]

-U

فقط روی جفت‌کلید کاربر عمل می‌کند.

-R

رمزگذاری مجدد تمام کلیدهای پوشه با کلید کاربری فعال فعلی.

-f

اجبار به ایجاد جفت‌کلید؛ به طور معمول جفت‌کلید تنها زمانی ایجاد می‌شود که هیچ کلیدی یافت نشود.

تولید جفت‌کلید جدید برای کاربر یا پوشه. اگر می‌خواهید یک کلید کاربری جدید تولید کنید و از آن برای ایمن‌سازی کلیدهای پوشه خود بهره ببرید، از ‎generate -u username -UR‎ استفاده کنید.

اگر می‌خواهید کلید خود را در اینجا با گذرواژه محافظت کنید، از -o استفاده کنید.

list [-U] | mailbox-mask

-U

فقط روی جفت‌کلید کاربر عمل می‌کند.

فهرست کردن تمام کلیدها برای کاربر یا پوشه. نیازی به گذرواژه نیست.

password [-N | -n password] [-O|-o password] [-C]

-O

درخواست گذرواژه قدیمی.

-o old-password

ارائه گذرواژه قدیمی.

-N

درخواست گذرواژه جدید.

-n new-password

ارائه گذرواژه جدید.

-C

پاک کردن (حذف) گذرواژه. کلید شما با گذرواژه محافظت نخواهد شد.

تنظیم، تغییر یا پاک کردن گذرواژه از کلید کاربری شما.

doveadm(1), doveadm-mailbox(1)

May 2026 e5ac02a