⚙️ تثبيت Dokploy — منصة PaaS ذاتية الاستضافة (بديل Coolify)

انشر Dokploy على Ubuntu — منصة platform-as-a-service مفتوحة المصدر تنشر التطبيقات وقواعد البيانات وحزم Docker Compose من Git مع نطاقات تلقائية وشهادات TLS مجانية عبر Traefik.

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

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

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

سكريبت تثبيت آلي — أمر واحد يشغّل مثبّت Dokploy الرسمي الذي يُعد Docker Swarm وTraefik ولوحة Dokploy على المنفذ 3000.
عرض على GitHub

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

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

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/dokploy/dokploy-ubuntu.sh

2 جعله قابلاً للتنفيذ

chmod +x dokploy-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم ويشغّل مثبّت Dokploy الرسمي، الذي يُهيّئ Docker Swarm، وينشر Traefik كوكيل عكسي، ويشغّل لوحة Dokploy. يجب أن تكون المنافذ 80 و443 و3000 متاحة.

sudo bash dokploy-ubuntu.sh

4 إنشاء حساب المشرف

افتح المتصفح وانتقل إلى لوحة Dokploy على المنفذ 3000، ثم أنشئ أول حساب مشرف في شاشة الإعداد:

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

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

المنفذالغرض
3000Dokploy management panel
80 / 443Traefik reverse proxy for deployed apps + Let's Encrypt

نظرة عامة

Dokploy منصة platform-as-a-service مفتوحة المصدر وذاتية الاستضافة تتيح لك نشر التطبيقات وقواعد البيانات وحزم Docker Compose مباشرة من مستودعات Git. تُهيّئ تلقائياً Traefik كوكيل عكسي، وتُصدر شهادات TLS مجانية من Let's Encrypt، وتدير عمليات نشر متجددة بدون توقف فوق Docker Swarm — مما يمنحك تجربة شبيهة بـ Heroku أو Vercel لكن بالكامل على بنيتك التحتية الخاصة.

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

يزيل Dokploy التكلفة المتكررة والارتباط بمزود واحد الذي تفرضه منصات PaaS المُدارة مثل Heroku أو Vercel أو Railway، مع الحفاظ على نفس الراحة — ادفع إلى Git واحصل على تطبيق مباشر مع HTTPS ونطاق تلقائياً. ولأنه ذاتي الاستضافة، فأنت تتحكم في السيرفرات الأساسية، ويمكنك تشغيل تطبيقات وقواعد بيانات غير محدودة دون فوترة لكل مقعد أو مشروع، مع احتفاظك الكامل ببياناتك وخط أنابيب النشر.

متى تحتاجه

  • تريد تجربة نشر شبيهة بـ Heroku أو Vercel — ادفع إلى Git واحصل على تطبيق مباشر مع HTTPS — لكن على سيرفرك الخاص
  • تدفع رسوماً متكررة لمنصة PaaS مُدارة وتريد نقل هذه الأحمال إلى بنية تحتية تتحكم بها
  • تدير عدة مشاريع صغيرة لعملاء أو مشاريع جانبية وتحتاج لوحة مركزية لنشرها ومراقبتها جميعاً
  • تحتاج تهيئة قواعد بيانات مُدارة (PostgreSQL وMySQL وMongoDB وRedis) بجانب تطبيقاتك دون إعداد كل واحدة يدوياً
  • تريد HTTPS تلقائياً وتوجيه نطاقات فرعية لكل تطبيق دون إعداد Nginx أو Traefik يدوياً بنفسك
  • تحتاج عمليات نشر متجددة بدون توقف حتى لا تقطع التحديثات حركة المرور عن تطبيق مباشر

