Разработчику

Скрипт установки 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 ГБ памяти.

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

Как запустить

Как это работает

Вопросы и ответы

Похожие инструменты