Розробнику

Скрипт встановлення self-hosted раннера GitHub Actions

Вкажіть репозиторій і мітки та отримайте скрипт: він встановить раннер під окремим користувачем і запустить його як сервіс. Токен ви вводите на своєму сервері, а не тут.

Працює повністю в браузері — нічого з уведеного не надсилається на наші сервери.

Адреса репозиторію або організаціїЗамініть приклад на свою адресу. Для раннера на всю організацію залиште лише організацію.

Ім'я раннераМітки через комуКористувач Linux

Встановити Docker для завдань, яким він потрібен

Лише для приватних репозиторіїв. У публічному 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.

Покроковий гайд: self-hosted раннер на VPS

Потрібен сервер під раннер? Тариф Small: 4 vCPU, 4 ГБ, root-доступ, $8 на місяць.

Тариф Small

Як це працює

Self-hosted раннер працює на вашій машині: сам підключається до GitHub, забирає завдання й виконує їх у вас. Скрипт встановлює потрібні пакети, створює окремого користувача Linux, завантажує останній випуск раннера, реєструє його й налаштовує сервіс systemd, який переживає перезавантаження. Скрипт збирається в браузері, тож прочитайте кожен рядок перед запуском. Серверу потрібен лише вихідний доступ до GitHub, виділений IP не потрібен.

Питання й відповіді

Де взяти токен реєстрації?

У репозиторії відкрийте Settings → Actions → Runners → New self-hosted runner. Токен діє одну годину. Для раннера на всю організацію шлях той самий, але в налаштуваннях організації.

Чи можна використовувати self-hosted раннер із публічним репозиторієм?

GitHub не радить: pull request із форка може виконати код на вашому сервері. Використовуйте self-hosted раннери з приватними репозиторіями.

Чи потрібен серверу виділений IP?

Ні. Раннер сам підключається до GitHub, вхідні з'єднання йому не потрібні, тому підійде тариф без виділеного IP. За потужністю більшості проєктів вистачає 4 vCPU і 4 ГБ пам'яті.

Схожі інструменти

b64

Base64 кодер/декодер

Текст і файли в Base64 і назад, варіант URL-safe.

Генератор UUID

UUID v4 і впорядковані за часом v7, пачкою.

*/5

Помічник із cron

Розбір рядка crontab і найближчі запуски.

Аa

Транслітерація

Кирилиця латиницею: паспортні стандарти та URL-slug.

Усі інструменти →