📧 تثبيت Mailpit — أداة اختبار البريد الإلكتروني SMTP

انشر Mailpit على Ubuntu بـ Docker والتقط كل رسالة بريد صادرة من تطبيقاتك في صندوق وارد ويب سريع — لا تغادر أي رسالة سيرفرك أبداً.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — Mailpit جاهز بأمر واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/email/mailpit/mailpit-ubuntu.sh
chmod +x mailpit-ubuntu.sh
sudo bash mailpit-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/email/mailpit/mailpit-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x mailpit-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم، يسحب صورة Mailpit، ويُشغّل الحاوية مع تخزين دائم للرسائل الملتقطة.

sudo bash mailpit-ubuntu.sh

4 الدخول إلى واجهة الويب

افتح المتصفح على صندوق وارد Mailpit، ثم وجّه إعدادات SMTP في تطبيقك إلى السيرفر على المنفذ 1025:

http://:8025
# Point your app SMTP at :1025 — messages are captured, never sent

المنافذ المستخدمة

المنفذالغرض
1025SMTP catcher (point your app here)
8025Web inbox + REST API

نظرة عامة

Mailpit أداة مجانية ومفتوحة المصدر لاختبار البريد الإلكتروني وSMTP موجهة للمطورين. تُشغّل سيرفر SMTP وهمي يلتقط كل رسالة يرسلها تطبيقك ويعرضها في واجهة ويب حديثة وسريعة بدلاً من تسليمها لصناديق بريد حقيقية. مكتوبة بلغة Go كملف تنفيذي واحد بدون أي اعتماديات خارجية، وهي الخليفة النشطة الصيانة لمشروع MailHog الذي توقف تطويره، وتضيف فوق نفس الفكرة الأساسية REST API ووسم الرسائل وأتمتة صديقة لبيئات CI.

لماذا تستخدمه

أثناء التطوير والاختبار، لا تريد أن يرسل تطبيقك بريداً عن طريق الخطأ إلى عملاء حقيقيين ببيانات تجريبية، ولا تريد إعداد مزود بريد حقيقي فقط للتحقق من أن رسالة إعادة تعيين كلمة المرور تُعرض بشكل صحيح. يحل Mailpit هذه المشكلة باعتراض كل رسالة على منفذ SMTP محلي ومنحك صندوق وارد لفحصها — عرض HTML، نص عادي، ترويسات خام، ومرفقات. يبدأ في ثوانٍ، يستهلك ذاكرة ضئيلة جداً، ولا يحتاج حساباً خارجياً أو اتصالاً بالإنترنت، ما يجعله مثالياً لبيئات التطوير المحلية وخطوط CI وسيرفرات التجربة التي يجب ألا يصلها بريد حقيقي أبداً.

متى تحتاجه

  • تطبيقك يرسل بريداً معاملاتياً (تأكيد تسجيل، إعادة تعيين كلمة مرور، فواتير) وتحتاج التحقق منه أثناء التطوير دون إزعاج صناديق بريد حقيقية
  • تبني خط CI/CD وتحتاج نقطة SMTP تلتقط البريد لتأكيدات آلية بدلاً من تسليمه فعلياً
  • تريد معاينة كيفية عرض قوالب البريد HTML قبل وصولها للإنتاج
  • تحتاج اختبار كود تكامل SMTP (المهلات، المصادقة، TLS) دون الاعتماد على مزود بريد خارجي
  • تشارك بيئة تجريبية مع فريق ويجب ضمان أن بيانات الاختبار لا تصل أبداً لصندوق بريد عميل حقيقي

من يحتاجه

  • مطورو الخلفية الذين يبنون أو يصلحون تدفقات البريد المعاملاتي
  • مهندسو ضبط الجودة الذين يكتبون اختبارات آلية تتحقق من محتوى البريد
  • مهندسو DevOps الذين يحتاجون وجهة SMTP آمنة لبيئات التجربة وCI
  • المستقلون والوكالات الذين يختبرون قوالب بريد العملاء قبل الإطلاق
  • الطلاب والمستضيفون الذاتيون الذين يتعلمون كيفية عمل SMTP وتسليم البريد

