صفحة الإدارة

mailctl ui، صفحة إدارة محلية للقراءة فقط من أجل plan وaudit.

.md

يشغّل mailctl ui صفحة إدارة محلية. تعرض ما سيبلّغ به plan وaudit، دون طرفية. إنه الملف التنفيذي نفسه، يقرأ الإعداد نفسه وبيانات الاعتماد نفسها، فلا تختلف الصفحة وسطر الأوامر أبدًا.

لوحة التحكم بالسمة الفاتحة: بطاقة الخطوة التالية وبطاقات الملخص وجدول صحة النطاقات

التشغيل

$ mailctl ui
mailctl ui on http://127.0.0.1:54217/ — this machine only; Ctrl-C to stop

تفتح الصفحة في متصفحك. إنها عملية في الواجهة بلا خدمة خلفية، ويوقفها Ctrl-C.

-addr

العنوان الذي يُستمع عليه. الافتراضي 127.0.0.1:0، فتختار النواة منفذًا حرًا. لا تتصادم نسختان أبدًا، ولا يمكن إيجاد المنفذ بمسح منفذ ثابت. ويُرفض أي عنوان غير الاسترجاع المحلي.

-data

مجلد سجل النشاط. الافتراضي $XDG_DATA_HOME/mailctl، أو ~/.local/share/mailctl حين لا يكون مضبوطًا.

-no-browser

اطبع العنوان دون فتح متصفح.

-config

ملف الإعداد، ويُعثر عليه بالطريقة نفسها كما في كل أمر آخر.

للقراءة فقط في التصميم

لا تغيّر الصفحة أي شيء لدى أي مزوّد أبدًا. الخطة والتدقيق زرّان: كل منهما يشغّل الفحص الحي نفسه الذي يشغّله الأمر، وفقط حين تضغطه. ولا تستهلك الصفحة من تلقاء نفسها أي استدعاء لمزوّد ولا أي حصة من حدود المعدّل. قائمة النطاقات وما يصرّح به الإعداد لكل نطاق لا يكلّفان أي استدعاء، فيظهران فورًا.

لا يوجد زر تطبيق ولا نقطة نهاية تطبّق أي شيء. تنتهي صفحة الخطة بأمر mailctl apply لتنسخه إلى الطرفية. وذلك الأمر يخطّط من جديد ويحتفظ بأسئلة التأكيد وبحاجز -prune.

الصفحات

لوحة التحكم: بطاقة الخطوة التالية تذكر الشيء الوحيد الذي يجب فعله الآن: تشغيل خطة، أو مراجعة تغييراتها، أو تشغيل تدقيق، أو إصلاح نطاق فاشل. وتحتها بطاقات ملخص للنطاقات وصناديق البريد والأسماء البديلة والمزوّدين، وجدول صحة فيه صف لكل نطاق، ورسوم بيانية للتشغيلات الأخيرة وللنطاقات لكل مزوّد، والنشاط الأخير.

يكون النطاق سليمًا بعد أن ينجح تدقيق أو تعود خطة نظيفة. وتكون له تغييرات معلّقة ما دامت لدى الخطة إجراءات له، ويكون فاشلًا عند فحص فاشل أو خطأ.
النطاقات: كل نطاق في الإعداد، في جدول يمكنك البحث فيه وترتيبه. لكل نطاق صفحته بتبويبات لصناديق البريد والأسماء البديلة والالتقاط الشامل، وسياسة قابلية التسليم، وإعدادات المزوّد، وعند الطلب سجلات DNS التي يريد المحرّك نشرها. يعرض جدول صناديق البريد مصدر كل بيانات اعتماد، لا قيمتها أبدًا.
الخطة: الأمر plan نفسه في سطر الأوامر. تعرض المجاميع ورسمًا بيانيًا لتوزيع الإجراءات، وتحذيرًا حين تحذف الخطة أي شيء أو تحتاج إلى خطوة بشرية، والإجراءات مجمّعة بحسب النطاق. لكل صف شارة عملية: CREATE بالأخضر، وUPDATE بالكهرماني، وDELETE بالأحمر، وMANUAL بالبنفسجي.
التدقيق: الأمر audit نفسه في سطر الأوامر. يعرض كل فحص لكل نطاق بشارة نجاح أو فشل، والقيمة التي يريدها الإعداد بجانب القيمة التي حصل عليها المحلّل. النطاق الذي لا يمكن حساب سجلاته المطلوبة يبلّغ عن خطئه الخاص ويترك البقية سليمة.
النشاط: ما فعلته الصفحة، الأحدث أولًا: الخطط والتدقيقات واستعلامات السجلات المطلوبة. تعرض الرسوم البيانية تشغيلات آخر 14 يومًا والتوزيع بحسب النوع. ويمكن تصفية الجدول بحسب النوع والبحث فيه وتصديره بصيغة CSV.
الإعدادات: أي بيانات اعتماد المزوّدين مضبوطة (الوجود فقط، لا القيمة أبدًا)، وأين ملف الإعداد ومجلد البيانات وسجل النشاط.

