DOVEADM(1)                          Dovecot                         DOVEADM(1)

نام (NAME)
       doveadm - ابزار مدیریت Dovecot

خلاصه دستور (SYNOPSIS)
       doveadm [-DOkv] [-i instance-name] [-c config-file] [-o key=value [ ..
       ]] [-f formatter] command [command_options] [command_arguments]

توضیحات (DESCRIPTION)
       دستور doveadm ابزار مدیریت Dovecot است. از این ابزار می‌توان برای مدیریت
       بخش‌های گوناگون Dovecot و همچنین دسترسی به صندوق‌های پستی کاربران استفاده
       کرد.

       جهت مشاهدهٔ فهرست کاربرد دستورات، دستور doveadm help را اجرا کنید.

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

       -D

           حالت پرگویی (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 را در خط اختصاصی خود چاپ کرده و رکوردها را با
           نویسهٔ form feed (^L) جدا می‌کند.


       tab

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


       table

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



       این دستورها مستقیماً با فرایند اصلی (master process) مربوط به Dovecot
       کار می‌کنند.

   doveadm reload
       اجبار dovecot(1) به بارگذاری مجدد پیکربندی.

   doveadm stop
       متوقف کردن dovecot(1) و تمام فرایندهای فرزند آن.

دستورهای تکمیلی فرایند اصلی (ADDITIONAL MASTER COMMANDS)
   doveadm config
       doveconf(1)، برون‌ریزی پیکربندی Dovecot.

   doveadm exec
       doveadm-exec(1)، اجرای آسان دستورها از libexec_dir مربوط به Dovecot.

   doveadm instance
       doveadm-instance(1)، مدیریت فهرست نمونه‌های در حال اجرای Dovecot.

   doveadm kick
       doveadm-kick(1)، قطع اتصال کاربران بر اساس نام کاربری و/یا نشانی IP.

   doveadm log
       doveadm-log(1)، مکان‌یابی، آزمایش یا بازگشایی مجدد فایل‌های گزارش (log)
       مربوط به Dovecot.

   doveadm penalty
       doveadm-penalty(1)، نمایش جریمه‌های جاری.

   doveadm proxy
       doveadm-proxy(1)، مدیریت اتصالات پروکسی Dovecot.

   doveadm who
       doveadm-who(1)، نمایش کاربرانی که به کارساز Dovecot وارد شده‌اند.

دستورهای احراز هویت (AUTHENTICATION COMMANDS)
   doveadm auth
       doveadm-auth(1)، آزمایش احراز هویت برای یک کاربر.

   doveadm pw
       doveadm-pw(1)، تولیدکننده درهم‌ساز (hash) گذرواژه Dovecot.

   doveadm user
       doveadm-user(1)، جستجوی اطلاعات کاربر در userdbهای Dovecot.

دستورهای صندوق پستی (MAILBOX COMMANDS)
   doveadm acl
       doveadm-acl(1)، مدیریت فهرست کنترل دسترسی (ACL).

   doveadm altmove
       doveadm-altmove(1)، انتقال رایانامه‌های منطبق به فضای ذخیره‌سازی جایگزین.

   doveadm backup
       doveadm-sync(1)، ابزار همگام‌سازی یک‌طرفه صندوق پستی Dovecot.

   doveadm copy
       doveadm-move(1)، رونوشت/انتقال پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده
       به یک صندوق پستی دیگر.

   doveadm deduplicate
       doveadm-deduplicate(1)، حذف دائمی (expunge) پیام‌های تکراری.

   doveadm dump
       doveadm-dump(1)، برون‌ریزی محتوای نمایه/گزارش باینری صندوق پستی Dovecot.

   doveadm expunge
       doveadm-expunge(1)، حذف دائمی پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده.

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

   doveadm flags
       doveadm-flags(1)، افزودن، حذف یا جایگزینی پرچم‌های پیام‌ها.

   doveadm force-resync
       doveadm-force-resync(1)، ترمیم صندوق‌های پستی خراب، در صورتی که Dovecot
       این کار را به‌طور خودکار انجام ندهد.

   doveadm fs
       doveadm-fs(1)، تعامل با سامانه فایل انتزاعی ذخیره‌سازی رایانامه.

   doveadm fts
       doveadm-fts(1)، دستکاری و بازسازی نمایه جستجوی تمام‌متن (FTS).

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

   doveadm index
       doveadm-index(1)، نمایه‌سازی پیام‌ها در یک صندوق پستی مشخص.

   doveadm mail fs
       doveadm-mail-fs(1)، تعامل با سامانه فایل انتزاعی ذخیره‌سازی رایانامه در
       بستر کاربر.

   doveadm mailbox
       doveadm-mailbox(1)، دستورهای گوناگون مربوط به مدیریت صندوق‌های پستی.

   doveadm mailbox cryptokey
       doveadm-mailbox-cryptokey(1)، مدیریت افزونه رمزنگاری رایانامه (mail
       crypt plugin).

   doveadm move
       doveadm-move(1)، انتقال پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده به یک
       صندوق پستی دیگر.

   doveadm purge
       doveadm-purge(1)، پاکسازی پیام‌های دارای refcount=0 از فایل‌های mdbox.

   doveadm quota
       doveadm-quota(1)، مقداردهی اولیه/محاسبه مجدد یا نمایش میزان سهمیه مصرفی
       فعلی.

   doveadm rebuild
       doveadm-rebuild(1)، بازسازی فراداده‌های نمایه از روی داده‌های پیام.

   doveadm save
       doveadm-save(1)، ذخیره رایانامه در صندوق‌های پستی کاربران.

   doveadm search
       doveadm-search(1)، نمایش فهرستی از GUIDهای صندوق پستی و UIDهای پیام
       منطبق با پرس‌وجوی جستجوی داده‌شده.

   doveadm stats
       doveadm-stats(1)، بررسی یا بازنشانی آمارها.

   doveadm sync
       doveadm-sync(1)، ابزار همگام‌سازی دوطرفه صندوق پستی Dovecot..SH "وضعیت
       خروج (EXIT STATUS)"

       doveadm با یکی از مقادیر زیر پایان می‌یابد:

       0

           دستور انتخاب‌شده با موفقیت اجرا شد.



       64

           خطا در نحوه استفاده از خط فرمان.



       65

           خطای قالب داده یا امکان‌پذیر نبودن عملیات.



       67

           کاربر وجود ندارد.



       68

           فایل ورودی، نشانی یا منبع دیگر وجود ندارد.



       73

           امکان ایجاد فایل خروجی وجود ندارد.



       75

           یک خطای موقت رخ داد، گزارش‌ها را بررسی کنید.



       76

           خطای پروتکل هنگام اتصال به میزبان راه دور.



       77

           خطای مجوز دسترسی.



       78

           خطای پیکربندی.



       127

           خطای ناشناخته.



محیط (ENVIRONMENT)
       USER

           این متغیر محیطی برای تعیین user به کار می‌رود، در صورتی که دستوری یک
           user بپذیرد ولی مقداری برای آن مشخص نشده باشد.


       /etc/dovecot/dovecot.conf

           فایل پیکربندی اصلی Dovecot.



       /etc/dovecot/conf.d/10-mail.conf

           مکان‌های صندوق پستی و فضاهای نام.



       /etc/dovecot/conf.d/90-plugin.conf

           تنظیمات اختصاصی افزونه‌ها.



گزارش باگ‌ها (REPORTING BUGS)
       باگ‌ها را، به همراه خروجی doveconf -n، به فهرست پستی Dovecot به نشانی
       ⟨dovecot@dovecot.org⟩ گزارش دهید. اطلاعات مربوط به گزارش باگ‌ها در این
       نشانی در دسترس است: ⟨https://dovecot.org/bugreport.html⟩

همچنین ببینید (SEE ALSO)
       doveadm-help(1)

e5ac02a                            May 2026                         DOVEADM(1)