هل يمكنني تشغيل الـ runner داخل Docker؟

نعم. شغّل صورة الـ runner الرسمية (أو صورتك) داخل حاوية، أو استخدمها لإعطاء كل مهمة بيئة معزولة تُستهلك مرة واحدة. لا حاجة إلى IP مخصّص — الـ runner يجري اتصالات صادرة إلى GitHub فقط، لذا تكفي خطة NAT.

كيف أُبقي الـ runner يعمل كخدمة؟

يأتي الـ runner مع سكربت مساعد svc.sh يثبّت وحدة systemd: ./svc.sh install && ./svc.sh start. بعدها يصمد أمام إعادة التشغيل ويُعاد تشغيله عند الفشل. الأوامر الدقيقة في الدليل أدناه.

هل الـ runner ذاتي الاستضافة أرخص من دقائق GitHub المستضافة؟

للـ CI الثقيل أو المتكرر، نعم. runner المستضاف من GitHub يُحاسب بالدقيقة فوق الحصة المجانية؛ بينما VPS بـ 8$ شهريًا يشغّل دقائق غير محدودة برسم ثابت ويبقى «دافئًا» (بلا بدء بارد، مع اعتماديات مخزّنة). مستودع نشط واحد عادةً يغطّي ثمن الجهاز.

هل تطلبون هوية أو بطاقة ائتمان؟

لا. التسجيل بالبريد الإلكتروني، والدفع بـ USDC أو USDT. بلا مستندات، بلا بطاقة، ولا KYC أبدًا.

VPS لتشغيل runner GitHub Actions ذاتي الاستضافة

Q: كيف أشغّل runner ذاتي الاستضافة لـ GitHub Actions على VPS؟

جهّز VPS بنظام Linux (خطة Small — 4 vCPU / 4 GB — هي الافتراضي المعقول)، ثبّت حزمة الـ runner من Settings → Actions → Runners في مستودعك، وسجّله بالرمز الذي يوفّره GitHub، ثم شغّله كخدمة. الخطوات الكاملة للنسخ واللصق في الأسفل؛ تحصل على root خلال دقيقة تقريبًا.

شغّل runner ذاتي الاستضافة لـ GitHub Actions على VPS خاص بك — CI أسرع، بلا فوترة بالدقيقة، تحكّم كامل في بيئة البناء. الدفع بالعملات المشفّرة، بلا KYC. من 8$ شهريًا.

runner المستضاف من GitHub مريح حتى تبدأ الفاتورة أو وقت الانتظار في الإيلام. فوق الحصة المجانية تدفع بالدقيقة، وكل مهمة تبدأ «باردة» وتعيد تنزيل الاعتماديات في كل تشغيل. runner ذاتي الاستضافة على VPS خاص بك يقلب النقاط الثلاث: تكلفة شهرية ثابتة، وجهاز «دافئ» بذاكرتك المؤقتة موجودة أصلًا على القرص، وبيئة بناء تتحكم بها بالكامل — إصدارات أدوات محدّدة، ذاكرة RAM أكبر، وذاكرة تخزين مؤقت لطبقات Docker تبقى فعلًا.

الـ runner يحتاج فقط للوصول الصادر إلى GitHub، لذا يعمل على أرخص خططنا، ويُدفع بالعملات المشفّرة، ولا يتطلّب KYC.

ماذا يحتاج الـ runner

معالج وذاكرة لبناءاتك. Small (8$ شهريًا — 4 vCPU، 4 GB RAM، 35 GB NVMe) هو الافتراضي المريح لمعظم الـ CI: بناءات Node/Go/Rust، مجموعات الاختبار، بناء صور Docker. تجميع ثقيل أو مهام متوازية؟ ارتقِ إلى Medium أو خطة Pro.
قرص NVMe للتخزين المؤقت. جوهر الاستضافة الذاتية هو الاستمرارية — ذاكرة اعتماديات مؤقتة، وطبقات Docker، ومخرجات بناء تبقى على القرص بين التشغيلات. NVMe يبقي الاستعادة سريعة.
لا حاجة إلى IP مخصّص. الـ runner يتصل بـ GitHub عبر HTTPS؛ لا يلزم وصول وارد. تكفي خطة NAT (من 3$ شهريًا). خذ IP مخصّصًا فقط إن كنت تستضيف أيضًا شيئًا يقدّم حركة مرور.

إعداد runner (Ubuntu 24.04)

أنشئ الـ runner في مستودعك (أو منظمتك): Settings → Actions → Runners → New self-hosted runner → Linux. يعرض GitHub أمر تنزيل ورمز تسجيل يُستخدم مرة واحدة. على الـ VPS:

# كمستخدم غير root (الـ runner يرفض العمل كـ root)
adduser --disabled-password --gecos "" runner
su - runner

mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64.tar.gz -L \
  https://github.com/actions/runner/releases/latest/download/actions-runner-linux-x64.tar.gz
tar xzf actions-runner-linux-x64.tar.gz

# سجّل بالـ URL + الرمز من واجهة GitHub
./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN

إبقاؤه يعمل كخدمة

لا تشغّل ./run.sh في الطرفية — ثبّت الـ runner كخدمة systemd ليصمد أمام إعادة التشغيل:

sudo ./svc.sh install runner
sudo ./svc.sh start
sudo ./svc.sh status

يظهر الـ runner الآن كـ Idle في واجهة GitHub ويلتقط أي مهمة تستهدفه.

الاستخدام من workflow

وجّه مهمة إلى الـ runner عبر runs-on:

jobs:
  build:
    runs-on: self-hosted        # أو تسمية مخصّصة تضبطها عند التسجيل
    steps:
      - uses: actions/checkout@v4
      - run: make build && make test

مهام قائمة على Docker

ثبّت Docker مرة واحدة، وستتمكّن workflows من بناء الصور أو تشغيل حاويات الخدمة، مع بقاء ذاكرة الطبقات المؤقتة بين التشغيلات:

sudo apt update && sudo apt install -y docker.io
sudo usermod -aG docker runner   # اسمح للـ runner باستخدام Docker بدون sudo

لعزل يُستهلك مرة واحدة لكل مهمة، شغّل الـ runner نفسه داخل حاوية وأعد إنشاءه في كل تشغيل — نمط شائع للبناءات غير الموثوقة أو المصفوفية.

لماذا EQVPS للـ CI

تكلفة ثابتة، دقائق غير محدودة. لا قياس بالدقيقة — خط أنابيب مزدحم يكلّف مثل الخامل.
ذاكرة تخزين مؤقت «دافئة». الاعتماديات وطبقات Docker تبقى على NVMe بين التشغيلات؛ البناءات تتسارع لا تتباطأ.
root خلال ~60 ثانية، صور نظيفة. Ubuntu وDebian وغيرها عبر cloud-init؛ ثبّت سلسلة الأدوات التي تحتاجها بالضبط.
بلا KYC، الدفع بالعملات المشفّرة. بريد للتسجيل، وUSDC/USDT للدفع. شغّل runners إضافية لذروات الإصدار ثم ألغِها لاحقًا — الوقت المدفوع غير المستخدَم يُعاد إلى رصيدك.

دليل الإعداد الكامل خطوة بخطوة ←