Dla programistów

Skrypt instalacji samodzielnie hostowanego runnera GitHub Actions

Podaj repozytorium i etykiety, a dostaniesz skrypt, który zainstaluje runner na osobnym użytkowniku i uruchomi go jako usługę. Token wpisujesz na swoim serwerze, nie tutaj.

Działa w całości w przeglądarce — nic z tego, co wpiszesz, nie trafia na nasze serwery.

Adres repozytorium lub organizacjiZastąp przykład swoim adresem. Dla runnera całej organizacji zostaw tylko organizację.

Nazwa runneraEtykiety, rozdzielone przecinkamiUżytkownik Linuksa

Zainstaluj Dockera dla zadań, które go potrzebują

Tylko dla prywatnych repozytoriów. W publicznym pull request z forka może uruchomić kod na Twoim serwerze.

Skrypt instalacji

#!/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

Linia do Twojego workflow

runs-on: [self-hosted, vps]

Jak uruchomić

Na GitHubie otwórz Settings → Actions → Runners → New self-hosted runner i skopiuj token.
Skopiuj skrypt na serwer z Debianem lub Ubuntu i uruchom jako root: bash install-runner.sh.
Wklej token, gdy skrypt o niego poprosi. Zostaje na Twoim serwerze i nigdy nie przechodzi przez tę stronę.
Wstaw linię runs-on do swojego workflow.

Przewodnik krok po kroku: samodzielnie hostowany runner na VPS

Potrzebujesz serwera na runner? Plan Small: 4 vCPU, 4 GB RAM, dostęp root, 8 $ miesięcznie.

Plan Small

Jak to działa

Samodzielnie hostowany runner działa na Twojej maszynie: sam łączy się z GitHubem, pobiera zadania i tam je wykonuje. Skrypt instaluje potrzebne pakiety, tworzy osobnego użytkownika Linuksa, pobiera najnowsze wydanie runnera, rejestruje go i konfiguruje usługę systemd, która przetrwa restarty. Skrypt powstaje w Twojej przeglądarce, więc przeczytaj każdą linię przed uruchomieniem. Serwer potrzebuje tylko dostępu wychodzącego do GitHuba, dedykowane IP nie jest wymagane.

Pytania i odpowiedzi

Skąd wziąć token rejestracyjny?

W repozytorium otwórz Settings → Actions → Runners → New self-hosted runner. Token jest ważny przez godzinę. Dla runnera całej organizacji ścieżka jest ta sama, ale w ustawieniach organizacji.

Czy mogę używać samodzielnie hostowanego runnera z publicznym repozytorium?

GitHub to odradza: pull request z forka może uruchomić kod na Twoim serwerze. Używaj takich runnerów z prywatnymi repozytoriami.

Czy serwer potrzebuje dedykowanego IP?

Nie. Runner nawiązuje tylko połączenia wychodzące do GitHuba, więc wystarczy plan bez dedykowanego IP. Jeśli chodzi o moc, większości projektów wystarczą 4 vCPU i 4 GB RAM.

Podobne narzędzia

b64

Koder/dekoder Base64

Tekst i pliki do Base64 i z powrotem, wariant URL-safe.

Generator UUID

UUID v4 i uporządkowane czasowo v7, hurtowo.

*/5

Pomocnik cron

Objaśnia wiersz crontab i pokazuje najbliższe uruchomienia.

Аa

Transliteracja

Cyrylica na łacinkę: standardy paszportowe i slug URL.

Wszystkie narzędzia →