Lập trình viên

Script cài đặt runner GitHub Actions tự host

Nhập repository và nhãn để nhận script cài runner dưới một người dùng riêng và chạy nó như dịch vụ. Bạn nhập token trên máy chủ của mình, không phải ở đây.

Chạy hoàn toàn trong trình duyệt của bạn — không có dữ liệu nào bạn nhập được gửi tới máy chủ của chúng tôi.

URL của repository hoặc tổ chứcThay ví dụ bằng địa chỉ của bạn. Với runner cho cả tổ chức, chỉ giữ lại tên tổ chức.

Tên runnerNhãn, cách nhau bằng dấu phẩyNgười dùng Linux

Cài Docker cho các job cần đến nó

Chỉ dành cho repository riêng tư. Với repository công khai, pull request từ một fork có thể chạy mã trên máy chủ của bạn.

Script cài đặt

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

Dòng cho workflow của bạn

runs-on: [self-hosted, vps]

Cách chạy

Trên GitHub, mở Settings → Actions → Runners → New self-hosted runner và sao chép token.
Sao chép script lên máy chủ Debian hoặc Ubuntu và chạy bằng root: bash install-runner.sh.
Dán token khi script yêu cầu. Token nằm trên máy chủ của bạn và không bao giờ đi qua trang này.
Thêm dòng runs-on vào workflow của bạn.

Hướng dẫn từng bước: runner tự host trên VPS

Cần máy chủ cho runner? Gói Small: 4 vCPU, 4 GB RAM, quyền root, 8 $/tháng.

Gói Small

Cách hoạt động

Runner tự host hoạt động trên máy của bạn: nó tự kết nối tới GitHub, nhận job và chạy ngay tại đó. Script cài các gói cần thiết, tạo người dùng Linux riêng, tải bản runner mới nhất, đăng ký và thiết lập dịch vụ systemd vẫn chạy sau khi khởi động lại. Script được tạo trong trình duyệt của bạn, nên hãy đọc từng dòng trước khi chạy. Máy chủ chỉ cần truy cập chiều ra tới GitHub, không cần IP riêng.

Câu hỏi thường gặp

Lấy token đăng ký ở đâu?

Trong repository, mở Settings → Actions → Runners → New self-hosted runner. Token có hiệu lực một giờ. Với runner cho cả tổ chức, đi theo cùng đường dẫn trong phần cài đặt của tổ chức.

Có thể dùng runner tự host với repository công khai không?

GitHub khuyên không nên: pull request từ một fork có thể chạy mã trên máy chủ của bạn. Hãy dùng runner tự host với repository riêng tư.

Máy chủ có cần IP riêng không?

Không. Runner chỉ mở kết nối chiều ra tới GitHub, nên gói không có IP riêng là đủ. Về cấu hình, 4 vCPU và 4 GB RAM đủ cho phần lớn dự án.

Công cụ liên quan

b64

Mã hóa/giải mã Base64

Văn bản và tệp sang Base64 và ngược lại, có chế độ URL-safe.

Trình tạo UUID

UUID v4 và v7 sắp xếp theo thời gian, tạo hàng loạt.

*/5

Trợ giúp cron

Giải thích dòng crontab và hiển thị các lần chạy tiếp theo.

Аa

Chuyển tự

Chữ Kirin sang Latin: chuẩn hộ chiếu và slug URL.

Tất cả công cụ →