นักพัฒนา

สคริปต์ติดตั้ง self-hosted GitHub Actions runner

กรอก repository และ label แล้วรับสคริปต์ที่ติดตั้ง runner ภายใต้ผู้ใช้แยกต่างหากและเริ่มเป็นเซอร์วิส คุณกรอกโทเค็นบนเซิร์ฟเวอร์ของคุณ ไม่ใช่ที่นี่

ทำงานในเบราว์เซอร์ของคุณทั้งหมด — สิ่งที่คุณกรอกจะไม่ถูกส่งไปยังเซิร์ฟเวอร์ของเรา

URL ของ repository หรือองค์กรแทนที่ตัวอย่างด้วยที่อยู่ของคุณ สำหรับ runner ของทั้งองค์กร ให้เหลือเฉพาะชื่อองค์กร

ชื่อ runnerLabel คั่นด้วยจุลภาคผู้ใช้ Linux

ติดตั้ง Docker สำหรับงานที่ต้องใช้

สำหรับ repository ส่วนตัวเท่านั้น ใน repository สาธารณะ pull request จาก fork อาจรันโค้ดบนเซิร์ฟเวอร์ของคุณได้

สคริปต์ติดตั้ง

#!/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 แล้วคัดลอกโทเค็น
คัดลอกสคริปต์ไปยังเซิร์ฟเวอร์ Debian หรือ Ubuntu แล้วรันด้วย root: bash install-runner.sh
วางโทเค็นเมื่อสคริปต์ถาม โทเค็นอยู่บนเซิร์ฟเวอร์ของคุณและไม่ผ่านหน้านี้เลย
ใส่บรรทัด runs-on ลงใน workflow ของคุณ

คู่มือทีละขั้น: self-hosted runner บน VPS

ต้องการเซิร์ฟเวอร์สำหรับ runner? แพ็กเกจ Small: 4 vCPU, RAM 4 GB, สิทธิ์ root, $8/เดือน

แพ็กเกจ Small

ทำงานอย่างไร

Self-hosted runner ทำงานบนเครื่องของคุณเอง: มันเชื่อมต่อกับ GitHub เอง รับงานมาแล้วรันที่นั่น สคริปต์จะติดตั้งแพ็กเกจที่จำเป็น สร้างผู้ใช้ Linux แยกต่างหาก ดาวน์โหลด runner รุ่นล่าสุด ลงทะเบียน และตั้งค่าเซอร์วิส systemd ที่ทำงานต่อหลังรีบูต สคริปต์สร้างขึ้นในเบราว์เซอร์ของคุณ ดังนั้นอ่านทุกบรรทัดก่อนรัน เซิร์ฟเวอร์ต้องการเพียงการเข้าถึงขาออกไปยัง GitHub ไม่จำเป็นต้องมี Dedicated IP

คำถามที่พบบ่อย

จะหาโทเค็นลงทะเบียนได้ที่ไหน?

ใน repository ของคุณเปิด Settings → Actions → Runners → New self-hosted runner โทเค็นมีอายุหนึ่งชั่วโมง สำหรับ runner ของทั้งองค์กร ให้ใช้เส้นทางเดียวกันในการตั้งค่าขององค์กร

ใช้ self-hosted runner กับ repository สาธารณะได้ไหม?

GitHub ไม่แนะนำ: pull request จาก fork อาจรันโค้ดบนเซิร์ฟเวอร์ของคุณได้ ควรใช้ self-hosted runner กับ repository ส่วนตัว

เซิร์ฟเวอร์ต้องมี Dedicated IP ไหม?

ไม่ต้อง Runner เปิดการเชื่อมต่อขาออกไปยัง GitHub เท่านั้น แพ็กเกจที่ไม่มี Dedicated IP จึงใช้ได้ ส่วนกำลังเครื่อง 4 vCPU และ RAM 4 GB เพียงพอสำหรับโปรเจกต์ส่วนใหญ่

เครื่องมือที่เกี่ยวข้อง

b64

เข้ารหัส/ถอดรหัส Base64

ข้อความและไฟล์เป็น Base64 และกลับ มีโหมด URL-safe

สร้าง UUID

UUID v4 และ v7 ที่เรียงตามเวลา สร้างทีละหลายตัว

*/5

ผู้ช่วย Cron

อธิบายบรรทัด crontab และแสดงเวลารันครั้งถัดไป

Аa

ถอดอักษร

ซีริลลิกเป็นละติน: มาตรฐานหนังสือเดินทางและ URL slug

เครื่องมือทั้งหมด →