دليل إعداد خدمة Mailpit في ServBay

يقدم ServBay حزمة Mailpit، التي توفر خادم بريد إلكتروني محلي سهل الاستخدام، مصمم خصيصًا لمطوري التطبيقات لاختبار وظائف إرسال البريد وتصحيحها. يشرح هذا الدليل بالتفصيل كيفية تثبيت وتفعيل وضبط إعدادات حزمة Mailpit في ServBay، بما في ذلك علامات الإعداد الأربعة الرئيسية: الإعدادات العامة (Common)، وسيرفر SMTP، وسيرفر POP3، وإعادة التوجيه (Relay).

نظرة عامة على حزمة Mailpit

Mailpit أداة مفتوحة المصدر توفر خادم SMTP/POP3 محلي وواجهة ويب تفاعلية سهلة الاستخدام. تلتقط هذه الأداة كل رسائل البريد الإلكتروني التي ترسلها تطبيقاتك، بحيث يمكنك مراجعة محتوى الرسائل، رؤوسها، والمرفقات، في مكان واحد، دون أن تذهب الرسائل التجريبية لصندوق بريد حقيقي. هذا يبسط عملية التطوير والتصحيح بشكل كبير، خاصة عند التعامل مع ميزات إرسال الرسائل كالتسجيل، إعادة تعيين كلمة المرور، والتنبيهات.

تم دمج Mailpit كحزمة أساسية في ServBay، ويمكنك تثبيتها وإدارتها بسهولة والاستفادة من نظام PKI القوي في ServBay الذي يقوم تلقائيًا بإعداد شهادات SSL/TLS، ما يضمن بيئة اختبار آمنة.

تثبيت وتفعيل حزمة Mailpit

قبل استخدام Mailpit كخادم بريد إلكتروني محلي، يجب أولاً تثبيته وتفعيله ضمن ServBay.

1. افتح تطبيق ServBay.
2. من شريط التنقل الجانبي، اختر "الحزم".
3. في قائمة الحزم، ابحث عن قسم "الخدمات العامة".
4. اعثر على حزمة "Mailpit".
5. إذا لم تكن Mailpit مُثبتة، انقر على زر التثبيت الأخضر المجاور لها.
6. بعد الانتهاء من التثبيت، فعّل الحزمة من خلال زر التبديل المجاور.

بفضل نظام PKI المتقدم في ServBay، سيتم تلقائيًا إنشاء وإعداد شهادات SSL المطلوبة لواجهة الإدارة على الويب وكذلك لخدمات SMTP و POP3. هذا يعني أنه يمكنك تفعيل تشفير STARTTLS أو SSL/TLS مباشرة دون الحاجة إلى إعداد الشهادات يدويًا.

واجهة إدارة البريد عبر الويب

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

عنوان الدخول: https://mail.servbay.host

عبر هذه الواجهة، يمكنك بسهولة تصفح قائمة الرسائل الواردة، عرض تفاصيل الرسائل (بما في ذلك HTML، نص عادي، الشيفرة المصدرية)، البحث وحذف البريد، وغير ذلك.

ضبط إعدادات حزمة Mailpit

يوفر ServBay واجهة رسومية لتخصيص كل إعدادات Mailpit. من شريط التنقل الجانبي، اختر "البريد"، ثم انقر على "إعداد خدمة Mailpit" للدخول إلى صفحة الإعدادات. ستجد أربعة علامات رئيسية: Common (الإعدادات العامة)، SMTP، POP3، وRelay (إعادة التوجيه).

1. علامة Common (الإعدادات العامة)

تُستخدم علامة Common لضبط سلوك وإعدادات Mailpit العامة:

