مستندات مدیر سیستم

این راهنما نحوه مدیریت سهمیه (Quota) کاربران و مشاهده آمار سرور را با استفاده از دستورات maddy برای سرور Madmail / chatmail توضیح می‌دهد.

مخاطب: مدیران سیستم و اپراتورهای نود دلتاچت.

💡 نکته: تمام این عملیات‌ها از طریق رابط وب مدیریت در مسیر /admin/ نیز قابل انجام هستند — بدون نیاز به خط فرمان.

مدیریت سهمیه (Quota)

شما می‌توانید سهمیه فضای ذخیره‌سازی کاربران را با استفاده از زیر-دستورات maddy imap-acct quota مدیریت کنید.

مشایع سهمیه کاربر

نمایش میزان فضای مصرف شده و سقف مجاز برای یک کاربر خاص.

maddy imap-acct quota get username@example.com

تنظیم سهمیه کاربر

تنظیم یک سقف فضای اختصاصی برای یک کاربر (مثلاً 1GB، 500MB یا 10KB).

maddy imap-acct quota set username@example.com 1GB

بازنشانی سهمیه کاربر

حذف سقف اختصاصی کاربر و بازگرداندن آن به مقدار پیش‌فرض سیستم. با این کار تاریخ ایجاد حساب کاربر حفظ می‌شود.

maddy imap-acct quota reset username@example.com

تنظیم سهمیه پیش‌فرض کل سیستم

تنظیم سقف فضای ذخیره‌سازی برای تمام کاربرانی که سهمیه اختصاصی ندارند. این مقدار در دیتابیس ذخیره شده و بر تنظیمات فایل maddy.conf اولویت دارد.

maddy imap-acct quota set-default 2GB

لیست تمام سهمیه‌ها

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

maddy imap-acct quota list

نگهداری و پاکسازی

دستوراتی برای مدیریت بار سرور و آزادسازی فضا با حذف داده‌های کاربران.

پاکسازی صف ارسال (Queue)

حذف تمام پیام‌های در حال انتظار در صف ارسال که مربوط به یک کاربر خاص (فرستنده یا گیرنده) هستند. این دستور برای رفع گرفتگی صف ناشی از اسپم یا پیام‌های حجیم مفید است.

maddy queue purge username@example.com

پاکسازی پیام‌های IMAP برای یک کاربر

حذف تمام ایمیل‌های یک کاربر از تمام صندوق‌های پستی (Inbox، Sent و غیره) بدون حذف شدن خود حساب کاربری یا تنظیمات سهمیه او. این کار برای آزاد کردن سریع فضای هارد سرور کاربرد دارد.

maddy imap-acct purge-msgs username@example.com

پاکسازی تمام پیام‌های تمام کاربران (Purge All)

حذف تمام ایمیل‌های موجود در کل سرور برای تمام کاربران. این دستور تمام داده‌های ایمیل را پاک می‌کند اما حساب‌های کاربری، رمز عبورها و سهمیه‌ها دست‌نخورده باقی می‌مانند.

maddy imap-acct purge-all

حذف تمام پیام‌های خوانده شده (Purge Read)

حذف تمام ایمیل‌هایی که در کل سرور توسط کاربران خوانده شده‌اند (Seen). ایمیل‌های جدید و خوانده نشده حفظ می‌شوند. این کار به بهینه‌سازی فضا بدون از دست دادن پیام‌های جدید کمک می‌کند.

maddy imap-acct purge-read [--yes]

حذف پیام‌های خوانده نشده قدیمی (Prune Unread)

حذف پیام‌های خوانده نشده‌ای که بیش از زمان مشخص شده (مثلاً ۳۰ روز) از تاریخ دریافت آن‌ها گذشته است. این دستور برای پاکسازی ایمیل‌های قدیمی که کاربر هرگز آن‌ها را باز نکرده مفید است.

maddy imap-acct prune-unread 720h [--yes]

مدیریت ثبت‌نام (Registration)

شما می‌توانید ثبت‌نام کاربران جدید را باز یا بسته کنید. در صورت بسته بودن، فقط کاربرانی که از قبل اکانت دارند می‌توانند لاگین کنند.

باز کردن ثبت‌نام

maddy creds registration open

بستن ثبت‌نام

maddy creds registration close

مشاهده وضعیت فعلی

maddy creds registration status

مدیریت ثبت‌نام آنی (JIT Registration)

ثبت‌نام آنی (Just-In-Time) قابلیتی است که به سرور اجازه می‌دهد در اولین تلاش کاربر برای لاگین، به صورت خودکار حساب کاربری او را بسازد. شما می‌توانید این قابلیت را مستقل از باز یا بسته بودن کل ثبت‌نام مدیریت کنید.

