Για προγραμματιστές

Script εγκατάστασης self-hosted GitHub Actions runner

Συμπληρώστε το αποθετήριο και τις ετικέτες και πάρτε ένα script που εγκαθιστά τον runner με δικό του χρήστη και τον ξεκινά ως υπηρεσία. Το token το εισάγετε στον server σας, όχι εδώ.

Τρέχει εξ ολοκλήρου στον browser σας — τίποτα από όσα εισάγετε δεν στέλνεται στους servers μας.

URL αποθετηρίου ή οργανισμούΑντικαταστήστε το παράδειγμα με τη δική σας διεύθυνση. Για runner ολόκληρου του οργανισμού κρατήστε μόνο τον οργανισμό.

Όνομα runnerΕτικέτες, χωρισμένες με κόμμαΧρήστης Linux

Εγκατάσταση Docker για εργασίες που το χρειάζονται

Μόνο για ιδιωτικά αποθετήρια. Σε δημόσιο, ένα pull request από fork μπορεί να εκτελέσει κώδικα στον server σας.

Script εγκατάστασης

#!/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 και αντιγράψτε το token.
Αντιγράψτε το script στον server σας με Debian ή Ubuntu και τρέξτε το ως root: bash install-runner.sh.
Επικολλήστε το token όταν το ζητήσει το script. Μένει στον server σας και δεν περνά ποτέ από αυτή τη σελίδα.
Βάλτε τη γραμμή runs-on στο workflow σας.

Οδηγός βήμα προς βήμα: self-hosted runner σε VPS

Χρειάζεστε server για τον runner; Πακέτο Small: 4 vCPU, 4 GB RAM, πρόσβαση root, 8 $ τον μήνα.

Πακέτο Small

Πώς λειτουργεί

Ένας self-hosted runner δουλεύει στο δικό σας μηχάνημα: συνδέεται μόνος του στο GitHub, παίρνει τις εργασίες και τις εκτελεί εκεί. Το script εγκαθιστά τα απαραίτητα πακέτα, δημιουργεί ξεχωριστό χρήστη Linux, κατεβάζει την τελευταία έκδοση του runner, την καταχωρεί και ρυθμίζει υπηρεσία systemd που αντέχει σε επανεκκινήσεις. Το script φτιάχνεται στον browser σας, οπότε διαβάστε κάθε γραμμή πριν το τρέξετε. Ο server χρειάζεται μόνο εξερχόμενη πρόσβαση στο GitHub, δεν απαιτείται αποκλειστικό IP.

Συχνές ερωτήσεις

Πού βρίσκω το token καταχώρησης;

Στο αποθετήριό σας ανοίξτε Settings → Actions → Runners → New self-hosted runner. Το token ισχύει για μία ώρα. Για runner ολόκληρου του οργανισμού ακολουθήστε την ίδια διαδρομή στις ρυθμίσεις του οργανισμού.

Μπορώ να χρησιμοποιήσω self-hosted runner με δημόσιο αποθετήριο;

Το GitHub δεν το συνιστά: ένα pull request από fork μπορεί να εκτελέσει κώδικα στον server σας. Χρησιμοποιήστε self-hosted runners με ιδιωτικά αποθετήρια.

Χρειάζεται ο server αποκλειστικό IP;

Όχι. Ο runner ανοίγει μόνο εξερχόμενες συνδέσεις προς το GitHub, οπότε αρκεί ένα πακέτο χωρίς αποκλειστικό IP. Σε ισχύ, τα 4 vCPU και 4 GB RAM αρκούν για τα περισσότερα έργα.

Σχετικά εργαλεία

b64

Κωδικοποιητής/αποκωδικοποιητής Base64

Κείμενο και αρχεία σε Base64 και πίσω, επιλογή URL-safe.

Γεννήτρια UUID

UUID v4 και χρονικά ταξινομημένα v7, μαζικά.

*/5

Βοηθός cron

Εξηγεί μια γραμμή crontab και δείχνει τις επόμενες εκτελέσεις.

Аa

Μεταγραφή

Κυριλλικά σε λατινικά: πρότυπα διαβατηρίων και URL slugs.

Όλα τα εργαλεία →