انشر تطبيقاتك باستخدام Dokku على خادم VPS

حيث تُضمّن حلول ‏PaaS‏ الأخرى واجهة ويب ومنسّقاً كاملاً، يبقى ‏Dokku‏ بسيطاً عن قصد: إذ هو مجموعة سكربتات ‏shell‏ تقود ‏Docker‏. تدفع شفرتك بـ ‏git push dokku main‏، فيكتشف ‏Dokku‏ اللغة عبر ‏buildpacks‏ الخاصة بـ ‏Heroku‏ أو ‏Dockerfile‏، ويبني الصورة ويضع التطبيق على الإنترنت. تُدار كل الأمور من سطر الأوامر ما يجعله خفيفاً للغاية وقابلاً للتنبؤ.

‏CapRover‏ و‏Coolify‏ و‏Easypanel‏ توفّر جميعها واجهة رسومية لكن بكلفة ذاكرة أعلى بكثير: ‏CapRover‏ يحتاج إلى 2 غيغابايت من ‏RAM‏ كحدٍّ أدنى، و‏Coolify‏ 4 كذلك بسبب ‏PostgreSQL‏ المضمّنة، أما ‏Easypanel‏ فيستهلك 2 غيغابايت حين يكون البناء نشطاً. ‏Dokku‏ بالمقابل يعمل من ‏512‏ ميغابايت من ‏RAM‏ لتطبيق خفيف ولا يُضيف أيّ مكوّن مراقبة دائم.

‏Dokku‏ هو أكثر منصات ‏PaaS‏ اقتصاداً في الموارد ضمن هذه السلسلة.

‏RAM‏. 512 ميغابايت تكفي لتطبيق خفيف. خصّص 1 غيغابايت للاستخدام اليومي، و2 غيغابايت حين تستخدم ‏buildpacks‏ أو تستضيف قاعدة بيانات على الخادم نفسه. لعدة تطبيقات مع ‏PostgreSQL‏ في آنٍ واحد، استهدف 4 غيغابايت.

المعالج. ‏vCPU‏ واحد يكفي للتطبيقات الخفيفة. مراحل بناء ‏buildpack‏ تستهلك الكثير من المعالج لكنها لا تمنع التشغيل.

القرص. 20 غيغابايت من ‏SSD‏ كحدٍّ أدنى. صور ‏Docker‏ الخاصة بـ ‏buildpacks‏ قد تزن مئات الميغابايتات.

‏Swap‏. على خادم ‏VPS‏ بذاكرة 1 أو 2 غيغابايت، أضِف 2 غيغابايت من ‏swap‏ دوماً لتفادي ‏OOM killer‏.

النظام. ‏Ubuntu 22.04 LTS‏ أو ‏24.04 LTS‏ مثبَّت حديثاً، بدون ‏Docker‏ أو ‏Nginx‏ مسبق التثبيت. المنافذ ‏22‏ (‏SSH‏) و‏80‏ و‏443‏ يجب أن تكون مفتوحة.

‏DNS‏. هيّئ إمّا نطاقاً لكل تطبيق أو نطاق ‏wildcard‏ ‏*.your-domain.com‏ يشير إلى عنوان ‏IP‏ الخادم.

يدير ‏Dokku‏ كل تطبيق في حاوية معزولة. يمكنك استضافة أكبر عدد من التطبيقات بحسب قدرة خادم ‏VPS‏ الخاص بك.

المتغيرات البيئية. استخدم ‏dokku config:set‏ لحقن الأسرار أو معاملات الضبط:

dokku config:set my-app NODE_ENV=production \
  SECRET_KEY=changeme

الاختبار مقابل الإنتاج. الممارسة الشائعة هي إنشاء تطبيقَين على الخادم نفسه:

dokku apps:create my-app-staging
dokku apps:create my-app-production

النطاقات المخصصة. لربط نطاق موجود بتطبيق:

dokku domains:add my-app your-domain.com

يتعامل ‏Dokku‏ مع ‏zero-downtime‏ عبر آلية فحص الصحة قبل التبديل. يمكنك ضبط هذا السلوك بملف ‏CHECKS‏ في جذر مشروعك:

WAIT=10
TIMEOUT=60
/healthz Application is up

التاجات والرجوع للإصدار السابق. يحتفظ ‏Dokku‏ بصور ‏Docker‏ للنشرات السابقة كتاجات. للرجوع:

dokku tags:list my-app
dokku tags:deploy my-app v3

لإنشاء تاج نسخة احتياطية قبل نشر محفوف بمخاطر:

dokku tags:create my-app stable-before-migration

‏PostgreSQL‏. الأكثر استخداماً. أوامر إضافية مفيدة: ‏dokku postgres:backup my-db‏ لنسخة يدوية، ‏dokku postgres:connect my-db‏ للوصول التفاعلي.

‏Redis‏.

dokku plugin:install https://github.com/dokku/dokku-redis.git
dokku redis:create my-cache
dokku redis:link my-cache my-app

يحقن المتغير ‏REDIS_URL‏ في الحاوية.

‏Cron‏ (المجدول). أنشئ ملف ‏app.json‏ في جذر مشروعك:

{
  "cron": [
    { "command": "php artisan schedule:run", "schedule": "* * * * *" }
  ]
}

‏error: failed to push some refs‏ — رفض الأذونات.
تحقق من تسجيل مفتاح ‏SSH‏: ‏dokku ssh-keys:list‏. إن كان غائباً، أضِفه بـ ‏dokku ssh-keys:add admin < ~/.ssh/id_ed25519.pub‏.

‏! [remote rejected]‏ — رُفض ‏hook‏ الاستقبال المسبق.
هذا الخطأ يشير إلى فشل في البناء على جانب ‏Dokku‏. راجع السجلات التفصيلية بـ ‏dokku logs my-app‏.

التطبيق يرجع ‏502 Bad Gateway‏.
تحقق من حالة العملية: ‏dokku ps:report my-app‏. السبب الشائع: التطبيق لا يستمع على المنفذ المعلن في ‏Procfile‏.

فشل ‏letsencrypt:enable‏ — انتهاء مهلة تحدي ‏HTTP-01‏.
يتطلب تحدي ‏ACME‏ أن يُحلّ النطاق إلى ‏IP‏ الخادم قبل التفعيل. تحقق من انتشار ‏DNS‏: ‏dig +short my-app.your-domain.com‏.

قتل البناء من قِبل النواة (‏OOM‏) — ‏Killed‏.
تدخّل ‏OOM killer‏ بسبب نقص الذاكرة. أضِف ‏swap‏ أو انتقل إلى خادم ‏VPS‏ بـ 2 غيغابايت من ‏RAM‏.

يغطي ‏Dokku‏ نشر تطبيقات ذات حاوية واحدة على خادم ‏VPS‏. إذا تطوّرت بنيتك نحو خدمات متعددة مترابطة، تكمّل عدة بدائل من نفس الفصيلة هذا النهج: ‏CapRover‏ يضيف واجهة رسومية ووضع ‏Docker Swarm‏ متعدد العقد. ‏Easypanel‏ يبسّط إدارة الخدمات المتعددة مع ‏Nixpacks‏ وسوق تطبيقات. لكل هذه الأدوات تعمل على خادم ‏VPS Cloud‏ من ‏ServOrbit‏ بنظام ‏Ubuntu LTS‏.