.TH "DOVEADM-PW" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-pw\fR \- تولیدکننده و اعتبارسنج هش گذرواژه در Dovecot
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBpw -l\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBpw\fR \[lB]\fB-p\fR \fIpassword\fR\[rB] \[lB]\fB-r\fR \fIrounds\fR\[rB] \[lB]\fB-s\fR \fIscheme\fR\[rB] \[lB]\fB-u\fR \fIuser\fR\[rB] \[lB]\fB-V\fR\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBpw\fR \fB-t\fR \fIhash\fR \[lB]\fB-p\fR \fIpassword\fR\[rB] \[lB]\fB-u\fR \fIuser\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBdoveadm pw\fR برای تولید هش‌های گذرواژه برای \fIscheme\fRهای مختلف گذرواژه و به‌طور اختیاری اعتبارسنجی هش تولیدشده به کار می‌رود.
.P
همهٔ هش‌های گذرواژهٔ تولیدشده دارای پیشوند {\fIscheme\fR} هستند، برای نمونه {\fBSHA512-CRYPT.HEX\fR}. تمام passdbها دارای یک طرح‌وارهٔ پیش‌فرض برای گذرواژه‌های ذخیره‌شده بدون پیشوند {\fIscheme\fR} هستند. طرح‌وارهٔ پیش‌فرض را می‌توان با ذخیره کردن گذرواژه به همراه پیشوند طرح‌واره جایگزین (override) کرد.
.P
اگر می‌خواهید بدون نیاز به پیکربندی اولیهٔ Dovecot از این قابلیت برای اعتبارسنجی یا تولید گذرواژه‌ها استفاده کنید، می‌توانید دستور \fBdoveadm -O pw\fR را به کار ببرید.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
\fIگزینه‌های\fR عمومی doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
حالت پرگویی (\fIverbosity\fR) و پیام‌های اشکال‌زدایی را فعال می‌کند.
.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
حالت پرگویی (verbosity)، شامل شمارندهٔ پیشرفت را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چند نمونهٔ (instance) داکوت، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.
.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

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-l\fR
.RS 0
.RS 4
.P
تمام \fIscheme\fRهای گذرواژهٔ پشتیبانی‌شده را فهرست کرده و با موفقیت خارج می‌شود.
.P
حداکثر تا سه \fIscheme\fR اختیاری برای گذرواژه وجود دارد: \fBBLF-CRYPT\fR (رمزنگاری Blowfish)، \fBSHA256-CRYPT\fR و \fBSHA512-CRYPT\fR. در دسترس بودن آن‌ها به libc فعلی مورد استفاده در سیستم بستگی دارد.
.RE 0

.RE 0

.P
\fB-p\fR \fIpassword\fR
.RS 0
.RS 4
.P
گذرواژهٔ متنی ساده (\fIpassword\fR) که هش باید برای آن تولید شود. اگر هیچ \fIpassword\fRی مشخص نشود، doveadm(1) به‌صورت تعاملی آن را درخواست خواهد کرد. (توجه داشته باشید که استفاده از این گزینه باعث قرار گرفتن گذرواژهٔ متنی ساده در تاریخچهٔ شل شما می‌شود!)
.RE 0

.RE 0

.P
\fB-r\fR \fIrounds\fR
.RS 0
.RS 4
.P
طرح‌واره‌های (\fIscheme\fRهای) گذرواژهٔ \fBBLF-CRYPT\fR، \fBSHA256-CRYPT\fR و \fBSHA512-CRYPT\fR از تعداد متغیری دور رمزنگاری (\fIrounds\fR) پشتیبانی می‌کنند. جدول زیر کمینه/بیشینهٔ دورهای رمزنگاری (\fIrounds\fR) را برای هر طرح‌واره نشان می‌دهد. در صورت نادیده گرفتن گزینهٔ \fB-r\fR، تعداد دورهای پیش‌فرض رمزنگاری اعمال می‌شود.
.TS
tab(@) allbox;
cb cb cb cb
l l l l .
طرح‌واره (Scheme)@کمینه@بیشینه@پیش‌فرض
BLF-CRYPT@4@31@5
SHA256-CRYPT@1000@999999999@5000
SHA512-CRYPT@1000@999999999@5000
.TE
.RE 0

