За разработчици

Скрипт за инсталиране на self-hosted GitHub Actions runner

Посочете хранилището и етикетите и получете скрипт, който инсталира 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.

Ръководство стъпка по стъпка: self-hosted runner на VPS

Трябва ви сървър за runner? План Small: 4 vCPU, 4 GB RAM, root достъп, 8 $ на месец.

План Small

Как работи

Self-hosted runner работи на вашата машина: сам се свързва с GitHub, взема задачите и ги изпълнява там. Скриптът инсталира нужните пакети, създава отделен Linux потребител, изтегля последната версия на runner, регистрира я и настройва услуга на systemd, която издържа рестартиране. Скриптът се създава в браузъра ви, затова прочетете всеки ред, преди да го стартирате. На сървъра му трябва само изходящ достъп до GitHub, dedicated IP не е необходим.

Често задавани въпроси

Откъде да взема токена за регистрация?

В хранилището отворете Settings → Actions → Runners → New self-hosted runner. Токенът е валиден един час. За runner на цялата организация пътят е същият, но в настройките на организацията.

Мога ли да използвам self-hosted runner с публично хранилище?

GitHub не го препоръчва: pull request от fork може да изпълни код на вашия сървър. Използвайте self-hosted 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.

Всички инструменти →