📧 تثبيت Keila — نشرات بريدية مفتوحة المصدر وتسويق عبر البريد الإلكتروني

انشر Keila على Ubuntu بـ Docker — أداة نشرات بريدية مفتوحة المصدر تراعي الخصوصية لبناء قوائم المشتركين وتصميم الحملات والإرسال بشروطك الخاصة، على المنفذ 8227.

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

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

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

سكريبت تثبيت آلي — ينشر Keila مع قاعدة بيانات PostgreSQL الخاصة بها على المنفذ 8227 مع تسجيل دخول مشرف مُنشأ تلقائياً. التسجيل معطّل افتراضياً، لذا استخدم بيانات اعتماد المشرف المطبوعة.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/email/keila/keila-ubuntu.sh

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

chmod +x keila-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم ويُشغّل Keila مع قاعدة بيانات PostgreSQL الخاصة بها على المنفذ 8227. يُنشئ مفتاح سر أساسي وحساب مشرف (admin@example.com) بكلمة مرور عشوائية، ويُعطّل التسجيل المفتوح.

sudo bash keila-ubuntu.sh

4 فتح واجهة الويب وتسجيل الدخول

افتح Keila في متصفحك وسجّل الدخول بحساب admin@example.com المُنشأ، ثم اربط إرسالك (SMTP) وابدأ ببناء نشرتك البريدية الأولى:

http://<your-server-ip>:8227

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

المنفذالغرض
8227Web UI (host → container 4000)
admin@example.comGenerated password, printed after install — change it
PostgreSQLInternal — holds your subscriber lists and campaigns

نظرة عامة

Keila أداة مجانية ومفتوحة المصدر للنشرات البريدية والتسويق عبر البريد الإلكتروني، مبنية بلغة Elixir على إطار عمل Phoenix — بديل ذاتي الاستضافة لخدمات مثل Mailchimp أو Sendinblue. تتيح لك بناء قوائم مشتركين وتقسيمها، وتصميم الحملات بمحرر بصري بالكتل أو بصيغة Markdown، وتشغيل نماذج تسجيل بتأكيد مزدوج (double opt-in)، والإرسال عبر مزود SMTP من اختيارك. رُخّصت Keila بموجب AGPLv3 وبُنيت مع جعل الخصوصية والامتثال لـ GDPR هدفاً أساسياً في التصميم، بما في ذلك وضع اختياري بلا تتبع يُعطّل تتبع الفتح والنقر للمشتركين الذين يفضلون عدم تتبعهم.

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

تفرض منصات النشرات التجارية رسوماً شهرية لكل مشترك وتخزّن قائمتك بالكامل — بما فيها بيانات الجميع الشخصية — على سيرفراتها. تُبقي Keila هذه البيانات على بنية تحتية تتحكم فيها أنت، وهذا مهم للامتثال لـ GDPR وللحفاظ على ثقة المشتركين. ولأن Keila تفوّض عملية الإرسال الفعلية لمزود SMTP تختاره، يمكنك أيضاً اختيار مُرسِل بسمعة تسليم قوية (Amazon SES، Postmark، Mailgun، أو سيرفر بريدك الخاص) بدلاً من الارتباط بسمعة وأسعار مزود واحد.

متى تحتاجه

  • ترسل نشرة بريدية دورية وتريد ملكية كاملة لقائمة مشتركيك وبيانات حملاتك
  • تحتاج أداة واعية لـ GDPR مع تأكيد تسجيل مزدوج وخيار تعطيل تتبع الفتح/النقر
  • تريد التوقف عن دفع رسوم SaaS لكل مشترك والدفع فقط مقابل تكاليف سيرفرك وSMTP الخاص بك
  • لديك بالفعل مزود SMTP (Amazon SES، Postmark، Mailgun) وتحتاج فقط مدير حملات وقوائم فوقه
  • تدير عدة نشرات بريدية أو مشاريع وتريد عزلها في أداة ذاتية الاستضافة واحدة بدلاً من عدة حسابات SaaS
  • تريد بديلاً يراعي الخصوصية لـ Mailchimp لا يشارك بيانات سلوك المشتركين مع طرف ثالث

