Utvecklare

Installationsskript för självhostad GitHub Actions-runner

Ange ditt repository och dina etiketter så får du ett skript som installerar runnern under en egen användare och startar den som tjänst. Token anger du på din server, inte här.

Körs helt i din webbläsare — inget av det du skriver skickas till våra servrar.

URL till repository eller organisationByt ut exemplet mot din egen adress. För en runner för hela organisationen behåller du bara organisationen.

Runnerns namnEtiketter, separerade med kommaLinux-användare

Installera Docker för jobb som behöver det

Endast för privata repositories. I ett publikt kan en pull request från en fork köra kod på din server.

Installationsskript

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

Rad till ditt workflow

runs-on: [self-hosted, vps]

Så kör du det

Öppna Settings → Actions → Runners → New self-hosted runner på GitHub och kopiera token.
Kopiera skriptet till din Debian- eller Ubuntu-server och kör det som root: bash install-runner.sh.
Klistra in token när skriptet frågar. Den stannar på din server och går aldrig via den här sidan.
Lägg in raden runs-on i ditt workflow.

Steg-för-steg-guide: självhostad runner på en VPS

Behöver du en server till din runner? Planen Small: 4 vCPU, 4 GB RAM, root-åtkomst, 8 $ i månaden.

Planen Small

Så fungerar det

En självhostad runner arbetar på din egen maskin: den ansluter själv till GitHub, hämtar jobb och kör dem där. Skriptet installerar de paket som behövs, skapar en separat Linux-användare, laddar ner den senaste runner-versionen, registrerar den och sätter upp en systemd-tjänst som klarar omstarter. Skriptet byggs i din webbläsare, så läs varje rad innan du kör det. Servern behöver bara utgående åtkomst till GitHub, ingen dedikerad IP krävs.

Vanliga frågor

Var hittar jag registreringstoken?

Öppna Settings → Actions → Runners → New self-hosted runner i ditt repository. Token gäller i en timme. För en runner för hela organisationen använder du samma väg i organisationens inställningar.

Kan jag använda en självhostad runner med ett publikt repository?

GitHub avråder från det: en pull request från en fork kan köra kod på din server. Använd självhostade runners med privata repositories.

Behöver servern en dedikerad IP?

Nej. Runnern öppnar bara utgående anslutningar till GitHub, så en plan utan dedikerad IP fungerar. När det gäller kraft räcker 4 vCPU och 4 GB RAM för de flesta projekt.

Liknande verktyg

b64

Base64-kodare/avkodare

Text och filer till Base64 och tillbaka, URL-säkert alternativ.

UUID-generator

UUID v4 och tidsordnade v7, i mängd.

*/5

Cron-hjälpen

Förklara en crontab-rad och visa nästa körningar.

Аa

Translitterering

Kyrilliska till latin: passnormer och URL-sluggar.

Alla verktyg →