حالات الاستخدام الشائعة

  • التقاط ومعاينة رسائل إعادة تعيين كلمة المرور والترحيب وتأكيد الطلبات أثناء التطوير المحلي
  • الاستخدام كمُرحّل SMTP في خطوط CI للتحقق من أن الاختبارات الآلية استقبلت البريد المتوقع
  • معاينة قوالب بريد HTML المتجاوبة عبر تبويبات HTML/Text/Source قبل إرسالها فعلياً
  • تصحيح مشكلات إعداد عميل SMTP (المصادقة، STARTTLS، المنافذ) على هدف محلي آمن
  • البحث والتصفية بين آلاف الرسائل التجريبية الملتقطة حسب المرسل أو المستلم أو الموضوع أو الوسم
  • ترحيل رسائل مختارة اختيارياً إلى سيرفر SMTP حقيقي للتحقق من التسليم الفعلي

الميزات الرئيسية

  • ملف تنفيذي واحد مستقل بلغة Go بدون اعتماديات خارجية — يبدأ فوراً ويستهلك ذاكرة قليلة جداً
  • واجهة ويب حديثة مع تحديثات فورية عبر WebSockets — الرسائل الجديدة تظهر لحظة استقبالها
  • فحص كامل للرسالة: HTML معروض، نص عادي، مصدر خام، ترويسات، ومرفقات MIME مع صور مصغرة
  • REST API وواجهة سطر أوامر مدمجة للأتمتة وتأكيدات اختبارات CI
  • وسم الرسائل وبحث/تصفية قوي عبر كامل صندوق الوارد الملتقط
  • مصادقة SMTP اختيارية وSTARTTLS/TLS ومُرحّل قابل للإعداد لإعادة توجيه رسائل حقيقية
  • وضع اختبار فوضوي لمحاكاة أخطاء SMTP وسلوك سيرفر غير مستقر
  • نقطة نهاية مقاييس Prometheus ودعم webhooks للتكامل مع خطوط المراقبة والأتمتة

كيفية الاستخدام بعد التثبيت

  • افتح واجهة الويب على http://your-server-ip:8025 — صندوق الوارد فارغ حتى يرسل تطبيقك أول رسالة
  • وجّه إعدادات SMTP في تطبيقك إلى your-server-ip:1025 دون الحاجة لمصادقة افتراضياً
  • أرسل رسالة تجريبية من تطبيقك وتأكد من ظهورها فوراً في صندوق وارد Mailpit
  • استخدم تبويبات HTML وText وSource وHeaders لفحص الرسالة الملتقطة بالكامل
  • فعّل قواعد الوسم تحت Settings إذا أردت تصنيف الرسائل تلقائياً حسب المرسل أو الموضوع
  • استخدم REST API (/api/v1/messages) في مجموعة اختباراتك للتحقق من استقبال الرسائل المتوقعة
  • اضبط مُرحّلاً تحت Settings إذا احتجت أحياناً لإعادة توجيه رسالة تجريبية محددة لعنوان حقيقي

أفضل ممارسات الأمان

  • لا يملك Mailpit مصادقة افتراضياً — لا تكشفه أبداً مباشرة للإنترنت العام
  • ضعه خلف وكيل عكسي مع مصادقة HTTP الأساسية أو قيّد الوصول على شبكتك الداخلية/VPN فقط
  • إذا استُخدم في بيئة تجريبية مشتركة، فعّل خيارات مصادقة واجهة الويب المدمجة لمنع الزملاء من قراءة بيانات اختبار بعضهم
  • لا تفعّل مُرحّل SMTP حقيقي إلا إذا كنت تثق تماماً بمن يملك وصولاً لنسخة Mailpit — مُرحّل مُعد بشكل خاطئ قد يُستخدم لإرسال بريد حقيقي
  • حافظ على تحديث صورة Docker لتلقي إصلاحات الأمان
  • قيّد منفذ SMTP (1025) على الشبكات الداخلية الموثوقة — يجب ألا يستقبل بريداً من مضيفين عشوائيين على الإنترنت