فعال کردن ثبت‌نام آنی

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

maddy creds jit enable

غیرفعال کردن ثبت‌نام آنی

با غیرفعال کردن این گزینه، حساب‌ها فقط از طریق API (رابط وب) ساخته می‌شوند و لاگین با مشخصات ثبت‌نشده رد می‌شود.

maddy creds jit disable

مشاهده وضعیت JIT

maddy creds jit status

مدیریت سرور تماس (TURN/STUN)

شما می‌توانید سرور تماس (TURN) را برای تمام کاربران فعال یا غیرفعال کنید. در صورت غیرفعال بودن، اطلاعات مربوط به تماس در صفحه راهنما نمایش داده نمی‌شود.

روشن کردن سرور تماس

maddy creds turn on

خاموش کردن سرور تماس

maddy creds turn off

مشاهده وضعیت فعلی

maddy creds turn status

مدیریت لاگ (سیاست بدون لاگ)

شما می‌توانید ثبت لاگ سرور را فعال یا غیرفعال کنید. در حالت غیرفعال، هیچ اطلاعاتی در مورد فعالیت‌های کاربران ثبت نمی‌شود.

غیرفعال کردن لاگ

برای رعایت حریم خصوصی کاربران و جلوگیری از ذخیره اطلاعات فعالیت.

maddy creds log disable

فعال کردن لاگ

maddy creds log enable

مشاهده وضعیت فعلی

maddy creds log status

زبان وب‌سایت

شما می‌توانید زبان رابط وب را تغییر دهید. زبان‌های پشتیبانی‌شده: انگلیسی (en)، فارسی (fa)، روسی (ru)، اسپانیایی (es). تغییرات بلافاصله اعمال می‌شوند و نیازی به ریستارت نیست.

مشاهده زبان فعلی

maddy language

تغییر زبان

تغییر زبان وب‌سایت به زبان دیگر.

maddy language set fa

بازنشانی به پیش‌فرض

حذف تنظیم دیتابیس و بازگشت به زبان تعریف‌شده در maddy.conf.

maddy language reset

تنظیمات پورت‌ها و پیکربندی

پورت‌ها و تنظیمات سرویس‌ها (مانند hostname، secret، relay IP و غیره) از طریق Admin API قابل مدیریت هستند. این تنظیمات در دیتابیس ذخیره شده و بر مقادیر فایل پیکربندی اولویت دارند.

لیست تنظیمات قابل مدیریت

پورت‌ها: SMTP، Submission، IMAP، TURN، Dovecot، Iroh، Shadowsocks
پیکربندی: SMTP hostname، TURN realm/secret/relay IP/TTL، Iroh relay URL، Shadowsocks cipher/password

برای مدیریت این تنظیمات از Admin API استفاده کنید. مسیرهای مربوطه در بخش «تنظیمات پورت‌ها» و «تنظیمات پیکربندی» مستندات API توضیح داده شده‌اند.

حالت مخفی (Stealth Mode)

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

پورت‌های ضروری:

پورت 80 و 443 (HTTP/HTTPS): برای ثبت‌نام و رابط وب.
پورت 8388 (Shadowsocks): برای اتصال امن و سریع کاربران از داخل اپلیکیشن DeltaChat.

سایر پورت‌ها (مثل 25, 143, 587, 993) را می‌توانید از طریق فایروال برای دسترسی عمومی ببندید. کاربران با استفاده از پروکسی Shadowsocks که در داخل اپلیکیشن تنظیم می‌کنند، به تمام خدمات دسترسی خواهند داشت و سرور شما از دید اسکنرهای اینترنتی مخفی می‌ماند.

غیرفعال کردن Admin API

رابط مدیریت (Admin API) به صورت پیش‌فرض فعال است. چنانچه می‌خواهید برای افزایش امنیت این قابلیت را به طور کامل از طریق فایل پیکربندی غیرفعال کنید، می‌توانید گزینه زیر را در فایل maddy.conf در بخش chatmail مقداردهی کنید.

تنظیم فایل maddy.conf

مقدار admin_token را برابر disabled قرار دهید:

chatmail tls://0.0.0.0:443 {
    # ... سایر تنظیمات ...

    # Disable the admin API entirely:
    admin_token disabled
}
            

پس از ذخیره فایل، سرویس maddy را ریستارت کنید. با این کار تمامی امکانات پنل مدیریت وب و Admin API استاپ خواهند شد.

کش DNS و بازنویسی آدرس