من يحتاجه

  • المطورون المستقلون والوكالات التي تستضيف مشاريع عدة عملاء وتريد لوحة واحدة لنشر كل شيء وإدارته
  • الشركات الناشئة والفرق الصغيرة التي تجاوزت الحدود المجانية لمنصات PaaS وتريد تكاليف يمكن التنبؤ بها على VPS أو سيرفر مخصص خاص بها
  • عشاق الاستضافة الذاتية الذين يريدون راحة شبيهة بـ Heroku دون الاشتراك المتكرر
  • المطورون ذوو التفكير التشغيلي الذين يفضلون النشر بدفعة Git بدلاً من كتابة ملفات docker-compose يدوياً لكل مشروع
  • شركات SaaS الصغيرة التي تحتاج نشر تطبيقها وقاعدة بياناتها والعمليات الخلفية معاً مع TLS تلقائي
  • الفرق التي تنتقل من Coolify أو Heroku أو Render وتريد بديلاً خفيفاً قائماً على Swarm

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

  • نشر تطبيق ويب بـ Node.js أو Python أو PHP مباشرة من مستودع GitHub أو GitLab مع بناء تلقائي
  • استضافة مواقع أو تطبيقات عدة عملاء تحت نطاقات فرعية مختلفة، لكل منها شهادة TLS مجانية خاصة
  • تهيئة قاعدة بيانات PostgreSQL أو MySQL مُدارة لتطبيق مع نسخ احتياطي تلقائي مجدول
  • تشغيل حزمة Docker Compose كاملة — تطبيق وقاعدة بيانات وذاكرة تخزين مؤقت وعامل خلفي — كمشروع واحد قابل للنشر
  • إعداد بيئتي staging وproduction لنفس التطبيق بنطاقات منفصلة
  • استبدال اشتراك مدفوع في Heroku أو Railway بخط أنابيب نشر ذاتي الاستضافة على VPS واحد

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

  • نشر قائم على Git — اربط مستودع GitHub أو GitLab أو Bitbucket وانشر عند كل دفعة
  • HTTPS وتوجيه نطاقات تلقائي عبر وكيل Traefik العكسي المدمج مع شهادات Let's Encrypt
  • قواعد بيانات مُدارة بنقرة واحدة لـ PostgreSQL وMySQL وMongoDB وMariaDB وRedis مع نسخ احتياطي مجدول
  • دعم Docker Compose لنشر حزم كاملة متعددة الحاويات كمشروع واحد
  • عمليات نشر متجددة بدون توقف مدعومة بتنسيق Docker Swarm
  • سجلات بناء ونشر فورية مباشرة في لوحة الويب
  • إدارة متغيرات البيئة وتخزين الأسرار لكل تطبيق
  • دعم سيرفرات متعددة — اربط سيرفرات إضافية بنفس لوحة Dokploy لتوزيع الأحمال

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

  • أنشئ أول حساب مشرف فوراً بعد التثبيت — من يسجّل أولاً يتحكم باللوحة بالكامل
  • اربط حساب GitHub أو GitLab أو Bitbucket تحت الإعدادات حتى يستطيع Dokploy الوصول لمستودعاتك
  • أنشئ مشروعاً جديداً واختر المصدر: مستودع Git، أو صورة Docker، أو ملف Docker Compose
  • اضبط إعدادات البناء (حزمة البناء، المنفذ، متغيرات البيئة) وأطلق أول عملية نشر
  • أضف نطاقاً مخصصاً تحت تبويب Domains للتطبيق — يطلب Dokploy شهادة Let's Encrypt تلقائياً
  • هيّئ قاعدة بيانات مُدارة من قسم Databases إذا احتاج تطبيقك PostgreSQL أو MySQL أو MongoDB أو Redis
  • أعدّ نسخاً احتياطية مجدولة لقواعد بياناتك واضبط وجهة بعيدة مثل تخزين متوافق مع S3
  • راقب عمليات النشر واستخدام الموارد من لوحة التحكم، وراجع سجلات البناء عند فشل عملية نشر

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

  • قيّد الوصول للمنفذ 3000 (لوحة الإدارة) في الجدار الناري — يجب أن تصله فقط عناوين IP الموثوقة أو VPN
  • عيّن كلمة مرور قوية لحساب المشرف فوراً، فهو يملك تحكماً كاملاً في كل تطبيق وسيرفر منشور
  • أبقِ المنفذين 80 و443 مفتوحين فقط لتوجيه حركة مرور التطبيقات المنشورة عبر Traefik، وليس للوحة نفسها أبداً
  • فعّل المصادقة الثنائية لحساب المشرف إذا كان إصدار Dokploy لديك يدعمها
  • خزّن متغيرات البيئة الحساسة (مفاتيح API، كلمات مرور قواعد البيانات) عبر إدارة الأسرار المدمجة في Dokploy بدلاً من كتابتها مباشرة
  • أبقِ تثبيت Dokploy محدّثاً — غالباً ما تتضمن الإصدارات الجديدة تصحيحات أمنية للوحة وتكاملها مع Docker Swarm
  • قيّد من يملك وصولاً للوحة Dokploy — كل مستخدم يملك وصول للوحة يستطيع نشر كود وقراءة أسرار البيئة
  • افصل قواعد بيانات الإنتاج عن قواعد بيانات staging وقيّد كشف منافذ قواعد البيانات مباشرة للإنترنت

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