.RE 0

.P
\fB-s\fR \fIscheme\fR
.RS 0
.RS 4
.P
طرح‌وارهٔ (\fIscheme\fR) گذرواژه‌ای که باید برای تولید گذرواژهٔ هش‌شده استفاده شود. به‌طور پیش‌فرض، طرح‌وارهٔ \fBCRYPT\fR استفاده خواهد شد (با قالب $2y$ در bcrypt). همچنین افزودن یک پسوند کدگذاری به \fIscheme\fR امکان‌پذیر است. پسوندهای کدگذاری پشتیبانی‌شده عبارتند از: \fB.b64\fR، \fB.base64\fR و \fB.hex\fR.
.P
برای جزئیات بیشتر دربارهٔ طرح‌واره‌های گذرواژه، password_schemes را نیز ببینید.
.RE 0

.RE 0

.P
\fB-t\fR \fIhash\fR
.RS 0
.RS 4
.P
بررسی این‌که آیا هش گذرواژهٔ داده‌شده (\fIhash\fR) با یک گذرواژهٔ متنی سادهٔ داده‌شده مطابقت دارد یا خیر. اگر هش گذرواژه حاوی یک یا چند علامت دلار (\fB$\fR) است، باید آن را درون نقل‌قول تکی قرار دهید. گذرواژهٔ متنی ساده را می‌توان با استفاده از گزینهٔ \fB-p\fR منتقل کرد. در صورتی که گذرواژه‌ای مشخص نشده باشد، doveadm(1) به‌صورت تعاملی آن را درخواست خواهد کرد.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser\fR
.RS 0
.RS 4
.P
هنگامی که از طرح‌وارهٔ \fBDIGEST-MD5\fR استفاده می‌شود، نام کاربری (\fIuser\fR) نیز باید مشخص گردد؛ چرا که نام کاربری بخشی از هش تولیدشده است. برای اطلاعات بیشتر دربارهٔ Digest-MD5 لطفاً auth_digest_md5 را نیز بخوانید. برای سایر طرح‌واره‌ها، این مورد الزامی نیست.
.RE 0

.RE 0

.P
\fB-V\fR
.RS 0
.RS 4
.P
هنگامی که این گزینه مشخص شود، گذرواژهٔ هش‌شده به‌صورت داخلی اعتبارسنجی خواهد شد. نتیجهٔ اعتبارسنجی پس از گذرواژهٔ هش‌شده و در پرانتز نمایش داده می‌شود.
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
یک هش ARGON2ID (بالاترین امنیت در زمان نگارش این راهنما، هرچند ممکن است روی یک کارساز شلوغ سنگین باشد):
.P
.RS 2
.nf
# doveadm pw -s ARGON2ID
Enter new password:
Retype new password:
{ARGON2ID}$argon2id$v=19$m=65536,t=3,p=1$AOrrkaFmGxCFtX+NCSHFkg$N3rlzYFqyNkCwrOingnDJ/qDQ09yGHgQa8PQfbu7rIE
.fi
.RE
.P
یا به عنوان جایگزین، یک هش SHA512-CRYPT:
.P
.RS 2
.nf
# doveadm pw -s SHA512-CRYPT
Enter new password:
Retype new password:
{SHA512-CRYPT}$6$qAvxfQ2UbA1QTXSg$SB2aMEK76DBObt.KqTjF5.yDMceaD3dkG2UvrKQD0rZ9PKii/VAn.VS0nBsDqJX18kXieMi8AWJr0f7Ae9dAp/
.fi
.RE
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش باگ‌ها، از جمله خروجی \fIdoveconf -n\fR را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات دربارهٔ نحوهٔ گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)