المنافذ وإعدادات جدار الحماية

يكشف Mailpit منفذين: 1025 لسيرفر SMTP الذي تتصل به تطبيقاتك لإرسال البريد، و8025 لواجهة الويب وREST API المستخدمة لعرض الرسائل الملتقطة. لا يملك أي من المنفذين مصادقة مفعّلة افتراضياً، لذا يجب أن يبقيا على شبكة خاصة/داخلية أو خلف وكيل عكسي مع تحكم بالوصول. إذا احتجت وصولاً محلياً فقط، أبقِ كلا المنفذين مغلقين على الجدار الناري الخارجي واتصل عبر نفق SSH أو VPN. عند كشف واجهة الويب لبيئة فريق مشتركة، ضعها خلف Nginx Proxy Manager مع HTTPS ومصادقة HTTP الأساسية.

النسخ الاحتياطي والصيانة

  • يخزّن Mailpit الرسائل الملتقطة في ملف قاعدة بيانات SQLite داخل دليل بياناته — انسخه احتياطياً إذا احتجت الاحتفاظ برسائل اختبار سابقة
  • انسخ ملف docker-compose.yml احتياطياً حتى يمكن إعادة إنشاء الحاوية بنفس الإعدادات على مضيف جديد
  • بما أن Mailpit يحمل فقط بيانات اختبار قابلة للتخلص، معظم الإعدادات لا تحتاج نسخاً احتياطياً للرسائل — اضبط بدلاً من ذلك تقليماً تلقائياً للرسائل
  • استخدم متغير البيئة MP_MAX_MESSAGES لتحديد عدد الرسائل المحتفظ بها تلقائياً، مما يمنع نمو قاعدة البيانات بلا حدود
  • وثّق إعدادات مُرحّل SMTP والمصادقة إن كانت مُفعّلة، لأنها غير مخزنة في أي مكان آخر

الأخطاء الشائعة

  • كشف المنفذ 8025 أو 1025 مباشرة للإنترنت دون مصادقة أو وكيل عكسي
  • نسيان أن Mailpit لا يُسلّم بريداً حقيقياً أبداً — توجيه إعدادات SMTP الخاصة بالإنتاج إلى Mailpit عن طريق الخطأ يبتلع بريد العملاء الحقيقي بصمت
  • عدم ضبط MP_MAX_MESSAGES، ما يترك قاعدة بيانات SQLite تنمو بلا حدود على سيرفر CI مزدحم
  • افتراض أن Mailpit يحتاج بيانات اعتماد SMTP — افتراضياً يقبل اتصالات دون مصادقة، وهذا مقصود للاختبار المحلي
  • تشغيل Mailpit دون حجم تخزين دائم، ما يفقد كل الرسائل الملتقطة عند إعادة تشغيل الحاوية
  • الخلط بين Mailpit ومُرحّل بريد حقيقي — لن يُسلّم البريد لوجهته إلا إذا أُعد مُرحّل صراحة

استكشاف الأخطاء وإصلاحها

  • الرسائل لا تظهر في صندوق الوارد — تحقق أن مضيف/منفذ SMTP في تطبيقك يطابقان IP السيرفر والمنفذ 1025، وراجع سجلات الحاوية بحثاً عن أخطاء اتصال
  • واجهة الويب لا تُحمّل — تأكد أن الحاوية تعمل وأن المنفذ 8025 غير محظور بالجدار الناري
  • الرسائل تختفي بعد إعادة تشغيل الحاوية — تحقق من أن حجم البيانات مُركّب بشكل صحيح في docker-compose.yml
  • لا يمكن الاتصال من حاوية أخرى على نفس شبكة Docker — استخدم اسم خدمة حاوية Mailpit كمضيف SMTP بدلاً من localhost
  • أخطاء مصادقة من تطبيقك — يقبل Mailpit اتصالات SMTP دون مصادقة افتراضياً؛ عطّل المصادقة في عميل البريد بتطبيقك أو اضبط MP_SMTP_AUTH ليطابق
  • استدعاءات REST API تفشل في CI — تأكد أن عامل CI يستطيع الوصول للمنفذ 8025 وراجع مسار نقطة نهاية API بحثاً عن أخطاء إملائية

