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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

بستن ثبت‌نام

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

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

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

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

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

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

وضعیت کلی و اطلاعات یک کاربر

ساخت ورود + صندوق IMAP

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

حذف یا مسدودسازی

ردیف رمز را حذف می‌کند، محتوای IMAP را پاک می‌کند و آدرس را در لیست مسدودی می‌گذارد. ban می‌تواند دلیل را به‌صورت آرگومان دوم بگیرد.

پس از تغییر CLI هنگام روشن بودن سرور

سرور برای سرعت نسخه‌ای از اعتبارنامه‌ها و سهمیه‌ها را در حافظه نگه می‌دارد. اگر با CLI دیتابیس زنده را عوض کردید، یک بار POST به /admin/cache/reload بزنید (همان توکن admin). جزئیات در مستندات Admin API.

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

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

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

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

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

فعال کردن لاگ

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

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

تغییر زبان

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مثال‌ها:

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

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

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

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

نحوه کارکرد

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

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

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

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

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

خروجی نمونه:

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) می‌توانید جزئیات اتصالات را به تفکیک هر پورت ببینید.

خروجی نمونه:

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: تعداد سرورهای ایمیل یکتایی که از زمان آخرین ریستارت پیام ارسال کرده‌اند. این اطلاعات با هش رمزنگاری‌شده ذخیره می‌شوند و هیچ اطلاعات خصوصی قابل بازیابی نیست.