Developer

Skrip instalasi runner GitHub Actions swakelola

Isi repositori dan label Anda untuk mendapatkan skrip yang memasang runner dengan pengguna tersendiri dan menjalankannya sebagai layanan. Token dimasukkan di server Anda, bukan di sini.

Berjalan sepenuhnya di browser Anda — tidak ada yang Anda masukkan dikirim ke server kami.

URL repositori atau organisasiGanti contoh dengan alamat Anda sendiri. Untuk runner seluruh organisasi, sisakan organisasinya saja.

Nama runnerLabel, dipisahkan komaPengguna Linux

Pasang Docker untuk job yang memerlukannya

Hanya untuk repositori privat. Di repositori publik, pull request dari fork dapat menjalankan kode di server Anda.

Skrip instalasi

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

Baris untuk workflow Anda

runs-on: [self-hosted, vps]

Cara menjalankan

Di GitHub buka Settings → Actions → Runners → New self-hosted runner lalu salin token.
Salin skrip ke server Debian atau Ubuntu Anda dan jalankan sebagai root: bash install-runner.sh.
Tempel token saat skrip memintanya. Token tetap di server Anda dan tidak pernah melewati halaman ini.
Masukkan baris runs-on ke workflow Anda.

Panduan langkah demi langkah: runner swakelola di VPS

Perlu server untuk runner? Paket Small: 4 vCPU, 4 GB RAM, akses root, $8/bulan.

Paket Small

Cara kerjanya

Runner swakelola bekerja di mesin Anda sendiri: ia terhubung ke GitHub, mengambil job, dan menjalankannya di sana. Skrip ini memasang paket yang diperlukan, membuat pengguna Linux tersendiri, mengunduh rilis runner terbaru, mendaftarkannya, dan menyiapkan layanan systemd yang tetap berjalan setelah reboot. Skrip dibuat di browser Anda, jadi baca setiap barisnya sebelum menjalankan. Server hanya perlu akses keluar ke GitHub, IP khusus tidak diperlukan.

Pertanyaan umum

Di mana saya mendapatkan token pendaftaran?

Di repositori Anda, buka Settings → Actions → Runners → New self-hosted runner. Token berlaku satu jam. Untuk runner seluruh organisasi, ikuti jalur yang sama di pengaturan organisasi.

Bisakah runner swakelola dipakai dengan repositori publik?

GitHub tidak menyarankannya: pull request dari fork dapat menjalankan kode di server Anda. Gunakan runner swakelola dengan repositori privat.

Apakah server memerlukan IP khusus?

Tidak. Runner hanya membuka koneksi keluar ke GitHub, jadi paket tanpa IP khusus sudah cukup. Soal daya, 4 vCPU dan 4 GB RAM cukup untuk sebagian besar proyek.

Alat terkait

b64

Encoder/decoder Base64

Teks dan file ke Base64 dan sebaliknya, opsi URL-safe.

Generator UUID

UUID v4 dan v7 berurutan waktu, sekaligus banyak.

*/5

Bantuan cron

Menjelaskan baris crontab dan menampilkan jadwal berikutnya.

Аa

Transliterasi

Sirilik ke Latin: standar paspor dan slug URL.

Semua alat →