من يحتاجه

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

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

  • إرسال نشرة بريدية أسبوعية أو شهرية لقاعدة مشتركين متنامية بمحرر حملات بصري
  • تشغيل نماذج تسجيل بتأكيد مزدوج مضمّنة في موقعك لبناء قائمة موثقة الموافقة
  • تقسيم المشتركين لمجموعات وإرسال حملات مستهدفة لشرائح محددة
  • تتبع الفتحات والنقرات (أو تعطيل التتبع تماماً للإرسال الواعي بالخصوصية)
  • توجيه الإرسال عبر مزود SMTP الخاص بك للتحكم الكامل بسمعة المُرسِل
  • إدارة عدة مشاريع نشرات بريدية منفصلة من نسخة واحدة ذاتية الاستضافة

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

  • محرر حملات بصري قائم على الكتل بالإضافة لمحرر Markdown للنشرات النصية أولاً
  • إدارة قوائم مشتركين بوسوم وشرائح وحقول مخصصة للإرسال المستهدف
  • نماذج تسجيل بتأكيد مزدوج يمكن تضمينها مباشرة في موقعك
  • وضع خصوصية اختياري يُعطّل تتبع الفتح والنقر للجماهير الحساسة لـ GDPR
  • الإرسال عبر أي مزود SMTP تُعدّه — بدون بنية إرسال مستضافة من Keila نفسها
  • لوحة إحصائيات الحملات تعرض الفتحات والنقرات والارتدادات وإلغاء الاشتراك عند تفعيل التتبع
  • واجهة برمجية REST لإطلاق الحملات أو إدارة المشتركين برمجياً
  • دعم مشاريع متعددة بحيث تُشغّل نسخة Keila واحدة عدة نشرات بريدية مستقلة

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

  • سجّل الدخول بحساب admin@example.com المُنشأ وكلمة المرور المطبوعة بعد التثبيت، ثم غيّر كلمة المرور
  • اذهب إلى Settings → Sending واضبط مزود SMTP الخاص بك (المضيف، المنفذ، بيانات الاعتماد، وعنوان المُرسِل)
  • أنشئ مشروعك وقائمة مشتركيك الأولى، ثم صمم نموذج تسجيل لتضمينه في موقعك
  • استورد المشتركين الحاليين عبر CSV إذا كنت تنتقل من منصة أخرى، مع احترام موافقتهم الأصلية
  • صمم حملتك الأولى بمحرر الكتل أو محرر Markdown وأرسل بريداً تجريبياً لنفسك
  • فعّل أو عطّل تتبع الفتح/النقر في إعدادات المشروع حسب متطلبات الخصوصية لديك
  • أعدّ نطاقاً مخصصاً وسجلات DNS (SPF وDKIM وDMARC) عند مزود SMTP لتعظيم قابلية التسليم

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

  • غيّر كلمة مرور المشرف المُنشأة فوراً بعد أول تسجيل دخول وعطّل التسجيل المفتوح إذا لم يكن معطلاً بالفعل
  • شغّل Keila دائماً خلف HTTPS عبر وكيل عكسي — يجب ألا تنتقل بيانات تسجيل الدخول ومحتوى الحملات عبر HTTP عادي أبداً
  • استخدم بيانات اعتماد SMTP بنطاق إرسال فقط حيث يدعم مزودك ذلك، بدلاً من وصول كامل للحساب
  • اضبط SPF وDKIM وDMARC على نطاق الإرسال لمنع الانتحال وتحسين قابلية التسليم
  • فعّل التأكيد المزدوج على جميع نماذج التسجيل للحفاظ على نظافة قائمتك وتلبية متطلبات الموافقة تحت GDPR
  • أبقِ صورة Keila Docker محدّثة لتلقي تصحيحات الأمان لمكدس Elixir/Phoenix
  • قيّد الوصول لقاعدة البيانات وبيانات اعتماد SMTP — كلاهما مخزّن كمتغيرات بيئة ويجب ألا يُرفع أبداً إلى نظام التحكم بالإصدارات

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

تستمع Keila على المنفذ 8227 على المضيف، المُعيّن من المنفذ الداخلي 4000 للحاوية. لا تكشف المنفذ 8227 مباشرة للإنترنت دون HTTPS أبداً — ضعه خلف وكيل عكسي مثل Nginx Proxy Manager أو Caddy بشهادة TLS صالحة على المنفذ 443. قاعدة بيانات PostgreSQL التي تستخدمها Keila داخلية لشبكة Docker ويجب ألا تُنشر لمنفذ على المضيف أو تُكشف خارجياً أبداً.

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

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

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

  • ترك كلمة مرور admin@example.com المُنشأة دون تغيير بعد التثبيت
  • كشف المنفذ 8227 للإنترنت دون وكيل عكسي وHTTPS أمامه
  • عدم ضبط SPF/DKIM/DMARC على نطاق الإرسال، مما يجعل الحملات تصل لصندوق الرسائل غير المرغوبة
  • تخطي التأكيد المزدوج، مما يؤدي لشكاوى إزعاج بريدي وقد يخالف متطلبات الموافقة
  • افتراض أن Keila ترسل البريد بنفسها — نسيان إعداد مزود SMTP خارجي قبل إرسال حملة
  • استيراد قوائم بريد مُشتراة أو مُجمّعة بدلاً من مشتركين قائمين على الموافقة، مما يضر بسمعة المُرسِل
  • عدم أخذ نسخة احتياطية من قاعدة بيانات PostgreSQL، مما يفقد كل تاريخ المشتركين والحملات إذا حُذفت الحاوية

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

  • تعذر تسجيل الدخول — تأكد أنك تستخدم admin@example.com بكلمة المرور المطبوعة بعد التثبيت، وليست كلمة مرور مخمّنة
  • البريد لا يُرسل — تحقق من مضيف SMTP والمنفذ واسم المستخدم وكلمة المرور في Settings → Sending، وراجع سجلات Keila لأخطاء SMTP
  • الحملات تصل لصندوق الرسائل غير المرغوبة — تحقق أن SPF وDKIM وDMARC مضبوطة بشكل صحيح لنطاق الإرسال
  • نموذج التسجيل لا يظهر في موقعك — تأكد أن كود التضمين يطابق معرّف مشروعك وأن CORS لا يحجب الطلب
  • تتبع الفتح/النقر لا يُسجَّل — تأكد أن التتبع مفعّل في إعدادات المشروع وأن الصور/الروابط ليست محجوبة بواسطة أدوات حجب الإعلانات
  • الحاوية تفشل في البدء — تحقق أن حاوية PostgreSQL سليمة أولاً، لأن Keila تعتمد على إمكانية الوصول لقاعدة البيانات
  • صفحة التسجيل متاحة بشكل غير متوقع — تأكد أن التسجيل المفتوح معطّل في إعدادات البيئة إذا كنت تريد حساب المشرف فقط