يحتاج Dokploy ثلاثة منافذ. المنفذ 3000 يخدم لوحة إدارة Dokploy ويجب ألا يُكشف أبداً للإنترنت العام — قيّده على VPN أو عناوين IP موثوقة فقط. المنفذان 80 و443 يستخدمهما وكيل Traefik العكسي الذي يُثبّته Dokploy تلقائياً؛ يجب أن يكونا مفتوحين للإنترنت حتى يستطيع Traefik توجيه حركة المرور لتطبيقاتك المنشورة وإكمال تحديات شهادة Let's Encrypt من نوع HTTP-01 أو TLS-ALPN-01. لا تُشغّل خدمة أخرى على 80/443 على نفس المضيف، لأن نسخة Traefik الخاصة بـ Dokploy تستحوذ عليهما.

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

  • انسخ قاعدة بيانات Dokploy الداخلية احتياطياً، فهي تخزّن كل إعدادات المشاريع ومتغيرات البيئة وتاريخ عمليات النشر
  • جدول نسخاً احتياطية تلقائية لكل قاعدة بيانات مُدارة (PostgreSQL، MySQL، MongoDB) إلى وجهة خارجية مثل تخزين متوافق مع S3
  • صدّر ملفات docker-compose.yml وإعدادات متغيرات البيئة للمشاريع المنشورة عبر Compose
  • وثّق أي مستودعات Git وفروع مرتبطة بكل مشروع حتى يمكن إعادة ربط عمليات النشر بعد الترحيل
  • انسخ احتياطياً أي إعدادات Traefik مخصصة أو middleware أضفتها خارج إعداد Dokploy المُدار
  • اختبر استعادة نسخة احتياطية لقاعدة بيانات دورياً للتأكد من أن وجهة النسخ الاحتياطي وبيانات الاعتماد لا تزال صالحة

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

  • كشف المنفذ 3000 مباشرة للإنترنت دون قاعدة جدار ناري أو VPN، مما يمنح أي شخص يجده فرصة للوصول للوحة الإدارة
  • تأخير إنشاء حساب المشرف بعد التثبيت — نسخة Dokploy غير المُطالَب بها يمكن أن يستحوذ عليها أول من يسجّل
  • تشغيل سيرفر ويب أو وكيل عكسي آخر على المنفذين 80/443 على نفس المضيف، مما يتعارض مع نسخة Traefik الخاصة بـ Dokploy
  • نسيان ضبط نسخ احتياطية مجدولة لقواعد البيانات المُدارة، مما يترك بيانات الإنتاج دون مسار للاستعادة
  • النشر مباشرة على مشروع دون إعداد بيئة staging أولاً، مما يخاطر بتوقف بسبب تغييرات غير مُختبرة
  • عدم ضبط حدود موارد للتطبيقات المنشورة، مما يسمح لحاوية واحدة مسيئة باستنزاف موارد السيرفر
  • تخزين الأسرار في متغيرات بيئة عادية مُضمّنة في مستودع Git بدلاً من استخدام إدارة الأسرار في Dokploy
  • تثبيت Dokploy على مضيف يملك بالفعل إعداد Docker Swarm أو وكيل عكسي نشط تريد الاحتفاظ به

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

  • اللوحة غير قابلة للوصول على المنفذ 3000 — تحقق من أن حاوية Dokploy تعمل بـ docker ps وأن الجدار الناري يسمح بعنوان IP الخاص بك
  • فشل النشر عند خطوة البناء — راجع سجلات البناء في اللوحة بحثاً عن تبعيات مفقودة أو أمر بناء خاطئ
  • النطاق المخصص لا يحصل على HTTPS — تحقق من أن سجل DNS من نوع A للنطاق يشير إلى IP سيرفرك وأن المنفذين 80/443 قابلان للوصول من الإنترنت لتحدي Let's Encrypt
  • التطبيق يُنشر لكنه غير قابل للوصول على نطاقه — تحقق من أن المنفذ الداخلي للتطبيق يطابق ما هو مضبوط في إعدادات النطاق
  • فشل تهيئة Docker Swarm أثناء التثبيت — تأكد من عدم وجود إعداد Swarm متعارض وأن السيرفر يستوفي الحد الأدنى من متطلبات Docker
  • رفض اتصال قاعدة البيانات من تطبيق — تأكد من أن حاوية قاعدة البيانات تعمل وأن سلسلة الاتصال تستخدم اسم الخدمة الداخلي الصحيح
  • النشر المتجدد يسبب توقفاً قصيراً بدلاً من صفر توقف — تحقق من إعداد فحص الصحة للتطبيق؛ فبدونه لا يستطيع Swarm التحقق من الجاهزية قبل تحويل حركة المرور
  • Traefik يعرض شهادة افتراضية بدلاً من شهادة صالحة — راجع سجلات Traefik لأخطاء تحدي ACME، وغالباً ما يكون السبب أن DNS لم ينتشر بعد