البدائل

MailHog هو سلف Mailpit وملهمه — كان رائداً في نمط سيرفر SMTP الوهمي مع واجهة ويب لكنه بلا صيانة منذ سنوات ويفتقر لـ REST API والوسم والاختبار الفوضوي التي يوفرها Mailpit. MailDev أداة مشابهة أخف مبنية على Node.js بواجهة أبسط وميزات اختبار أقل. Mailtrap بديل مستضاف (SaaS) شهير بخطة مجانية سخية، لكنه يرسل رسائل اختبارك لخدمة سحابية تابعة لجهة خارجية بدلاً من إبقائها بالكامل على بنيتك التحتية الخاصة. smtp4dev خيار مفتوح المصدر مماثل بلغة .NET يُستخدم غالباً في بيئات تطوير قائمة على Windows. للفرق التي تريد خياراً ذاتي الاستضافة سريعاً وبدون اعتماديات مع كود نشط الصيانة وAPI صديق لـCI، يبقى Mailpit الخيار الأقوى.

متى لا تستخدمه

Mailpit أداة اختبار فقط — ليس سيرفر بريد ولن يُسلّم رسائل لمستلمين حقيقيين أبداً ما لم تُعد مُرحّلاً صراحة، لذا لا تستخدمه كمزود SMTP إنتاجي. إذا كان فريقك يعتمد بالفعل على خدمة اختبار مستضافة مثل Mailtrap ولا يريد استضافة ذاتية أو صيانة بنية تحتية، فقد يكون خيار SaaS أبسط. إذا احتجت تسليم بريد إنتاجي فعلي (معاملاتي أو تسويقي)، فانظر إلى سيرفر بريد حقيقي مثل Docker Mailserver أو Mailu، أو خدمة تسليم بريد، وليس Mailpit.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

هل يرسل Mailpit رسائل بريد فعلياً؟

لا. يعترض Mailpit كل رسالة تُرسل إلى منفذ SMTP الخاص به ويخزنها محلياً لتعرضها — لا تُسلَّم أي رسالة لصندوق بريد حقيقي إلا إذا أعددت صراحة مُرحّل SMTP لإعادة توجيه رسائل محددة.

هل Mailpit بديل لـ MailHog؟

نعم. صُمم Mailpit كبديل حديث ونشط الصيانة لـ MailHog، الذي لم يشهد تحديثات جوهرية منذ سنوات. يحافظ Mailpit على نفس فكرة سيرفر SMTP الوهمي مع واجهة ويب، مع إضافة REST API ووسم واختبار فوضوي وتطبيق أسرع وأخف بلغة Go.

هل أحتاج ضبط مصادقة لإرسال بريد إلى Mailpit؟

لا، افتراضياً يقبل Mailpit اتصالات SMTP دون مصادقة على المنفذ 1025، وهذا مقصود للاختبار المحلي السريع. يمكنك تفعيل مصادقة SMTP عبر متغيرات البيئة إذا أردت اختبار معالجة تطبيقك للمصادقة تحديداً.

هل يمكن استخدام Mailpit في خط CI/CD؟

نعم. شغّل Mailpit كحاوية خدمة في مهمة CI الخاصة بك، ووجّه إعدادات SMTP في تطبيقك إليها، واستخدم REST API (/api/v1/messages) للتحقق من التقاط الرسائل المتوقعة بالموضوع والمستلمين الصحيحين.

هل يمكن لـ Mailpit إعادة توجيه الرسائل الملتقطة لعنوان حقيقي؟

نعم. يدعم Mailpit إعداد مُرحّل SMTP اختياري يتيح لك إعادة توجيه رسالة ملتقطة محددة إلى سيرفر بريد حقيقي، وهو مفيد للتحقق سريعاً من كيفية عرض البريد فعلياً في عميل صندوق وارد حقيقي.