Entwickler

Installationsskript für selbstgehostete GitHub-Actions-Runner

Gib dein Repository und die Labels an und erhalte ein Skript, das den Runner unter einem eigenen Benutzer installiert und als Dienst startet. Den Token gibst du auf deinem Server ein, nicht hier.

Läuft komplett in deinem Browser – nichts von deinen Eingaben wird an unsere Server gesendet.

URL des Repositorys oder der OrganisationErsetze das Beispiel durch deine eigene Adresse. Für einen Runner der ganzen Organisation lass nur die Organisation stehen.

Name des RunnersLabels, durch Kommas getrenntLinux-Benutzer

Docker für Jobs installieren, die es brauchen

Nur für private Repositories. In einem öffentlichen kann ein Pull Request aus einem Fork Code auf deinem Server ausführen.

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

Zeile für deinen Workflow

runs-on: [self-hosted, vps]

So startest du es

Öffne auf GitHub Settings → Actions → Runners → New self-hosted runner und kopiere den Token.
Kopiere das Skript auf deinen Debian- oder Ubuntu-Server und starte es als root: bash install-runner.sh.
Füge den Token ein, wenn das Skript danach fragt. Er bleibt auf deinem Server und läuft nie über diese Seite.
Füge die Zeile runs-on in deinen Workflow ein.

Schritt-für-Schritt-Anleitung: selbstgehosteter Runner auf einem VPS

Brauchst du einen Server für den Runner? Tarif Small: 4 vCPU, 4 GB RAM, Root-Zugang, 8 $ im Monat.

Tarif Small

So funktioniert es

Ein selbstgehosteter Runner läuft auf deiner eigenen Maschine: Er verbindet sich selbst mit GitHub, holt Jobs ab und führt sie dort aus. Das Skript installiert die nötigen Pakete, legt einen eigenen Linux-Benutzer an, lädt die neueste Runner-Version herunter, registriert sie und richtet einen systemd-Dienst ein, der Neustarts übersteht. Das Skript entsteht in deinem Browser, lies also jede Zeile, bevor du es startest. Der Server braucht nur ausgehenden Zugang zu GitHub, eine dedizierte IP ist nicht nötig.

Häufige Fragen

Woher bekomme ich den Registrierungstoken?

Öffne in deinem Repository Settings → Actions → Runners → New self-hosted runner. Der Token gilt eine Stunde. Für einen Runner der ganzen Organisation nimmst du denselben Weg in den Einstellungen der Organisation.

Kann ich einen selbstgehosteten Runner mit einem öffentlichen Repository nutzen?

GitHub rät davon ab: Ein Pull Request aus einem Fork kann Code auf deinem Server ausführen. Nutze selbstgehostete Runner mit privaten Repositories.

Braucht der Server eine dedizierte IP?

Nein. Der Runner baut nur ausgehende Verbindungen zu GitHub auf, daher reicht ein Tarif ohne dedizierte IP. Bei der Leistung genügen den meisten Projekten 4 vCPU und 4 GB RAM.

Installationsskript für selbstgehostete GitHub-Actions-Runner

So startest du es

So funktioniert es

Häufige Fragen

Ähnliche Tools