لماذا تنشر باستخدام Dokploy على خادم VPS؟
أتاح مزودو PaaS المُدار نموذجًا مغريًا: ادفع الكود، احصل على رابط. لكن هذا الراحة لها ثمن. مع ارتفاع حركة المرور أو نمو قواعد البيانات، ترتفع الفواتير الشهرية. Dokploy يعكس المعادلة: ثبِّته مرة واحدة على VPS بموارد ثابتة واحصل على نفس تجربة النشر بتكلفة متوقعة تبدأ من 99 درهم/شهر.
المنصة مبنية بالكامل على Docker. كل تطبيق يعمل في حاوية أو مكدس Compose؛ Dokploy يُنظِّم الشبكة والأحجام وخادم البروكسي العكسي Traefik وشهادات Let's Encrypt. تتيح لك واجهة الويب إدارة كل شيء دون فتح طرفية — وإن ظلت الطرفية متاحة للعمليات المتقدمة.
أبرز مزايا Dokploy
- النشر من Git (GitHub أو GitLab أو Bitbucket) أو من صورة Docker Hub
- بروكسي عكسي Traefik مدمج مع شهادات Let's Encrypt التلقائية
- دعم أصلي لـ Docker Compose — انشر مكدسات متعددة الخدمات بنقرة واحدة
- متغيرات بيئة مشفرة تُدار مباشرة من الواجهة
- نسخ احتياطية مجدولة إلى S3 أو Backblaze B2 أو أي تخزين متوافق
- قواعد بيانات مُدارة (PostgreSQL و MySQL و MongoDB و Redis) مُهيَّأة محليًا
- سجلات فورية ومقاييس CPU/RAM لكل خدمة
- مفتوح المصدر، بلا قياس عن بُعد إجباري، مُستضاف ذاتيًا على بنيتك التحتية
Dokploy مقابل Coolify مقابل Caprover — أيّها تختار؟
مرّر الجدول أفقيًا
| المعيار | Dokploy | Coolify | Caprover |
|---|---|---|---|
| الرخصة | Apache 2.0 | Apache 2.0 | Apache 2.0 |
| البروكسي المدمج | Traefik | Traefik / Caddy | NGINX |
| دعم Docker Compose الأصلي | نعم | نعم | جزئي |
| قواعد بيانات مُدارة | نعم (5 محركات) | نعم (متعددة) | غير أصلي |
| نسخ احتياطية مدمجة | نعم (S3/B2) | نعم | لا |
| واجهة المستخدم | عصرية وواضحة | شاملة جدًا | وظيفية |
| منحنى التعلم | منخفض | متوسط | متوسط |
| النضج (منتصف 2026) | نشطة — v0.15.x | ناضجة — v4.x | مستقرة — v1.x |
المتطلبات الأساسية
قبل تثبيت Dokploy، تأكد من توفر ما يلي:
- خادم VPS يعمل بنظام Ubuntu 22.04 LTS أو Debian 12 (موصى بهما)، بحد أدنى 2 vCPU و2 جيجابايت RAM. للمكدسات المعقدة (Supabase أو n8n مع العمال)، خطط لـ 4 جيجابايت.
- وصول SSH كـ root أو مستخدم بصلاحيات sudo.
- اسم نطاق يشير إلى IP الخادم — أو عنوان IP على الأقل للاختبار الأولي.
- المنفذان 80 و443 مفتوحان في جدار الحماية. Dokploy يستخدم أيضًا المنفذ 3000 لواجهته أثناء التثبيت؛ يمكنك تقييده لاحقًا.
- غياب Docker Engine من الخادم وقت التثبيت (يثبّته السكريبت بالنسخة الصحيحة تلقائيًا).
تثبيت Dokploy والنشر عليه
الاتصال بخادم VPS عبر SSH
افتح طرفية واتصل:
ssh root@your-ip. إذا كنت تستخدم مستخدمًا غير root، أضفsudoقبل الأوامر التالية.تشغيل سكريبت التثبيت الرسمي
أمر واحد يكفي لتثبيت Docker و Traefik ولوحة Dokploy:
curl -sSL https://dokploy.com/install.sh | sh. يكتشف السكريبت توزيعتك ويثبّت التبعيات ويشغّل الخدمات. تستغرق العملية دقيقتين إلى خمس دقائق.الوصول إلى الواجهة وإنشاء حساب المسؤول
بعد اكتمال التثبيت، افتح
http://your-ip:3000في متصفحك. تعرض الزيارة الأولى نموذج إنشاء حساب المسؤول. اختر كلمة مرور قوية — هذا الحساب هو الوحيد الذي يملك وصولًا كاملًا لجميع الموارد.ربط مستودع Git
في القائمة الإعدادات ← موفرو Git، أضف رمز وصول شخصي لـ GitHub أو GitLab أو Bitbucket. Dokploy يستخدمه لاستنساخ مستودعاتك ومتابعتها. لـ GitHub، رمز بصلاحيتَي
repoوread:userكافٍ.إنشاء أول مشروع وخدمة
انقر على مشروع جديد، أعطه اسمًا، ثم أضف خدمة. اختر النوع: *تطبيق* (صورة Docker أو مستودع Git) أو *Docker Compose* أو *قاعدة بيانات*.
تكوين النطاق وشهادة SSL
في تبويب النطاقات للخدمة، أضف نطاقك (مثال:
app.yourdomain.com). Dokploy ينشئ تلقائيًا قاعدة Traefik ويطلب شهادة Let's Encrypt عبر تحدي HTTP-01.حقن متغيرات البيئة
انتقل إلى تبويب البيئة للخدمة. أدخل كل متغير بالشكل
KEY=value. تُخزَّن القيم مشفرة ولا تظهر أبدًا في السجلات.تشغيل أول عملية نشر
انقر على نشر. Dokploy يسحب الصورة أو يستنسخ المستودع، يبني إذا لزم، ينشئ الحاوية ويربطها بالبروكسي. تابع التقدم في تبويب سجلات النشر بشكل فوري.
تفعيل Webhooks للنشر المستمر
انسخ رابط webhook الظاهر في تبويب عام للخدمة، والصقه في إعدادات webhook مستودعك. من الآن، كل
git pushسيُشغِّل نشرًا تلقائيًا.مراقبة صحة الخدمة والمقاييس
يعرض تبويب المراقبة استخدام CPU والذاكرة والشبكة للحاوية بشكل مباشر. إذا كوّنت فحص صحة في
Dockerfileالخاص بك، يحترمه Dokploy ويعيد تشغيل الحاوية تلقائيًا عند الفشل.
نشر مكدس Docker Compose كامل — مثال مع n8n
تظهر القوة الحقيقية لـ Dokploy مع المكدسات متعددة الخدمات. إليك كيفية نشر n8n (أتمتة سير العمل) مع قاعدة بيانات PostgreSQL.
في Dokploy، أنشئ خدمة جديدة من نوع Docker Compose والصق ملف docker-compose.yml مباشرة. مثال بسيط يتضمن خدمة n8n بالصورة n8nio/n8n ومتغيرات البيئة DB_TYPE=postgresdb و DB_POSTGRESDB_HOST=postgres، وخدمة postgres مع حجم بيانات ثابت.
Dokploy ينشئ شبكة Docker داخلية معزولة للمكدس. تتواصل الخدمات بأسمائها دون كشف المنافذ الداخلية. لـ Supabase، الأمر مماثل تمامًا: استورد ملف docker-compose.yml الرسمي وانشر.
تكوين النطاقات وشهادات SSL ومتغيرات البيئة
Dokploy يدعم نطاقات متعددة لكل خدمة — مفيد لكشف API ولوحة تحكم تحت نطاقات فرعية منفصلة من نفس الحاوية. لكل نطاق قاعدة توجيه Traefik وشهادة SSL مستقلة.
للنطاقات الواسعة (*.mondomaine.com)، يتطلب Traefik تحدي DNS-01 بدلاً من HTTP-01. يكشف Dokploy خيارات إعداد Traefik المتقدمة في الإعدادات ← الوكيل؛ يمكنك هناك حقن ملفات إعداد TOML مخصصة.
لا تخزن الأسرار أبدًا في docker-compose.yml الخاضع للتحكم بالإصدارات. استخدم دائمًا تبويب البيئة في Dokploy الذي يشفر القيم في حالة السكون. للأسرار المشتركة بين عدة خدمات في نفس stack (مفتاح التشفير، رمز API)، عرِّفها مرة واحدة على مستوى المشروع وأشر إليها في كل خدمة.
النسخ الاحتياطية وقواعد البيانات المُدارة
يمكن لـ Dokploy توفير PostgreSQL و MySQL و MongoDB و Redis و MariaDB مباشرة على VPS، دون كتابة ملفات Docker Compose يدويًا. تحت خدمة جديدة ← قاعدة بيانات، اختر المحرك وحدد الاسم والمستخدم وكلمة المرور.
للنسخ الاحتياطية، انتقل إلى تبويب النسخ الاحتياطية لخدمة قاعدة البيانات. كوِّن وجهة S3 واضبط جدولة cron وفترة الاحتفاظ. اختبر الاستعادة بانتظام — نسخة احتياطية غير مختبرة ليست نسخة احتياطية.
لأحجام التطبيقات (الملفات المرفوعة، الأصول المولَّدة)، تتبع النسخ الاحتياطية المنطق ذاته: يؤرشف Dokploy محتوى الحجم ويرسله إلى نفس الوجهة. اختبر الاستعادة بانتظام — نسخة احتياطية غير مختبرة ليست نسخة احتياطية.
استكشاف الأخطاء — 4 أخطاء شائعة
إليك رسائل الخطأ الأكثر شيوعًا وكيفية حلها.
1. Error response from daemon: pull access denied — الصورة خاصة أو الاسم خاطئ. تحقق من الهجاء الصحيح وأضف بيانات اعتماد Docker Hub تحت الإعدادات ← Docker Registries.
2. Certificate not found for domain — فشل تحدي HTTP-01 لـ Let's Encrypt. الأسباب الشائعة: DNS لم يتطابق بعد، أو المنفذ 80 محجوب. تحقق بـ curl -I http://your-domain من جهاز خارجي.
3. Container exited with code 1 — يتعطل التطبيق فور البدء. افتح تبويب السجلات لقراءة stderr الحاوية. السبب دائمًا تقريبًا متغير بيئة مفقود أو اتصال قاعدة بيانات مرفوض.
4. bind: address already in use — منفذ محجوب من عملية أخرى. على الخادم، ss -tlnp | grep :PORT يكشف العملية المسؤولة.
نصيحة أمنية — تقييد الوصول إلى واجهة الإدارة
بشكل افتراضي، المنفذ 3000 لـ Dokploy متاح من أي IP. في بيئة الإنتاج، قيِّده على مستوى جدار الحماية: ufw allow from YOUR_IP to any port 3000 ثم ufw delete allow 3000. فعِّل المصادقة الثنائية من الإعدادات ← الحساب.
ملاحظة حول الإصدار
كُتب هذا الدليل بما يتوافق مع الميزات المتاحة حول الفرع v0.15.x من Dokploy (منتصف 2026). المشروع يتطور بسرعة؛ راجع سجل التغييرات على GitHub لأحدث التحديثات.
التوثيق الرسمي
التوثيق الكامل لـ Dokploy متاح على docs.dokploy.com. ستجد فيه أدلة تكامل CI/CD ومرجع REST API وأمثلة إعدادات Traefik المتقدمة.
