开发者

自托管 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 安装脚本

如何运行

工作原理

常见问题

相关工具