چگونه پلاگین لاگ Dovecot را فعال و غیرفعال کنیم

تعاریف کلیدی مقاله

• Dovecot (داوِکات): یک نرم‌افزار IMAP و POP3 سرور ایمیل متن‌باز است که وظیفه مدیریت دریافت و ذخیره‌سازی ایمیل‌ها را دارد.
• Mail Log Plugin (پلاگین لاگ ایمیل): افزونه‌ای در Dovecot که باعث می‌شود جزئیات بیشتری از رویدادهای ایمیلی (مثل حذف، کپی، تغییر پرچم‌ها و …) در فایل‌های لاگ ذخیره شود.
• /var/log/maillog: مسیر فایل اصلی لاگ ایمیل در لینوکس که فعالیت‌های مربوط به ارسال و دریافت ایمیل در آن ذخیره می‌شود.
• \Deleted flag (پرچم حذف): یک علامت در پروتکل IMAP که به معنای علامت‌گذاری ایمیل برای حذف شدن است (نه حذف نهایی).
• Expunge (پاک‌سازی): عملیات حذف نهایی ایمیل‌هایی که پرچم \Deleted دارند (شامل autoexpunge یعنی پاک‌سازی خودکار).
• SSH (اس‌اِس‌اِچ): پروتکل امن برای اتصال به سرور از راه دور با خط فرمان.
• Template File (فایل قالب): فایلی که پیکربندی Dovecot از روی آن ساخته و اعمال می‌شود.
• Patch (پچ): قطعه کدی که برای تغییر یا به‌روزرسانی بخشی از یک فایل یا نرم‌افزار اعمال می‌شود.
• stat: دستوری در لینوکس برای بررسی وجود و جزئیات یک فایل.
• chown: دستور تغییر مالکیت فایل‌ها و پوشه‌ها در لینوکس.
• tail -fn0 /var/log/maillog: دستور مشاهده لحظه‌ای آخرین لاگ‌های ایمیل.

نمای کلی

این مقاله توضیح می‌دهد که چگونه می‌توانید پلاگین mail log در Dovecot را فعال یا غیرفعال کنید.
ورودی‌های اضافی که در فایل لاگ /var/log/maillog ثبت می‌شوند، می‌توانند به شما برای عیب‌یابی مشکلات تحویل ایمیل کمک کنند.

این پلاگین ورودی‌های زیر را به فایل لاگ اضافه می‌کند:

• تنظیم یا حذف پرچم \Deleted
• عملیات Expunge (پاک‌سازی ایمیل‌ها، شامل autoexpunge)
• کپی کردن ایمیل‌ها به یک صندوق دیگر
• ایجاد صندوق‌های ایمیل (Mailbox creations)
• حذف صندوق‌های ایمیل (Mailbox deletions)
• تغییر نام صندوق‌ها (Mailbox renames)
• هرگونه تغییر در پرچم‌ها (Flag changes)
• عملیات ذخیره‌سازی (Saves)

مهم:

• اضافه شدن این لاگ‌ها باعث می‌شود حجم فایل‌های لاگ بزرگ‌تر شود و سیستم آن‌ها را زودتر آرشیو کند.
• مسیر فایل‌های قالب Dovecot در سیستم اکنون /var/cpanel/templates/dovecot/ است.

فعال‌سازی پلاگین Dovecot mail log

برای فعال کردن پلاگین مراحل زیر را انجام دهید:

• از طریق SSH به عنوان کاربر root وارد سرور شوید.

• بررسی کنید که آیا فایل قالب محلی (local template) وجود دارد یا خیر:

stat /var/cpanel/templates/dovecot/main.default

• اگر فایل وجود نداشت، این دستور را اجرا کنید:

cp -v /var/cpanel/templates/dovecot/main.{default,local}

• فایل /root/dovecot.patch را ایجاد کنید و کد زیر را در آن قرار دهید:

 --- main.default 2022-05-04 18:43:43.231310505 +0000 +++ main.local 2022-08-05 05:00:33.996931597 +0000 @@ -669,7 +669,7 @@ [%- ELSE %] #mail_plugins = acl quota imap_quota [%- END %] - mail_plugins = $mail_plugins zlib imap_zlib quota_clone virtual [% IF xaps_topic %]imap_xaps[% END %] [% IF fts_support %]fts fts_solr[% END %] + mail_plugins = $mail_plugins mail_log notify zlib imap_zlib quota_clone virtual [% IF xaps_topic %]imap_xaps[% END %] [% IF fts_support %]fts fts_solr[% END %] #mail_plugin_dir = /usr/lib/dovecot/imap @@ -1251,10 +1251,10 @@ # mail_log plugin provides more event logging for mail processes. plugin { # Events to log. Also available: flag_change append - #mail_log_events = delete undelete expunge copy mailbox_delete mailbox_rename + mail_log_events = delete undelete expunge copy mailbox_delete mailbox_rename # Available fields: uid, box, msgid, from, subject, size, vsize, flags # size and vsize are available only for expunge and copy events. - #mail_log_fields = uid box msgid size + mail_log_fields = uid box msgid size }

• سپس دستورات زیر را اجرا کنید:

 patch -p1 /var/cpanel/templates/dovecot/main.local < /root/dovecot.patch /scripts/builddovecotconf && /scripts/restartsrv_dovecot

برای مشاهده لاگ‌ها دستور زیر را اجرا کنید:

tail -fn0 /var/log/maillog

غیرفعال‌سازی پلاگین Dovecot mail log

برای غیرفعال کردن پلاگین مراحل زیر را انجام دهید:

• از طریق SSH به عنوان کاربر root وارد سرور شوید.

• دستورات زیر را اجرا کنید:

mv -vi /var/cpanel/templates/dovecot/main.local{,.bak} /scripts/builddovecotconf && /scripts/restartsrv_dovecot

کیان پور