سیستم کش DNS داخلی به شما اجازه می‌دهد بدون تغییر DNS سیستم‌عامل، مسیر ارسال ایمیل‌های خروجی را به سرور دلخواه هدایت کنید. قوانین بازنویسی در دیتابیس اصلی برنامه (همان دیتابیس ذخیره‌سازی) ذخیره می‌شوند. تغییرات بلافاصله اعمال می‌شوند و نیازی به ریستارت سرور نیست.

مشاهده تمام بازنویسی‌ها

نمایش لیست تمام قوانین بازنویسی DNS که در دیتابیس ذخیره شده‌اند.

maddy dns-cache list

ایجاد یا ویرایش بازنویسی

تنظیم یک قانون بازنویسی DNS. اگر قبلاً برای این آدرس قانونی وجود داشته باشد، به‌روزرسانی می‌شود.

maddy dns-cache set LOOKUP_KEY TARGET_HOST [COMMENT]

مثال‌ها:

                # هدایت ایمیل‌های دامنه به سرور داخلی
                maddy dns-cache set nine.testrun.org 10.0.0.5 "Route to staging"

                # بازنویسی آدرس IP
                maddy dns-cache set 1.1.1.1 2.2.2.2 "Redirect IP"

                # هدایت به سرور جدید هنگام مهاجرت
                maddy dns-cache set example.com new-mx.example.com "Migration"
            

مشاهده یک بازنویسی خاص

نمایش جزئیات یک قانون بازنویسی DNS شامل آدرس مبدأ، مقصد، توضیحات و زمان ایجاد.

maddy dns-cache get nine.testrun.org

حذف یک بازنویسی

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

maddy dns-cache remove nine.testrun.org

نحوه کارکرد

اولویت: ابتدا دیتابیس داخلی بررسی می‌شود. اگر قانونی یافت نشد، DNS سیستم‌عامل استفاده می‌شود.
بدون حساسیت به حروف: آدرس‌ها بدون توجه به بزرگ یا کوچک بودن حروف مطابقت داده می‌شوند.
پشتیبانی از IP و دامنه: هم دامنه (مانند example.com) و هم آدرس IP (مانند 1.1.1.1) قابل بازنویسی هستند.
بدون نیاز به ریستارت: تغییرات بلافاصله روی ایمیل‌های جدید اعمال می‌شوند.
بازگشت خودکار: اگر دیتابیس در دسترس نباشد، سیستم به صورت خودکار به DNS عادی بازمی‌گردد.

آمار سرور

مشاهده آمار کلی

نمایش مجموع فضای ذخیره‌سازی مصرف شده در سرور و تعداد کل حساب‌های کاربری فعال.

maddy imap-acct stat

مانیتورینگ اتصالات آنلاین

دستور maddy status وضعیت لحظه‌ای سرور را نشان می‌دهد. این شامل اتصالات فعال IMAP، رله‌های TURN (تماس صوتی/تصویری)، Shadowsocks، تعداد کاربران ثبت‌شده و زمان آپتایم می‌شود.

مشاهده اتصالات فعال

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

maddy status

خروجی نمونه:

IMAP            connections: 27     unique IPs: 7
TURN            relays: 1
Shadowsocks     connections: 0      unique IPs: 0

Registered users:   42
Boot time:          2026-02-16 20:56:19 (up 5m 24s)

Email servers seen (since last restart):
  Connection IPs:   1
  Domain servers:   1
  IP servers:       0

مشاهده جزئیات به تفکیک پورت

با استفاده از فلگ --details (یا -d) می‌توانید جزئیات اتصالات را به تفکیک هر پورت ببینید.

maddy status --details

خروجی نمونه:

PORT   PROTO   TYPE              CONNECTIONS   UNIQUE IPs
993    tcp     IMAP TLS          25            7
143    tcp     IMAP              0             0
3478   udp     TURN UDP          1 relays      -
3478   tcp     TURN TCP          0             0
8388   tcp     Shadowsocks       0             0
443    tcp     ALPN (chatmail)   3             1

توضیحات فیلدها

IMAP: تعداد اتصالات فعال کاربران به سرور ایمیل (دریافت پیام).
TURN relays: تعداد رله‌های فعال تماس صوتی/تصویری. هر رله یک تماس فعال را نشان می‌دهد.
Shadowsocks: تعداد اتصالات فعال از طریق پروکسی Shadowsocks.
Boot time: زمان راه‌اندازی سرور و مدت زمان آپتایم.
Email servers seen: تعداد سرورهای ایمیل یکتایی که از زمان آخرین ریستارت پیام ارسال کرده‌اند. این اطلاعات با هش رمزنگاری‌شده ذخیره می‌شوند و هیچ اطلاعات خصوصی قابل بازیابی نیست.