Mailtrain هو تطبيق رسائل إخبارية مجاني ومفتوح المصدر (open-source) ومستضاف ذاتيًا (self-hosted) والذي يدعم خلفيات قاعدة بيانات MySQL / MariaDB.
يتيح لك Mailtrain إضافة المشتركين يدويًا من خلال واجهة برمجة التطبيقات أو الاستيراد من ملف CSV.
يأتي Mailtrain مع مجموعة غنية من الميزات بما في ذلك محرر النماذج والحقول المخصصة و RSS ومحرر HTML وغير ذلك الكثير.
إذا كانت لديك قائمة طويلة من المشتركين وتريد إدارتها بسهولة فإن Mailtrain هو الخيار الأفضل لك.
سنشرح هنا تثبيت تطبيق الرسائل الإخبارية Mailtrain باستخدام Docker على خادم Ubuntu 18.04.
المتطلبات
خادم يعمل بنظام التشغيل Ubuntu 18.04.
اسم مجال (domain name) يشير إلى عنوان IP الخاص بالخادم.
إعداد كلمة مرور الـ root على الخادم الخاص بك.
ستحتاج إلى تحديث نظامك بأحدث إصدار:
apt-get update -y
apt-get upgrade -y
أعد تشغيل النظام لتطبيق التغييرات.
تثبيت Docker و Docker Compose
لا يتوفر أحدث إصدار من Docker في Ubuntu 18.04 افتراضياً لذلك سوف تحتاج إلى إضافة Docker إلى نظامك.
أولاً ، قم بتثبيت الحزم المطلوبة بالأمر التالي:
apt-get install curl git apt-transport-https ca-certificates -y
قم بتنزيل وإضافة مفتاح Docker's PGP بالأمر التالي:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -
أضف Docker CE عن طريق تعديل ملف etc/apt/sources.list/
nano /etc/apt/sources.list
أضف السطر التالي في نهاية الملف:
deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable
احفظ وأغلق الملف.
قم بتحديث المستودع وتثبيت Docker CE بالأوامر التالية:
apt-get update -y
apt-get install docker-ce -y
يمكنك التحقق من حالة خدمة Docker باستخدام الأمر التالي:
systemctl status docker
سترى النتيجة التالية
Docker Application Container Engine
Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
Active: active (running) since Thu 2019-10-24 16:15:25 UTC; 21min ago
Docs: https://docs.docker.com
Main PID: 1402 (dockerd)
Tasks: 45
CGroup: /system.slice/docker.service
?? 1402 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock
??10312 /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 3000 -container-ip 172.18.0.4 -container-port 3000
Oct 24 16:23:04 ubuntu1804 dockerd[1402]: time="2019-10-24T16:23:04.817021656Z" level=info msg="Layer sha256:b875b006eb8ffb0434ce3a26cb04c9017c
Oct 24 16:24:09 ubuntu1804 dockerd[1402]: time="2019-10-24T16:24:09.879265134Z" level=info msg="ignoring event" module=libcontainerd namespace=
Oct 24 16:24:10 ubuntu1804 dockerd[1402]: time="2019-10-24T16:24:10.065610315Z" level=warning msg="20676b10252b4a484e32a7d7534b3b386cc2a1e5efd1
Oct 24 16:25:52 ubuntu1804 dockerd[1402]: time="2019-10-24T16:25:52.649551513Z" level=info msg="Layer sha256:903ab9000f0a93e49537d5d00c5c8a8cab
Oct 24 16:26:47 ubuntu1804 dockerd[1402]: time="2019-10-24T16:26:47.428865652Z" level=info msg="Layer sha256:903ab9000f0a93e49537d5d00c5c8a8cab
Oct 24 16:27:41 ubuntu1804 dockerd[1402]: time="2019-10-24T16:27:41.603287585Z" level=info msg="Layer sha256:903ab9000f0a93e49537d5d00c5c8a8cab
قم بتثبيت أحدث إصدار من Docker يتم إنشاؤه باستخدام أمر pip كما هو موضح أدناه:
apt-get install python-pip
apt-get install docker-compose
تثبيت Mailtrain مع Docker
قم بتنزيل أحدث إصدار من Mailtrain من مستودع Git باستخدام الأمر التالي:
git clone git://github.com/Mailtrain-org/mailtrain.git
قم بتغيير المجلد إلى mailtrain وأعد تسمية ملف Docker-Compose الافتراضي:
cd mailtrain
mv docker-compose.override.yml.tmpl docker-compose.override.yml
ابدأ تشغيل Mailtrain docker containers بالأمر التالي:
docker-compose up -d
سيقوم هذا الأمر بتنزيل وبدء تشغيل mailtrain و mysql و redis كما هو موضح أدناه:
Creating network "mailtrain_default" with the default driver
Creating volume "mailtrain_mailtrain-node-config" with default driver
Creating volume "mailtrain_mailtrain-node-data" with default driver
Creating volume "mailtrain_mailtrain-redis-data" with default driver
Creating volume "mailtrain_mailtrain-node-reports" with default driver
Creating volume "mailtrain_mailtrain-mysq-data" with default driver
Pulling redis (redis:3.0)...
3.0: Pulling from library/redis
f5cc0ee7a6f6: Pull complete
5fc25ed18e87: Pull complete
e025bc8872f6: Pull complete
77c68b51b836: Pull complete
7c403ece3755: Pull complete
0a653bd338f4: Pull complete
31531fd948c6: Pull complete
Digest: sha256:730b765df9fe96af414da64a2b67f3a5f70b8fd13a31e5096fee4807ed802e20
Status: Downloaded newer image for redis:3.0
Pulling mysql (mysql:5.7)...
5.7: Pulling from library/mysql
80369df48736: Pull complete
e8f52315cb10: Pull complete
cf2189b391fc: Pull complete
cc98f645c682: Pull complete
27a27ac83f74: Pull complete
fa1f04453414: Pull complete
d45bf7d22d33: Pull complete
c7d49ffebc56: Pull complete
511a8052b204: Pull complete
5d5df4c12444: Pull complete
d482603a2922: Pull complete
Digest: sha256:44b33224e3c406bf50b5a2ee4286ed0d7f2c5aec1f7fdb70291f7f7c570284dd
Status: Downloaded newer image for mysql:5.7
Building mailtrain
:
:
Removing intermediate container 20676b10252b
---> 0abdb4121f54
Step 6/9 : COPY . /app
---> c8af7560e844
Step 7/9 : EXPOSE 3000
---> Running in 3ff55179a229
Removing intermediate container 3ff55179a229
---> d83b49d4b24b
Step 8/9 : ENTRYPOINT ["bash", "/app/docker-entrypoint.sh"]
---> Running in e5baf6a1ea2e
Removing intermediate container e5baf6a1ea2e
---> c4f899a0f8f9
Step 9/9 : CMD ["node", "index.js"]
---> Running in fe94519d2bd3
Removing intermediate container fe94519d2bd3
---> 2808c2972f20
Successfully built 2808c2972f20
Successfully tagged mailtrain:latest
WARNING: Image for service mailtrain was built because it did not already exist. To rebuild this image you must use `docker-compose build` or `docker-compose up --build`.
Creating mailtrain_redis_1 ... done
Creating mailtrain_mysql_1 ... done
Creating mailtrain_mailtrain_1 ... done
يمكنك التحقق من جميع الـ containers قيد التشغيل باستخدام الأمر التالي:
docker ps
سترى النتيجة التالية
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
0e837c586c39 mailtrain:latest "bash /app/docker-en…" About a minute ago Up 55 seconds 0.0.0.0:3000->3000/tcp mailtrain_mailtrain_1
49a4e69a09c6 mysql:5.7 "docker-entrypoint.s…" About a minute ago Up About a minute 3306/tcp, 33060/tcp mailtrain_mysql_1
a1449b64a196 redis:3.0 "docker-entrypoint.s…" About a minute ago Up About a minute 6379/tcp mailtrain_redis_1
الوصول إلى واجهة ويب Mailtrain
تم الآن تشغيل Mailtrain container على المنفذ 3000.
افتح مستعرض الويب واكتب عنوان URL http: // your-server-ip: 3000.
يجب أن تشاهد الـ dashboard الافتراضية الخاصة بـ Mailtrain في الصفحة التالية:
انقر Sign in ستشاهد الصفحة التالية:
أدخل اسم المستخدم وكلمة المرور الافتراضيين admin/admin.
انقر Sign in.
يجب أن تشاهد لوحة القيادة الافتراضية Mailtrain في الصفحة التالية:
يجب أن تشاهد لوحة القيادة الافتراضية Mailtrain في الصفحة التالية:
يجب أن تشاهد الـ dashboard الافتراضية الخاصة بـ Mailtrain في الصفحة التالية:
إعداد Nginx كوكيل عكسي (Reverse Proxy) لـ Mailtrain
ستحتاج إلى إنشاء Nginx كوكيل عكسي لـ Mailtrain على المنفذ 3000.
للقيام بذلك قم أولاً بتثبيت خادم الويب Nginx عن طريق تشغيل الأمر التالي:
apt-get install nginx -y
أنشئ ملف إعدادات Nginx virtual host باستخدام الأمر التالي:
nano /etc/nginx/sites-available/mailtrain.conf
أضف الأسطر التالية:
upstream mailtrain {
server 127.0.0.1:3000 weight=100 max_fails=5 fail_timeout=5;
}
server {
listen 80;
server_name example.com;
location / {
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Server $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://mailtrain/;
}
}
احفظ وأغلق الملف.
تحقق من Nginx بحثًا عن أي خطأ باستخدام الأمر التالي:
nginx -t
سترى النتيجة التالية
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
قم بتفعيل ملف Nginx virtual host باستخدام الأمر التالي:
ln -s /etc/nginx/sites-available/mailtrain.conf /etc/nginx/sites-enabled/
أعد تشغيل خادم الويب Nginx لتطبيق الإعدادات:
systemctl restart nginx
تأمين Mailtrain باستخدام Let's Encrypt
ستحتاج إلى تثبيت Certbot client لتأمين Mailtrain باستخدام Let's Encrypt free SSL.
بشكل افتراضي ، لا يتوفر أحدث إصدار من Certbot في Ubuntu 18.04 افتراضياً.
لذا أضف مستودع Certbot عن طريق تشغيل الأمر التالي:
add-apt-repository ppa:certbot/certbot
قم بتحديث المستودع وتثبيت Certbot باستخدام الأمر التالي:
apt-get update -y
apt-get install certbot python-certbot-nginx -y
قم بتشغيل الأمر التالي لتنزيل Let's Encrypt free SSL لمجالك example.com وقم بإعداد Nginx لاستخدام الـ certificate.
certbot --nginx -d example.com
أدخل عنوان بريدك الإلكتروني ووافق على شروط الخدمة.
بمجرد تثبيت الـ certificate بنجاح يجب أن ترى الناتج التالي:
بمجرد تثبيت الـ certificate بنجاح يجب أن ترى الناتج التالي:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://example.com
You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IMPORTANT NOTES:
- Congratulations! Your certificate and chain have been saved at:
/etc/letsencrypt/live/example.com/fullchain.pem
Your key file has been saved at:
/etc/letsencrypt/live/example.com/privkey.pem
Your cert will expire on 2020-01-22. To obtain a new or tweaked
version of this certificate in the future, simply run certbot again
with the "certonly" option. To non-interactively renew *all* of
your certificates, run "certbot renew"
- Your account credentials have been saved in your Certbot
configuration directory at /etc/letsencrypt. You should make a
secure backup of this folder now. This configuration directory will
also contain certificates and private keys obtained by Certbot so
making regular backups of this folder is ideal.
- If you like Certbot, please consider supporting our work by:
Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate
Donating to EFF: https://eff.org/donate-le
يمكنك الآن الوصول إلى تطبيق Mailtrain الخاص بك بأمان باستخدام العنوان https://example.com .