Mailpit: خادم SMTP للاختبار على VPS الخاص بك

لماذا الانتقال من MailHog إلى Mailpit

ما يقدمه Mailpit عمليًا

• واجهة حديثة مع البحث في النص الكامل، وعرض HTML/نص، ومعاينة الهاتف المحمول، وفحص الرؤوس
• ملف تنفيذي ‏Go منفرد مُجمَّع بشكل ثابت — لا تبعيات للنظام، يعمل في حاوية بحجم 20 ميغابايت
• استهلاك الذاكرة أقل من 50 ميغابايت في وضع الخمول، مستقر حتى مع آلاف الرسائل في الجلسة
• ‏REST API متوافقة مع MailHog (‏/api/v1/messages، /api/v1/search) للنصوص البرمجية الحالية
• دعم ‏SMTP المُصادق عليه، و‏TLS اختياري، والتحكم في الوصول عبر الشبكة
• ‏Webhook قابل للتكوين لإبلاغ نقطة نهاية خارجية عند كل استقبال بريد إلكتروني

المتطلبات الأساسية

نشر Mailpit في 5 خطوات

1. 01

   إنشاء الدليل وملف Compose

   mkdir -p /opt/mailpit && cd /opt/mailpit

   أنشئ ملف docker-compose‎.yml التالي:

   services:
     mailpit:
       image: axllent/mailpit:latest
       container_name: mailpit
       restart: unless-stopped
       ports:
         - "127.0.0.1:1025:1025"
         - "127.0.0.1:8025:8025"
       environment:
         MP_MAX_MESSAGES: 500
         MP_SMTP_AUTH_ACCEPT_ANY: "true"
         MP_SMTP_AUTH_ALLOW_INSECURE: "true"
         MP_UI_AUTH: "admin:changeme"
       volumes:
         - mailpit_data:/data
   volumes:
     mailpit_data:

   المنافذ مرتبطة بـ 127.0.0.1 فقط: لا يُكشف ‏Mailpit مباشرة على ‏IP العام. المتغير MP_UI_AUTH يفعّل مصادقة ‏HTTP الأساسية على واجهة الويب — غيّر كلمة المرور. MP_MAX_MESSAGES يحد من عدد الرسائل المحفوظة في الذاكرة لكل جلسة.

2. 02

   تشغيل الحاوية

   docker compose up -d
   docker compose logs -f mailpit

   السطر starting on [::]:1025 يؤكد أن خادم ‏SMTP يستمع. تحقق من ربط المنافذ بـ ‏localhost:

   ss -tlnp | grep -E '1025|8025'

   المتوقع: 127.0.0.1:1025 و127.0.0.1:8025 فقط — ليس 0.0.0.0 أبدًا.

3. 03

   تكوين الوكيل العكسي Nginx

   أنشئ /etc/nginx/sites-available/mailpit:

   server {
       listen 443 ssl;
       server_name mail.your-domain.com;
   
       ssl_certificate     /etc/letsencrypt/live/mail.your-domain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/mail.your-domain.com/privkey.pem;
   
       location / {
           proxy_pass         http://127.0.0.1:8025;
           proxy_http_version 1.1;
           proxy_set_header   Upgrade $http_upgrade;
           proxy_set_header   Connection "upgrade";
           proxy_set_header   Host $host;
           proxy_read_timeout 86400;
       }
   }

   proxy_read_timeout 86400 ضروري لاتصالات ‏WebSocket المستخدمة من قبل الواجهة الفورية. فعّل ‏vhost وأعد تحميل ‏Nginx:

   ln -s /etc/nginx/sites-available/mailpit /etc/nginx/sites-enabled/
   nginx -t && systemctl reload nginx

   aحصل على شهادة ‏Let's Encrypt إذا لم يكن ذلك مكتملًا:

   certbot --nginx -d mail.your-domain.com

4. 04

   اختبار الإرسال باستخدام curl

   تحقق من استقبال خادم ‏SMTP للرسالة:

   curl --url 'smtp://127.0.0.1:1025' \
     --mail-from '[email protected]' \
     --mail-rcpt '[email protected]' \
     --upload-file - <<EOF
   From: [email protected]
   To: [email protected]
   Subject: Mailpit Test
   
   Test message body.
   EOF

   افتح بعد ذلك https://mail‎.your-domain‎.com في متصفحك. يجب أن تظهر الرسالة في الواجهة. إذا قمت بتكوين MP_UI_AUTH، أدخل بيانات الاعتماد عند مطالبة المصادقة الأساسية.

5. 05

   تكوين تطبيقك للإشارة إلى Mailpit

   في ملف .env (‏Laravel، ‏Symfony، ‏n8n، ‏Django…)، استبدل تكوين ‏SMTP بـ:

   MAIL_HOST=127.0.0.1
   MAIL_PORT=1025
   MAIL_ENCRYPTION=null
   MAIL_USERNAME=null
   MAIL_PASSWORD=null

   للتطبيقات التي تعمل في ‏Docker على المضيف نفسه، استخدم اسم شبكة ‏Docker أو ‏IP للبوابة (172.17.0.1 افتراضيًا) بدلاً من 127.0.0.1.

Mailpit في CI/CD: اختبار البريد الإلكتروني في خط الأنابيب

تكامل CI/CD حسب إطار العمل

1. 06

   GitHub Actions — خدمة Mailpit

   services:
     mailpit:
       image: axllent/mailpit:latest
       ports:
         - 1025:1025
         - 8025:8025

   في متغيرات بيئة مهمتك، عيّن MAIL_HOST=127.0.0.1 وMAIL_PORT=1025. يقبل ‏Mailpit أي بريد إلكتروني بدون مصادقة افتراضيًا — لا حاجة لتكوين ‏SMTP إضافي.

2. 07

   Laravel — PHPUnit

   في phpunit.xml، استبدل وسيلة النقل بـ ‏SMTP:

   <env name="MAIL_MAILER" value="smtp"/>
   <env name="MAIL_HOST" value="127.0.0.1"/>
   <env name="MAIL_PORT" value="1025"/>

   في اختبارك، أرسل البريد ثم استعلم ‏API ‏Mailpit للتحقق من الاستقبال:

   $response = Http::get('http://127.0.0.1:8025/api/v1/messages');
   $this->assertSame($response->json('total'), 1);
   $this->assertStringContainsString(
       'Welcome',
       $response->json('messages.0.Subject')
   );

3. 08

   Django — pytest

   في settings.py (أو settings_test.py):

   EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
   EMAIL_HOST = '127.0.0.1'
   EMAIL_PORT = 1025

   في اختبار ‏pytest الخاص بك، تحقق عبر ‏API ‏Mailpit:

   import requests
   
   def test_welcome_email_sent():
       r = requests.get('http://127.0.0.1:8025/api/v1/messages')
       assert r.json()['total'] == 1
       assert 'Welcome' in r.json()['messages'][0]['Subject']

4. 09

   n8n — اختبار سير العمل

   في عقدة Send Email في ‏n8n، قم بتكوين خادم ‏SMTP على 127.0.0.1:1025 بدون مصادقة. للتحقق تلقائيًا من أن سير العمل قد أطلق إرسالاً، استدع GET http://127.0.0.1:8025/api/v1/messages من عقدة ‏HTTP Request وتحقق من الإجمالي في عقدة ‏IF.

تأمين الوصول إلى Mailpit

استكشاف الأخطاء — 4 حالات شائعة

Mailpit مقابل MailHog وMailtrap وInbucket وsmtp4dev

مرّر الجدول أفقيًا

حالات الاستخدام المتقدمة