AERC-IMAP(5) File Formats Manual AERC-IMAP(5)

aerc-imap - پیکربندی IMAP برای aerc(1)

برنامه aerc پروتکل IMAP را مطابق مشخصات RFC 3501 پیاده‌سازی می‌کند، همراه با افزونه‌های IMAP زیر:

  • IDLE (RFC 2177)
  • LIST-STATUS (RFC 5819)
  • X-GM-EXT-1 (Gmail)

پیکربندی پایه‌ای IMAP می‌تواند به صورت تعاملی با دستور :new-account انجام شود.

در فایل accounts.conf (به aerc-accounts(5) مراجعه فرمایید)، گزینه‌های اختصاصی IMAP زیر در دسترس هستند:

source = <scheme>://<username>[:<password>]@<hostname>[:<port>]?[<oauth2_params>]

توجه داشته باشید که تمام فیلدها باید کدگذاری URL (به صورت URL-encoded) باشند. نماد @ در صورت کدگذاری URL به %40 تبدیل می‌شود.

مقادیر ممکن برای <scheme> عبارتند از:

imap

پروتکل IMAP به همراه STARTTLS

imap+insecure

پروتکل IMAP بدون STARTTLS

imaps

پروتکل IMAP با TLS/SSL

imaps+insecure

پروتکل IMAP با TLS/SSL، بدون بررسی صحت گواهی (certificate)

imaps+oauthbearer

پروتکل IMAP با TLS/SSL و استفاده از احراز هویت OAUTHBEARER

<oauth2_params>:

در صورت تعیین این بخش و ارائه token_endpoint، گذرواژه پیکربندی‌شده به عنوان یک توکن نوسازی (refresh token) برای دریافت توکن دسترسی (access token) به کار می‌رود. اگر token_endpoint حذف شود، تبادل توکن نوسازی نادیده گرفته می‌شود و گذرواژه در عوض مانند یک توکن دسترسی عمل می‌کند.

  • token_endpoint (اختیاری)
  • client_id (اختیاری)
  • client_secret (اختیاری)
  • scope (اختیاری)

مثال:

imaps+oauthbearer://...?&token_endpoint=https://...&client_id=

imaps+xoauth2

پروتکل IMAP با TLS/SSL با استفاده از احراز هویت XOAUTH2. پارامترها مشابه OAUTHBEARER هستند.

source-cred-cmd = <command>

دستوری را مشخص می‌کند که برای دریافت گذرواژه حساب IMAP اجرا می‌شود. این دستور با استفاده از sh -c command اجرا خواهد شد. اگر گذرواژه‌ای در گزینه source تعیین شده باشد، آن گذرواژه بر این دستور اولویت خواهد داشت.

مثال:

source-cred-cmd = pass hostname/username

connection-timeout = <duration>

حداکثر زمان تاخیر برای برقراری اتصال به سرور IMAP. نشانی زیر را ببینید: https://pkg.go.dev/time#ParseDuration

پیش‌فرض: 90s

keepalive-period = <duration>

فاصله زمانی بین آخرین بسته داده ارسال‌شده (پیام‌های ساده ACK داده محسوب نمی‌شوند) و نخستین پروب keepalive. پس از آن‌که اتصال به عنوان نیازمند keepalive علامت‌گذاری شد، این شمارنده دیگر استفاده نمی‌شود. نشانی زیر را ببینید: https://pkg.go.dev/time#ParseDuration

به‌طور پیش‌فرض، تنظیمات سوکت TCP سیستم استفاده می‌شود.

keepalive-probes = <int>

تعداد پروب‌های بدون پاسخ پیش از قطع فرض کردن اتصال و اطلاع‌رسانی به لایه برنامه.

به‌طور پیش‌فرض، از تنظیمات سوکت TCP سیستم استفاده می‌شود. اگر keepalive-period مشخص شده باشد، این گزینه به‌طور پیش‌فرض به ۳ پروب تنظیم می‌شود.

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

keepalive-interval = <duration>

فاصله زمانی بین پروب‌های آزمایشی بعدی keepalive، بدون در نظر گرفتن این‌که اتصال در این بین چه مواردی را تبادل کرده است. کسرهای ثانیه کوتاه (حذف) می‌شوند.

