پراختیاکوونکي

د ځان-کوربه شوي GitHub Actions runner د نصب سکریپټ

خپله زېرمه او لیبلونه ولیکئ او داسې سکریپټ ترلاسه کړئ چې runner د جلا کارن لاندې نصبوي او د خدمت په توګه یې پیلوي. ټوکن په خپل سرور ورکوئ، نه دلته.

په بشپړ ډول ستاسو په براوزر کې چلېږي — هغه څه چې تاسو یې ولیکئ زموږ سرورونو ته نه لېږل کېږي.

د زېرمې یا سازمان URLبېلګه په خپل پته بدله کړئ. د ټول سازمان runner لپاره یوازې سازمان پرېږدئ.

د runner نوملیبلونه، په کامه جلاد Linux کارن

د هغو کارونو لپاره Docker نصب کړئ چې ورته اړتیا لري

یوازې د خصوصي زېرمو لپاره. په عامه زېرمه کې له fork څخه راغلی pull request ستاسو په سرور کوډ چلولی شي.

د نصب سکریپټ

#!/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 ته وتونکي لاسرسي ته اړتیا لري، Dedicated IP ته اړتیا نشته.

عامې پوښتنې

د ثبت ټوکن له کومه ترلاسه کړم؟

په خپله زېرمه کې ⁦Settings → Actions → Runners → New self-hosted runner⁩ پرانیزئ. ټوکن یو ساعت اعتبار لري. د ټول سازمان runner لپاره همدا لار د سازمان په تنظیماتو کې تعقیب کړئ.

ایا ځان-کوربه شوی runner له عامې زېرمې سره کارولی شم؟

GitHub یې نه وړاندیز کوي: له fork څخه راغلی pull request ستاسو په سرور کوډ چلولی شي. ځان-کوربه شوي runnerونه له خصوصي زېرمو سره وکاروئ.

ایا سرور Dedicated IP ته اړتیا لري؟

نه. Runner یوازې GitHub ته وتونکي اتصالونه پرانیزي، نو پرته له Dedicated IP پلان بس دی. د ځواک له پلوه ډېرو پروژو ته ⁦4 vCPU⁩ او ⁦4 GB RAM⁩ بس دي.

اړوند اوزار

b64

Base64 کوډګر/ډیکوډر

متن او فایلونه Base64 ته او بېرته، د URL-safe اختیار سره.

UUID جوړوونکی

UUID v4 او د وخت له مخې ترتیب شوي v7، په ډله‌ییز ډول.

*/5

د Cron مرستیال

د crontab کرښه تشریح کوي او راتلونکي اجرا ګانې ښيي.

Аa

لیک‌اړونه

له سیریلیک څخه لاتین ته: د پاسپورټ معیارونه او URL slug.

ټول اوزار →