DOVEADM(1) Dovecot DOVEADM(1)

doveadm - ابزار مدیریت Dovecot

doveadm [-DOkv] [-i instance-name] [-c config-file] [-o key=value [ .. ]] [-f formatter] command [command_options] [command_arguments]

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

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

گزینه‌های عمومی 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 کار می‌کنند.

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

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

doveconf(1)، برون‌ریزی پیکربندی Dovecot.

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

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

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

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

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

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

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

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

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

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

doveadm-acl(1)، مدیریت فهرست کنترل دسترسی (ACL).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

0

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

64

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

65

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

67

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

68

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

73

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

75

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

76

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

77

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

78

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

127

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

USER

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

/etc/dovecot/dovecot.conf

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

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

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

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

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

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

doveadm-help(1)

May 2026 e5ac02a