• أقصى عدد للرسائل (Max Messages): يحدد الحد الأقصى لعدد الرسائل التي يمكن أن يحتفظ بها سيرفر Mailpit. عند تجاوز الحد، يتم حذف أقدم الرسائل تلقائيًا.
• أقصى مدة احتفاظ (Max Age): يحدد أطول مدة (بالأيام) يتم الاحتفاظ خلالها بالرسائل على السيرفر. بعد انقضاء المدة تحذف الرسائل تلقائيًا.
• مرشح الرسائل المزعجة SpamAssassin: تفعيل أو تعطيل فلترة الرسائل غير المرغوبة. في حال التفعيل، سيضع Mailpit علامة على الرسائل المشبوهة.
• رابط Webhook: يمكنك تحديد رابط Webhook ليتم إرسال إشعار HTTP POST عند استقبال بريد جديد، ما يفيد في تكامل الاختبارات التلقائية أو أنظمة التنبيهات.
• حد إشعارات Webhook: يحدد الحد الأقصى لعدد رسائل البريد التي يتم إرسال إشعار Webhook عنها.

2. علامة SMTP

TIP

بفضل نظام PKI المتقدم في ServBay، تم توليد وإعداد شهادات SSL بشكل افتراضي. يمكنك تفعيل تشفير STARTTLS أو SSL/TLS مباشرة دون الحاجة لأي إعداد يدوي إضافي.

تخصّص علامة SMTP لضبط إعدادات سيرفر البريد الصادر (SMTP) في Mailpit، بحيث تصل تطبيقاتك بهذا السيرفر عند إجراء اختبارات إرسال البريد:

• منفذ SMTP (SMTP Port): حدد رقم منفذ الاستماع لسيرفر SMTP في Mailpit. يجب على تطبيقك إرسال الرسائل إلى هذا المنفذ في العنوان 127.0.0.1 أو localhost. الافتراضي هو 1025.
• STARTTLS: تفعيل أو تعطيل تشفير STARTTLS لترقية الاتصال إلى آمن بعد إنشائه.
• SSL/TLS: تفعيل أو تعطيل استخدام التشفير الفوري عند إنشاء الاتصال.
• اسم المستخدم (Username): الخيار متاح لوضع اسم مستخدم لسيرفر SMTP (اختياري). في حال التفعيل، سيحتاج تطبيقك للتوثيق عند إرسال الرسائل.
• كلمة المرور (Password): استخدم مع اسم المستخدم لتفعيل التوثيق.
• أقصى عدد للمستلمين (Max Recipients): تحديد أقصى عدد لعناوين المستلمين في الرسالة الواحدة لتفادي إرسال كميات كبيرة دفعة واحدة.
• المستلمون المسموحون (Allowed Recipients): قائمة بالعناوين أو النطاقات المسموحة بالإرسال إليها (اختياري). اتركه فارغًا لقبول جميع العناوين، أو ضع قيدًا حسب الحاجة.

3. علامة POP3

TIP

بفضل نظام PKI المتقدم في ServBay، تم توليد وإعداد شهادات SSL بشكل افتراضي. يمكنك تفعيل الاتصال المشفر SSL/TLS مباشرة دون الحاجة لأي إعداد يدوي إضافي.

تُستخدم علامة POP3 لضبط إعدادات استقبال البريد (POP3). إذا أردت اختبار استقبال رسائل البريد في تطبيقك، وفّر له إعدادات الاتصال بهذا السيرفر:

• تفعيل سيرفر POP3 (Enable POP3 Server): لتشغيل أو تعطيل وظيفة POP3 في Mailpit.
• منفذ سيرفر POP3 (POP3 Server Port): تحديد رقم المنفذ الذي سيستمع عليه السيرفر، الافتراضي 1110.
• اسم المستخدم (Username): (اختياري) لتفعيل التوثيق عند الاتصال.
• كلمة المرور (Password): استخدم مع اسم المستخدم لتفعيل التوثيق.
• SSL/TLS: تفعيل أو تعطيل تشفير الاتصال.

4. علامة Relay (إعادة التوجيه)

تتيح علامة Relay لك إعداد إعادة توجيه (ترحيل) الرسائل المُلتقطة إلى خادم SMTP خارجي حقيقي:

