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

aerc-jmap - پیکربندی JMAP برای aerc(1)

برنامه aerc پروتکل JMAP را مطابق مشخصات RFC 8620 و RFC 8621 پیاده‌سازی می‌کند.

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

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

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

به خاطر داشته باشید که تمام فیلدها باید به صورت URL کدگذاری شوند. نماد @ در صورت کدگذاری URL، به صورت %40 خواهد بود.

عبارت <hostname>[:<port>]/<path> منبع نشست JMAP تحت HTTPS است همان‌طور که در بخش ۲ از RFC 8620 و بدون طرح پیشوند https:// مشخص شده است.

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

jmap

پروتکل JMAP بر بستر HTTPS با استفاده از احراز هویت Basic.

jmap+oauthbearer

پروتکل JMAP بر بستر HTTPS با استفاده از احراز هویت OAUTHBEARER

نام کاربری نادیده گرفته می‌شود و ممکن است خالی رها شود. در صورت تعیین گذرواژه، مطمئن شوید که پیشوند : را قبل از آن قرار می‌دهید تا به صراحت مشخص شود که نام کاربری خالی است. یا نام کاربری را بر روی هر مقدار دلخواهی تنظیم کنید. به عنوان مثال:

source = jmap+oauthbearer://:s3cr3t@example.com/jmap/session
source = jmap+oauthbearer://me:s3cr3t@example.com/jmap/session

اعتبارنامه‌های منبع شما باید دارای قابلیت urn:ietf:params:jmap:mail باشند.

source-cred-cmd = <command>

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

مثال:

source-cred-cmd = pass hostname/username

outgoing = jmap://

اتصال JMAP همچنین می‌تواند برای ارسال ایمیل‌ها استفاده شود. نیازی به تکرار URL یا هیچ‌گونه اعتبارنامه‌ای نیست. تنها طرح URL کافی خواهد بود.

اعتبارنامه‌های منبع شما باید دارای قابلیت urn:ietf:params:jmap:submission باشند.

cache-state = true|false

کش کردن تمام وضعیت‌های ایمیل (صندوق‌های پستی، سرآیندهای ایمیل، محتویات صندوق پستی، پرچم‌های ایمیل و غیره) بر روی دیسک در یک پایگاه‌داده levelDB واقع در پوشه ~/.cache/aerc/<account>/state.

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

پیش‌فرض: false

cache-blobs = true|false

کش کردن تمام بدنه و پیوست‌های دانلودشده ایمیل بر روی دیسک به عنوان فایل‌های جداگانه در ~/.cache/aerc/<account>/blobs/<xx>/<blob_id> (که در آن <xx> یک زیرپوشه است که بر اساس دو نویسه پایانی <blob_id> نام‌گذاری شده است).

برنامه aerc اشیای داده‌ای (blobs) کش‌شده را به‌طور خودکار پاکسازی نخواهد کرد. حتی زمانی که ایمیل‌های مربوط به آن‌ها به‌طور دائمی از سرور حذف شوند. در صورت نیاز، ممکن است بخواهید یک پاکسازی دوره‌ای بر اساس تاریخ ایجاد فایل در crontab اجرا کنید، به عنوان مثال:

@daily find ~/.cache/aerc/foo/blobs -type f -mtime +30 -delete

پیش‌فرض: false

use-labels = true|false

در صورت تنظیم بر روی true، صندوق‌های پستی با نقش archive (معمولاً Archive) از فهرست دایرکتوری مخفی شده و با یک پوشه مجازی all-mail جایگزین می‌شوند. نام این پوشه را می‌توان از طریق تنظیم all-mail پیکربندی کرد.

دستور :archive flat همچنان می‌تواند برای "برچسب‌گذاری" موثر پیام‌ها با صندوق پستی مخفی Archive استفاده شود تا در پوشه مجازی all-mail نمایش داده شوند. هنگامی که پوشه مجازی all-mail انتخاب شده است، :archive flat نباید استفاده شود و هیچ تاثیری نخواهد داشت. پیام‌ها خاکستری خواهند شد اما تا زمانی که aerc دوباره راه‌اندازی نشود، هرگز بازخوانی نمی‌شوند.

همچنین، این گزینه پشتیبانی از دستور :modify-labels (با نام مستعار :tag) را فعال می‌کند.

پیش‌فرض: false

all-mail = <name>

نام پوشه مجازی که در صورت use-labels = true جایگزین صندوق پستی با نقش role=archive می‌شود.

پیش‌فرض: All mail

server-ping = <duration>

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

نشانی https://pkg.go.dev/time#ParseDuration را ببینید.

پیام‌های JMAP را می‌توان به عنوان "برچسب‌ها" (labels یا tags) در نظر گرفت. هر پیام باید به یک یا چند صندوق پستی (پوشه‌ها در aerc) تعلق داشته باشد. هر صندوق پستی دارای یک "نقش" (role) است همان‌طور که در نشانی https://www.iana.org/assignments/imap-mailbox-name-attributes شرح داده شده است.

هنگام حذف پیام‌هایی که فقط به صندوق پستی انتخاب‌شده تعلق دارند، aerc تلاش خواهد کرد تا این پیام‌ها را به صندوق پستی با نقش trash منتقل کند. اگر نتواند چنین صندوق پستی را پیدا کند یا اگر صندوق پستی انتخاب‌شده همان صندوق پستی trash باشد، پیام‌ها به‌طور قطعی از سرور حذف خواهند شد.

دستور :delete پیام‌ها را از صندوق پستی انتخاب‌شده حذف می‌کند و عملاً همان کار :tag -<selected_folder> را انجام می‌دهد.

دستور :cp <foo> یک نام مستعار برای :tag <foo> یا :tag +<foo> است.

دستور :mv <foo> ترکیبی از :delete و :mv است و می‌توان آن را به عنوان یک نام مستعار برای :tag -<selected_folder> +<foo> در نظر گرفت.

دستور :archive flat یک نام مستعار برای :tag -<selected_folder> +<archive> است.

aerc(1) aerc-accounts(5)

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

2025-08-29