البدائل

Coolify هو أشهر بديل مفتوح المصدر لـ Heroku مع مجتمع أكبر ونظام إضافات أوسع، رغم أنه قد يكون أثقل على الموارد. CapRover منصة PaaS أبسط تركّز على الحاويات بميزات أقل. Portainer يدير حاويات Docker لكنه لا يوفّر نشراً قائماً على Git أو نطاقات تلقائية كما يفعل Dokploy. للفرق التي تريد تجربة مُدارة بالكامل ولا تمانع الارتباط بمزود واحد، تبقى Vercel وRailway وHeroku خيارات صالحة لكن بتكاليف متكررة. يقع Dokploy بين بساطة CapRover وعمق ميزات Coolify، ببنية خفيفة قائمة على Swarm.

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

Dokploy ليس مثالياً إذا كنت تحتاج منصة تنسيق بمستوى Kubernetes مع توسع تلقائي متقدم وتعافٍ عبر مناطق متعددة ونظام operators كبير — استخدم خدمة Kubernetes مُدارة بدلاً منه. إذا كنت تنشر موقعاً ثابتاً واحداً أو تطبيقاً صغيراً فقط، فقد تكون أداة أبسط مثل Caddy مع ملف docker-compose أساسي أخف من تشغيل لوحة PaaS كاملة. الفرق التي تحتاج عقود دعم مؤسسي واتفاقيات مستوى خدمة تُخدَم بشكل أفضل بمنصة مُدارة مثل Heroku أو Render بدلاً من مشروع ذاتي الاستضافة مدعوم من المجتمع.

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

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

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

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

ما هو Dokploy وكيف يختلف عن Coolify؟

Dokploy منصة PaaS ذاتية الاستضافة ومفتوحة المصدر تنشر التطبيقات وقواعد البيانات من Git مع نطاقات تلقائية وHTTPS، شبيهة بـ Heroku أو Vercel. Coolify هو البديل الأكثر شهرة بمجتمع أكبر. Dokploy خفيف وقائم على Swarm.

ما المنافذ التي يحتاجها Dokploy؟

ثلاثة: 80 و443 لـ Traefik لخدمة التطبيقات المنشورة والحصول على شهادات Let's Encrypt، و3000 للوحة إدارة Dokploy. يجب أن يصل 80 و443 للإنترنت؛ أما اللوحة على 3000 فيجب تقييدها.

كيف أنشئ حساب المشرف؟

بعد التثبيت، افتح لوحة Dokploy على http://your-server-ip:3000. تعرض أول زيارة شاشة إعداد لإنشاء حساب المشرف. افعل هذا فوراً، لأن من يسجّل أولاً يتحكم بسيرفرك.

هل يستخدم Dokploy Docker Swarm؟

نعم. أثناء التثبيت يُهيّئ Dokploy Docker Swarm لعمليات نشر متجددة بدون توقف، وينشر Traefik كوكيل عكسي. ثبّته على مضيف بدون إعداد Swarm أو وكيل عكسي متعارض تريد الاحتفاظ به.

هل يستطيع Dokploy نشر قواعد البيانات أيضاً؟

نعم. بجانب التطبيقات، يستطيع Dokploy تهيئة قواعد بيانات مُدارة تشمل PostgreSQL وMySQL وMongoDB وRedis، ويستطيع جدولة نسخ احتياطية لها، كل ذلك من نفس اللوحة.