به‌طور پیش‌فرض، تنظیمات سوکت TCP سیستم استفاده می‌شود. اگر keepalive-period مشخص شده باشد، این گزینه به‌طور پیش‌فرض به 3s تنظیم می‌شود.

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

check-mail-include = <folder1,folder2,folder3...>

فهرستی از پوشه‌ها که با کاما از هم جدا شده‌اند را برای بررسی نامه‌های جدید توسط دستور :check-mail مشخص می‌کند. نام‌هایی که با پیشوند ~ مشخص شده باشند به صورت عبارات باقاعده (regular expressions) تفسیر می‌شوند. اگر سرور IMAP شما از دستور LIST-STATUS پشتیبانی کند، این تنظیم نادیده گرفته می‌شود که در این حالت تمام پوشه‌ها بررسی خواهند شد.

به‌طور پیش‌فرض، تمام پوشه‌ها گنجانده شده‌اند.

check-mail-exclude = <folder1,folder2,folder3...>

فهرستی از پوشه‌ها که با کاما از هم جدا شده‌اند را برای استثنا کردن از بررسی نامه‌های جدید توسط دستور :check-mail مشخص می‌کند. نام‌هایی که با پیشوند ~ مشخص شده باشند به صورت عبارات باقاعده (regular expressions) تفسیر می‌شوند. اگر سرور IMAP شما از دستور LIST-STATUS پشتیبانی کند، این تنظیم نادیده گرفته می‌شود که در این حالت تمام پوشه‌ها بررسی خواهند شد. توجه داشته باشید که این گزینه بر هر تنظیمی از check-mail-include اولویت دارد.

به‌طور پیش‌فرض، هیچ پوشه‌ای مستثنی نشده است.

cache-headers = true|false

در صورت تنظیم بر روی true، سرآیندها کش خواهند شد. سرآیندهای کش‌شده در $XDG_CACHE_HOME/aerc ذخیره می‌شوند، که به‌طور پیش‌فرض ~/.cache/aerc است.

پیش‌فرض: false

cache-max-age = <duration>

حداکثر طول عمر فایل‌های کش‌شده را مشخص می‌کند. نکته: بزرگ‌ترین واحد زمانی که می‌توان برای cache-max-age تعیین کرد بر حسب ساعت است. برای غیرفعال کردن پاکسازی کش، مقدار را بر روی 0 تنظیم کنید.

پیش‌فرض: 720h (۳۰ روز)

idle-timeout = <duration>

مدت زمانی که کلاینت منتظر می‌ماند تا سرور پیش از بسته شدن وضعیت IDLE، هرگونه به‌روزرسانی نهایی را ارسال کند.

پیش‌فرض: 10s

idle-debounce = <duration>

مدت زمان پس از آخرین دستور کلاینت تا زمانی که بیکارکننده (idler) شروع به کار کند را مشخص می‌کند.

پیش‌فرض: 10ms

expunge-policy = auto|low-to-high|stable

سیاست حذف استفاده‌شده در زمان پاکسازی هم‌زمان چند پیام را مشخص می‌کند. مقدار auto تلاش می‌کند تا آن را به‌طور خودکار شناسایی کند، و در بیشتر مواقع درست خواهد بود. مقدار low-to-high مشخص می‌کند که سرور پیام‌ها را با ترتیب صعودی شماره توالی حذف می‌کند (این کاری است که GMail یا FastMail انجام می‌دهند و به درستی توسط شناسایی خودکار مدیریت می‌شود). مقدار stable مشخص می‌کند که سرور شماره‌های توالی دریافتی را تغییر نمی‌دهد (این کاری است که Dovecot یا WorkMail انجام می‌دهند و به صورت قابل اطمینان به طور خودکار شناسایی نمی‌شود ).

پیش‌فرض: auto

aerc(1) aerc-accounts(5)

در ابتدا توسط Drew DeVault ایجاد شد و توسط Robin Jarry با همراهی سایر مشارکت‌کنندگان متن‌باز نگهداری می‌شود. برای اطلاعات بیشتر درباره توسعه aerc، نشانی زیر را ببینید: https://sr.ht/~rjarry/aerc

2025-08-29