صفحة نطاق بالسمة الداكنة، بتبويبات لصناديق البريد والأسماء البديلة وقابلية التسليم وسجلات DNS والخطة والتدقيق

اللغات

الصفحة بالإنجليزية أو العربية. اختر اللغة من القائمة في الترويسة. تقلب العربية التخطيط كله من اليمين إلى اليسار. وتبقى أخطاء المزوّدين والعناوين وقيم السجلات في اتجاهها الخاص، فتُقرأ صحيحة داخل النص العربي.

يُحفظ الاختيار في ملف تعريف ارتباط في متصفحك. ويبقى سجل النشاط على القرص بالإنجليزية دائمًا، فيُقرأ بالطريقة نفسها أيًا كان من يفتحه.

صفحة النشاط بالعربية والسمة الداكنة، من اليمين إلى اليسار

السمات والتخطيط

تبدّل قائمة الملف الشخصي بين الفاتح والداكن والتلقائي الذي يتبع نظام التشغيل. ويُطوى الشريط الجانبي إلى أيقونات بـ [، وعلى الهاتف ينزلق من الجانب. وكلا الاختيارين ملفات تعريف ارتباط، فيكون أول رسم للصفحة صحيحًا من البداية.

لوحة المفاتيح

Ctrl K، ⌘K

افتح لوحة الأوامر، ثم اكتب للانتقال إلى أي صفحة أو نطاق.

g ثم h

لوحة التحكم

g ثم d

النطاقات

g ثم p

الخطة

g ثم a

التدقيق

g ثم l

النشاط

g ثم s

الإعدادات

/

ابحث في جدول الصفحة.

[

اطوِ الشريط الجانبي أو افرده.

?

اسرد كل الاختصارات.

Esc

أغلق قائمة أو نافذة حوار أو لوحة الأوامر.

أثناء العمل

قد تستغرق الخطة أو التدقيق عدة ثوانٍ، لأنها تسأل كل مزوّد عن الحالة الحية. وأثناء التشغيل يغطي الصفحة ستار يقول ما يجري، فلا تستطيع ضغطة ثانية بدء تشغيل ثانٍ. وتصل النتيجة كإشعار منبثق. وإن فشل التشغيل، يعرض الإشعار والصفحة الخطأ نفسه الذي سيطبعه سطر الأوامر. ولا يحمل أي خطأ من مزوّد بيانات اعتماد.

العنوان المجهول يعرض صفحة "غير موجود" منسّقة. والخطأ الداخلي يعرض صفحة خطأ منسّقة، لا صفحة مرسومة نصفها أبدًا.

الأمان

ليس للصفحة تسجيل دخول. ما يحميها هو تعذّر الوصول إليها من أجهزة أخرى:

تستمع على واجهة الاسترجاع المحلية فقط، وترفض -addr غير محلي.
ترفض الطلب الذي يذكر مضيفًا غير مضيفها، وهذا يمنع إعادة ربط DNS.
ترفض أي كتابة يبدأها موقع آخر: Origin أجنبي، أو Sec-Fetch-Site: cross-site.
تعمل تحت Content-Security-Policy صارمة لا تسمح إلا بملفاتها. ولا تحمّل خطوط ويب ولا نصوصًا برمجية من أطراف ثالثة.
الملف الوحيد الذي تكتبه هو سجل النشاط.

راجع الأمان لضمانات mailctl ككل.

الصفحة مبنية على toolshell، وهي واجهة إدارة مفتوحة المصدر لتطبيقات Go المعروضة على الخادم.

عدّل هذه الصفحة آخر تحديث 13 أكتوبر 2026