DOVECOT-LDA(1) Dovecot DOVECOT-LDA(1)

dovecot-lda - عامل محلی تحویل ایمیل Dovecot

dovecot-lda

دستور dovecot-lda یک عامل محلی تحویل ایمیل (Local Mail Delivery Agent) است که ایمیل را از یک MTA دریافت کرده و ضمن به‌روز نگه داشتن فایل‌های نمایه‌سازی Dovecot، آن را به صندوق پستی کاربر تحویل می‌دهد.

ویژگی‌های اصلی dovecot-lda عبارتند از:

  • نمایه‌سازی صندوق پستی هنگام تحویل ایمیل، که باعث دسترسی سریع‌تر به صندوق پستی در آینده می‌شود
  • اعمال سهمیه (quota) توسط افزونهٔ quota
  • پشتیبانی از زبان Sieve توسط افزونهٔ Pigeonhole sieve

گزینه‌های پذیرفته‌شده توسط dovecot-lda:

-a address

نشانی مقصد (مانند user+ext@domain). در صورت مشخص نشدن، پیش‌فرض بر اساس تنظیم lda_original_recipient_header تعیین می‌شود.

-c config_file

مسیر فایل پیکربندی جایگزین.

-d username

نام کاربری (username) مقصد. در صورت ارائه، اطلاعات کاربر از userdb جستجو می‌شود. معمولاً برای کاربران مجازی استفاده می‌شود، اما الزامی برای کاربران سیستمی نیست.

-e

اگر ایمیل رد شود، دلیل رد شدن را در خروجی خطای استاندارد (stderr) می‌نویسد و با وضعیت 77 (EX_NOPERM) خارج می‌شود. پیش‌فرض این است که یک ایمیل برگشتی (bounce email) توسط خود برنامه ارسال شود.

-f envelope_sender

نشانی فرستندهٔ پاکت (envelope sender). اگر مشخص نشود و داده‌های پیام با یک سطر معتبر به سبک mbox یعنی "From " آغاز شود، نشانی از آن گرفته می‌شود.

-k

در هنگام راه‌اندازی، تمام متغیرهای محیطی را پاک نمی‌کند.

-m mailbox

صندوق پستی مقصد (پیش‌فرض INBOX است). اگر صندوق پستی وجود نداشته باشد، ایجاد نخواهد شد (مگر اینکه تنظیم lda_mailbox_autocreate فعال باشد). چنانچه به هر دلیلی ذخیره پیام در mailbox ممکن نباشد، پیام به جای آن به INBOX تحویل داده می‌شود.

  • اگر افزونهٔ Sieve استفاده شود، این صندوق پستی به عنوان صندوق پستی اقدام keep استفاده خواهد شد. همچنین در صورتی که هیچ اسکریپت Sieve وجود نداشته باشد یا اسکریپت به هر دلیلی ناموفق باشد، از آن استفاده می‌شود.
  • تحویل پیام‌ها به پیشوند فضای نام موجب ذخیره شدن ایمیل در INBOX می‌شود. به عنوان مثال، اگر فضای نام Mail/ را دارید، این قابلیت به شما امکان می‌دهد dovecot-lda -m Mail/$mailbox را مشخص کنید که در آن ایمیل در Mail/$mailbox ذخیره می‌شود یا در صورتی که $mailbox خالی باشد، در INBOX ذخیره می‌گردد.
  • نام صندوق پستی همان‌گونه که در کلاینت IMAP قابل مشاهده است مشخص می‌شود. برای مثال اگر یک Maildir با پوشهٔ .box.sub/ دارید و پیکربندی فضای نام شما شامل تنظیمات namespace_prefix و namespace_separator است، روش صحیح برای تحویل ایمیل به آنجا استفاده از -m INBOX/box/sub می‌باشد.

-o setting=value

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

-p path

مسیر ایمیلی که باید تحویل داده شود به‌جای خواندن از stdin. در صورت استفاده از maildir، فایل در صورت امکان به مقصد پیوند سخت (hard link) داده می‌شود. این به یک ایمیل اجازه می‌دهد تا با استفاده از پیوندهای سخت به چندین کاربر تحویل داده شود، اما در حال حاضر مانع به‌روزرسانی فایل کش توسط deliver نیز می‌شود، بنابراین نباید استفاده شود مگر اینکه واقعاً لازم باشد.

-r address

نشانی نهایی گیرندهٔ پاکت (envelope recipient). مقدار پیش‌فرض آن نشانی گزینهٔ -a است، اما اگر برای مثال از نام‌های مستعار استفاده شود یا بخش +detail حذف شود، ممکن است متفاوت باشد.

دستور dovecot-lda با یکی از مقادیر زیر خارج خواهد شد:

0

تحویل با موفقیت انجام شد. (EX_OK)

64

پارامتر نامعتبر داده شده است. (EX_USAGE)

67

کاربر گیرنده ناشناخته است. (EX_NOUSER)

77

گزینهٔ -e استفاده شده و ایمیل رد شد. این مورد معمولاً زمانی رخ می‌دهد که سهمیه کاربر تمام شده باشد و quota_full_tempfail = no پیکربندی شده باشد. (EX_NOPERM)

75

یک شکست موقت رخ داد. این وضعیت تقریباً برای تمام شکست‌ها بازگردانده می‌شود. برای جزئیات به فایل لاگ مراجعه کنید. (EX_TEMPFAIL)

/etc/dovecot/dovecot.conf

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

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

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

/etc/dovecot/conf.d/15-lda.conf

تنظیمات ویژه LDA.

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

تنظیمات ویژه افزونه‌ها (پلاگین‌ها).

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

پیکربندی سهمیه (Quota).

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

doveadm(1)

مستندات مرتبط با MTAهای خاص:

•
پست‌فیکس (Postfix):
•
postconf(5), transport(5), pipe(8)
•
اگسیم (Exim):
May 2026 e5ac02a