Udvikler

Installationsscript til selv-hostet GitHub Actions-runner

Angiv dit repository og dine labels, og få et script, der installerer runneren under sin egen bruger og starter den som tjeneste. Tokenet indtaster du på din server, ikke her.

Kører helt i din browser — intet af det, du indtaster, sendes til vores servere.

URL til repository eller organisationErstat eksemplet med din egen adresse. For en runner til hele organisationen beholder du kun organisationen.

Runnerens navnLabels, adskilt af kommaLinux-bruger

Installer Docker til job, der har brug for det

Kun til private repositories. I et offentligt kan en pull request fra en fork køre kode på din server.

Installationsscript

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

Linje til dit workflow

runs-on: [self-hosted, vps]

Sådan kører du det

Åbn Settings → Actions → Runners → New self-hosted runner på GitHub, og kopiér tokenet.
Kopiér scriptet til din Debian- eller Ubuntu-server, og kør det som root: bash install-runner.sh.
Indsæt tokenet, når scriptet beder om det. Det bliver på din server og går aldrig gennem denne side.
Sæt linjen runs-on ind i dit workflow.

Trin-for-trin-guide: selv-hostet runner på en VPS

Har du brug for en server til din runner? Planen Small: 4 vCPU, 4 GB RAM, root-adgang, 8 $ om måneden.

Planen Small

Sådan virker det

En selv-hostet runner arbejder på din egen maskine: den forbinder selv til GitHub, henter job og kører dem der. Scriptet installerer de nødvendige pakker, opretter en separat Linux-bruger, henter den nyeste runner-version, registrerer den og sætter en systemd-tjeneste op, der overlever genstarter. Scriptet bygges i din browser, så læs hver linje, før du kører det. Serveren behøver kun udgående adgang til GitHub, der kræves ingen dedikeret IP.

Ofte stillede spørgsmål

Hvor får jeg registreringstokenet fra?

Åbn Settings → Actions → Runners → New self-hosted runner i dit repository. Tokenet gælder i en time. For en runner til hele organisationen følger du samme vej i organisationens indstillinger.

Kan jeg bruge en selv-hostet runner med et offentligt repository?

GitHub fraråder det: en pull request fra en fork kan køre kode på din server. Brug selv-hostede runnere med private repositories.

Skal serveren have en dedikeret IP?

Nej. Runneren åbner kun udgående forbindelser til GitHub, så en plan uden dedikeret IP er fin. Hvad angår kraft, er 4 vCPU og 4 GB RAM nok til de fleste projekter.

Lignende værktøjer

b64

Base64-koder/dekoder

Tekst og filer til Base64 og tilbage, URL-sikker variant.

UUID-generator

UUID v4 og tidsordnede v7, i stor mængde.

*/5

Cron-hjælper

Forklar en crontab-linje og vis de næste kørsler.

Аa

Translitteration

Kyrillisk til latin: pasnormer og URL-slugs.

Alle værktøjer →