المطورون

سكربت تثبيت runner ذاتي الاستضافة لـ GitHub Actions

أدخل المستودع والتسميات لتحصل على سكربت يثبّت runner تحت مستخدم مستقل ويشغّله كخدمة. تُدخل الرمز المميز على خادمك، لا هنا.

يعمل بالكامل داخل متصفحك — لا يُرسل أي شيء تكتبه إلى خوادمنا.

عنوان المستودع أو المؤسسةاستبدل المثال بعنوانك. ولـ runner على مستوى المؤسسة، أبقِ المؤسسة فقط.

اسم runnerالتسميات، مفصولة بفواصلمستخدم Linux

ثبّت Docker للمهام التي تحتاج إليه

للمستودعات الخاصة فقط. في المستودع العام قد يشغّل pull request من fork شيفرة على خادمك.

سكربت التثبيت

#!/usr/bin/env bash
# Installs a self-hosted GitHub Actions runner as a systemd service (Debian, Ubuntu).
# Run as root: bash install-runner.sh
set -euo pipefail

REPO_URL="https://github.com/your-org/your-repo"
RUNNER_NAME="vps-runner-1"
RUNNER_LABELS="vps"
RUNNER_USER="runner"
RUNNER_DIR="/home/$RUNNER_USER/actions-runner"

[ "$(id -u)" -eq 0 ] || { echo "Run this script as root." >&2; exit 1; }
command -v apt-get >/dev/null || { echo "This script supports Debian and Ubuntu only." >&2; exit 1; }
case "$(uname -m)" in
  x86_64) ARCH=x64 ;;
  aarch64) ARCH=arm64 ;;
  *) echo "Unsupported CPU: $(uname -m)" >&2; exit 1 ;;
esac
[ ! -f "$RUNNER_DIR/.runner" ] || { echo "A runner is already configured in $RUNNER_DIR." >&2; exit 1; }

read -rsp "Registration token from GitHub: " RUNNER_TOKEN; echo
[ -n "$RUNNER_TOKEN" ] || { echo "The token is empty." >&2; exit 1; }

apt-get update -y
apt-get install -y curl tar ca-certificates
id "$RUNNER_USER" >/dev/null 2>&1 || useradd -m -s /bin/bash "$RUNNER_USER"

# Latest runner release
VERSION="$(curl -fsSLI -o /dev/null -w '%{url_effective}' https://github.com/actions/runner/releases/latest | sed 's|.*/tag/v||')"
FILE="actions-runner-linux-$ARCH-$VERSION.tar.gz"
as_runner() { runuser -u "$RUNNER_USER" -- env HOME="/home/$RUNNER_USER" "$@"; }
as_runner mkdir -p "$RUNNER_DIR"
cd "$RUNNER_DIR"
as_runner curl -fsSL -o "$FILE" "https://github.com/actions/runner/releases/download/v$VERSION/$FILE"
as_runner tar xzf "$FILE"
rm -f "$FILE"
./bin/installdependencies.sh

# Register with GitHub and start as a service
as_runner ./config.sh --unattended --url "$REPO_URL" --token "$RUNNER_TOKEN" --name "$RUNNER_NAME" --labels "$RUNNER_LABELS" --replace
./svc.sh install "$RUNNER_USER"
./svc.sh start
./svc.sh status --no-pager

سطر لملف workflow

runs-on: [self-hosted, vps]

طريقة التشغيل

افتح في GitHub ⁦Settings → Actions → Runners → New self-hosted runner⁩ وانسخ الرمز.
انسخ السكربت إلى خادم Debian أو Ubuntu وشغّله بصلاحيات root: ⁦bash install-runner.sh⁩.
الصق الرمز عندما يطلبه السكربت. يبقى على خادمك ولا يمر عبر هذه الصفحة أبدًا.
ضع سطر ⁦runs-on⁩ في ملف workflow.

دليل خطوة بخطوة: runner ذاتي الاستضافة على VPS

تحتاج إلى خادم لتشغيل runner؟ خطة ⁦Small⁩: ⁦4 vCPU⁩، و⁦4 GB RAM⁩، وصلاحيات root، بسعر ‎$8 شهريًا.

خطة Small

كيف تعمل

يعمل runner ذاتي الاستضافة على جهازك: يتصل بـ GitHub بنفسه ويستلم المهام وينفّذها هناك. يثبّت السكربت الحزم اللازمة، وينشئ مستخدم Linux مستقلًا، وينزّل أحدث إصدار من runner، ويسجّله، ويضبط خدمة systemd تستمر بعد إعادة التشغيل. يُنشأ السكربت في متصفحك، لذا اقرأ كل سطر قبل تشغيله. لا يحتاج الخادم إلا إلى وصول صادر إلى GitHub، ولا يلزمه IP مخصّص.

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

من أين أحصل على رمز التسجيل؟

في مستودعك افتح ⁦Settings → Actions → Runners → New self-hosted runner⁩. يبقى الرمز صالحًا لساعة واحدة. ولـ runner على مستوى المؤسسة، اتبع المسار نفسه في إعدادات المؤسسة.

هل يمكن استخدام runner ذاتي الاستضافة مع مستودع عام؟

لا ينصح GitHub بذلك: قد يشغّل pull request من fork شيفرة على خادمك. استخدم هذا النوع من runner مع المستودعات الخاصة.

هل يحتاج الخادم إلى IP مخصّص؟

لا. يفتح runner اتصالات صادرة إلى GitHub فقط، لذا تكفي خطة بلا IP مخصّص. أما من حيث القدرة، فتكفي ⁦4 vCPU⁩ و⁦4 GB RAM⁩ لمعظم المشاريع.

أدوات ذات صلة

b64

ترميز وفك Base64

النصوص والملفات إلى Base64 والعكس، مع وضع URL-safe.

مولد UUID

UUID v4 وv7 المرتّبة زمنيًا، بالجملة.

*/5

مساعد Cron

يشرح سطر crontab ويعرض مواعيد التشغيل التالية.

Аa

النقل الحرفي

من السيريلية إلى اللاتينية: معايير جوازات السفر وURL slug.

كل الأدوات →