開發者

自託管 GitHub Actions runner 安裝腳本

填寫儲存庫和標籤，取得一個腳本：它以獨立使用者安裝 runner，並作為服務啟動。權杖在您的伺服器上輸入，不在這裡。

完全在瀏覽器中執行——您輸入的任何內容都不會傳送到我們的伺服器。

儲存庫或組織的網址把範例換成您自己的網址。如果是整個組織共用的 runner，只保留組織。

runner 名稱標籤，以逗號分隔Linux 使用者

為需要的工作安裝 Docker

僅限私人儲存庫。在公開儲存庫中，來自 fork 的 pull request 可能在您的伺服器上執行程式碼。

安裝腳本

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

逐步指南：在 VPS 上執行自託管 runner

需要一台跑 runner 的伺服器？Small 方案：4 vCPU、4 GB 記憶體、root 權限，每月 8 美元。

Small 方案

運作方式

自託管 runner 執行在您自己的機器上：它主動連線到 GitHub，領取工作並在本機執行。腳本會安裝所需的套件，建立獨立的 Linux 使用者，下載最新版 runner 並完成註冊，再設定一個重新開機後仍會執行的 systemd 服務。腳本在您的瀏覽器中產生，執行前請逐行讀過。伺服器只需要能對外連線到 GitHub，不需要獨立 IP。

常見問題

註冊權杖要從哪裡取得？

在儲存庫中開啟 Settings → Actions → Runners → New self-hosted runner。權杖有效期為一小時。如果是整個組織共用的 runner，在組織設定裡走同樣的路徑。

自託管 runner 可以用於公開儲存庫嗎？

GitHub 不建議這樣做：來自 fork 的 pull request 可能在您的伺服器上執行程式碼。請把自託管 runner 用於私人儲存庫。

伺服器需要獨立 IP 嗎？

不需要。runner 只會對外連線到 GitHub，所以沒有獨立 IP 的方案就夠用。至於效能，4 vCPU 和 4 GB 記憶體能滿足大多數專案。

自託管 GitHub Actions runner 安裝腳本

如何執行

運作方式

常見問題

相關工具