توسعه‌دهنده

اسکریپت نصب runner خودمیزبان برای GitHub Actions

Q: آیا میتوانم runner خودمیزبان را با مخزن عمومی استفاده کنم؟

GitHub توصیه نمیکند: یک pull request از fork میتواند روی سرور شما کد اجرا کند. runner خودمیزبان را با مخزنهای خصوصی به کار ببرید.

Q: آیا سرور به IP اختصاصی نیاز دارد؟

نه. runner فقط اتصال خروجی به GitHub باز میکند، پس پلن بدون IP اختصاصی کافی است. از نظر توان، ⁦4 vCPU⁩ و ⁦4 GB RAM⁩ برای بیشتر پروژهها کافی است.

مخزن و برچسب‌ها را وارد کنید و اسکریپتی بگیرید که 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.

همه ابزارها →