البدائل

Listmonk أداة نشرات بريدية سريعة جداً وعالية الأداء مكتوبة بلغة Go، ممتازة للقوائم الكبيرة وسرعة الإرسال الخام، بواجهة أكثر عملية. Mailtrain خيار أقدم وذاتي الاستضافة بشكل مماثل لكن بتحديثات نشطة أقل. Mailchimp وSendinblue منصتان تجاريتان مصقولتان لكنهما تفرضان رسوماً لكل مشترك وتخزّنان قائمتك على بنيتهما التحتية. للفرق التي تريد تحديداً أداة نشرات بريدية حديثة ذاتية الاستضافة وواعية لـ GDPR بواجهة ودودة، تُعد Keila من الخيارات الأكثر نشاطاً في الصيانة.

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

تجاوز Keila إذا كنت تحتاج بريداً معاملاتياً (إعادة تعيين كلمات المرور، تأكيدات الطلبات) — فهي مبنية للنشرات والحملات وليس الإرسال المعاملاتي؛ استخدم مزوداً معاملاتياً مخصصاً بدلاً من ذلك. إذا كنت ترسل لقوائم كبيرة جداً (مئات الآلاف من المشتركين) وتحتاج أقصى سرعة إرسال خام، قد تؤدي بنية Listmonk المبنية بـ Go أداءً أفضل تحت الحمل الثقيل. كما أن Keila لا ترسل البريد بنفسها — لا تزال تحتاج إعداد ودفع مقابل مزود SMTP خارجي، فهي لا تُلغي كل تكاليف الإرسال، فقط رسوم المنصة لكل مشترك.

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

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

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

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

ما هي Keila؟

إنها أداة مفتوحة المصدر للنشرات البريدية والتسويق عبر البريد الإلكتروني — بديل ذاتي الاستضافة لخدمات مثل Mailchimp. تبني وتدير قوائم المشتركين، وتصمم الحملات بمحرر بصري أو Markdown، وتقسّم جمهورك، وترسل عبر SMTP الخاص بك، كل ذلك من واجهة ويب نظيفة.

ما المنفذ الذي تستخدمه وما بيانات تسجيل الدخول؟

تعمل Keila على المنفذ 8227 على المضيف (مُعيّن من المنفذ 4000 للحاوية). ينشئ المثبّت حساب مشرف مبدئي، admin@example.com، بكلمة مرور عشوائية مطبوعة بعد الإعداد.

هل ترسل البريد الإلكتروني بنفسها؟

لا — تدير Keila قوائمك وحملاتك لكنها تُسلّم عبر مزود SMTP خارجي تُعدّه أنت. هذا مقصود في التصميم: يُبقي قابلية التسليم وسمعة المُرسِل مع خدمة مبنية للإرسال، بينما تتولى Keila جانب النشرة البريدية.

هل هي متوافقة مع GDPR؟

نعم — الخصوصية والامتثال لـ GDPR محور تركيز أساسي. تدعم Keila نماذج تسجيل بتأكيد مزدوج ومعالجة بيانات واعية بالخصوصية، ولأنها ذاتية الاستضافة، تبقى بيانات مشتركيك تحت سيطرتك وضمن نطاقك القضائي بدلاً من منصة تسويق طرف ثالث.

كيف تقارن بـ Listmonk؟

Listmonk أداة نشرات بريدية سريعة جداً وعالية الأداء مكتوبة بلغة Go، ممتازة للقوائم الكبيرة وسرعة الإرسال الخام. تقدم Keila واجهة أكثر ودية وصقلاً وتركيزاً قوياً على الخصوصية وGDPR.