• تفعيل إعادة توجيه SMTP (Enable SMTP Relay): لتشغيل أو تعطيل وظيفة الترحيل.
• المضيف (Host): عنوان خادم SMTP خارجي لتوجيه الرسائل إليه (مثال: smtp.gmail.com, smtp.sendgrid.net).
• المنفذ (Port): رقم منفذ SMTP المستخدم في الترحيل. القيم الافتراضية: 25 (SMTP قياسي)، 465 (SMTPS)، 587 (Submission).
• STARTTLS: تفعيل أو تعطيل تشفير الاتصال مع خادم الترحيل.
• السماح بغير الآمن (Allow Insecure): السماح بالاتصال بخوادم SMTP غير موثوقة الشهادة (غير مستحسن للإنتاج).
• آلية التوثيق (Auth): طريقة توثيق الاتصال مع السيرفر (مثل: Login - اسم المستخدم/كلمة المرور، Plain، CRAM-MD5).
• اسم المستخدم (Username): اسم المستخدم للاتصال بخادم الترحيل.
• كلمة المرور (Password): كلمة المرور للاتصال بخادم الترحيل.
• مسار الرجوع (Return Path): تحديد عنوان البريد المستخدم في رأس Return-Path للرسائل المُرحلة.
• المستلمون المسموحون (Allowed Recipients): قائمة بالعناوين أو النطاقات المسموح لها بالترحيل (اختياري).
• المستلمون المحظورون (Blocked Recipients): قائمة بالعناوين أو النطاقات المحظور عنها الترحيل (اختياري).
• ترحيل جميع الرسائل (Relay All): في حال التفعيل، سيقوم Mailpit بترحيل كل الرسائل المُلتقطة (مع التقيد بإعدادات السماح/الحظر).
• ترحيل المتطابقة فقط (Relay Matching): عند التفعيل، يقتصر الترحيل على الرسائل التي تطابق قواعد Allowed/Blocked Recipients فقط.

حفظ الإعدادات

بعد تعديل أي من إعدادات Mailpit، تأكد من النقر على زر "حفظ" في أسفل الشاشة لتثبيت التغييرات.

لإعادة الإعدادات الافتراضية، يمكنك النقر على زر "إعادة تعيين" ليعود Mailpit لما كان عليه عند التثبيت.

الأسئلة الشائعة (FAQ)

• س: لماذا لا تظهر رسائل البريد التي يرسلها تطبيقي في Mailpit؟
  • ج: تحقق من ضبط إعدادات البريد في تطبيقك (عادة خادم SMTP والمنفذ)، تأكد أنها تشير إلى عنوان Mailpit في ServBay (127.0.0.1 أو localhost) والمنفذ المستخدم في إعدادات Mailpit (الافتراضي 1025). تأكد أيضًا من أن الحزمة مفعلة وقيد العمل، ويمكن مراجعة ذلك من قائمة الحزم في ServBay.
• س: هل أحتاج لإعداد شهادة SSL خاصة لـ Mailpit؟
  • ج: لا تحتاج لذلك. بفضل نظام PKI، يقوم ServBay تلقائيًا بإعداد شهادة SSL/TSL لواجهة الويب وخدمات SMTP/POP3 الخاصة بـ Mailpit. فقط فعّل الخيارات المشفرة حسب حاجتك.
• س: ما هي بيانات الدخول الافتراضية لواجهة إدارة Mailpit على الويب؟
  • ج: بشكل افتراضي، لا تتطلب واجهة ويب Mailpit عند الدخول من https://mail.servbay.host اسم مستخدم أو كلمة مرور. كما أن خدمتي SMTP وPOP3 لا تتطلبان التوثيق افتراضيًا. إذا رغبت بفرض التوثيق، يمكنك تعيين اسم مستخدم وكلمة مرور من إعدادات الخدمة.

ملخص

مع دمج حزمة Mailpit داخل ServBay، يمكنك إعداد بيئة متكاملة لاختبار البريد الإلكتروني بسهولة تامة. من خلال ضبط إعدادات SMTP وPOP3 وRelay، وبالاعتماد على واجهتها الرسومية سهلة الاستخدام، ستحقق مرونة وكفاءة عالية في تطوير واختبار ميزات البريد الإلكترونية ضمن مشاريعك البرمجية.

انتبه: قد يتطلب تفعيل التغيرات التي أجريتها على الإعدادات إعادة تشغيل حزمة Mailpit. يمكنك القيام بذلك من واجهة إدارة الحزم في ServBay عبر النقر على زر إعادة التشغيل الخاص بـ Mailpit.