DOVEADM-SAVE(1) Dovecot DOVEADM-SAVE(1)

doveadm-save - ذخیره کردن ایمیل در صندوق پستی یک کاربر

doveadm

doveadm

doveadm

doveadm

دستور doveadm save می‌تواند برای ذخیره کردن پیام‌ها استفاده شود. این قابلیت برای اسکریپت‌ها و اشکال‌زدایی مفید است. فیلتر Sieve برای پیام‌های ذخیره‌شده فراخوانی نمی‌شود، اما محدودیت سهمیه (quota) اعمال می‌گردد.

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

-D

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

-O

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

-k

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

-v

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

-i instance-name

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

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

-c config-file

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

-o setting=value

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

-A

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

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

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

-F file

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

--no-userdb-lookup

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

-S socket_path

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

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

-u user/mask

دستور (command) را تنها برای user داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام (wildcards) '*' و '?' وجود دارد (مانند -u *@example.org).

-m mailbox

ایمیل را به جای INBOX در صندوق پستی مشخص‌شده ذخیره می‌کند.

-U uid

در صورت امکان، ایمیل را با استفاده از UID داده‌شده ذخیره می‌کند.

-g guid

ایمیل را با استفاده از GUID داده‌شده ذخیره می‌کند.

-r received-date

ایمیل را با استفاده از برچسب زمان دریافت (received-date) داده‌شده ذخیره می‌کند. این مقدار در قالب «برچسب زمان خوانا برای انسان» (human timestamp) است که در doveadm-search-query(7) شرح داده شده است.

mail-file

داده‌های پیام برای ذخیره‌سازی.

  • اگر mail-file برابر با - باشد، پیام از ورودی استاندارد (stdin) خوانده می‌شود (پیش‌فرض).
  • در غیر این صورت، mail-file به عنوان مسیر یک فایل تفسیر می‌شود.

echo "hello, world" | doveadm save -u testuser@testdomain

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

doveadm(1)

May 2026 e5ac02a