開発者向け

セルフホスト GitHub Actions ランナーの導入スクリプト

リポジトリとラベルを入力すると、専用ユーザーでランナーを導入してサービスとして起動するスクリプトが得られます。トークンはここではなく、サーバー上で入力します。

すべてブラウザ内で動作します。入力した内容が当社のサーバーに送られることはありません。

リポジトリまたは組織の URL例を自分のアドレスに置き換えてください。組織全体のランナーの場合は、組織名までにします。

ランナー名ラベル（カンマ区切り）Linux ユーザー

必要なジョブのために Docker を導入する

プライベートリポジトリ専用です。パブリックでは、フォークからの 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 でセルフホストランナーを動かす

ランナー用のサーバーが必要ですか？Small プラン：4 vCPU、RAM 4 GB、root 権限、月額 8 ドル。

Small プラン

しくみ

セルフホストランナーはあなた自身のマシンで動きます。自分から GitHub に接続し、ジョブを受け取ってその場で実行します。スクリプトは必要なパッケージを入れ、専用の Linux ユーザーを作成し、最新のランナーをダウンロードして登録し、再起動後も動き続ける systemd サービスを設定します。スクリプトはブラウザー内で作られるので、実行前にすべての行を確認してください。サーバーに必要なのは GitHub への送信方向のアクセスだけで、専用 IP は不要です。

よくある質問

登録トークンはどこで取得できますか？

リポジトリで Settings → Actions → Runners → New self-hosted runner を開きます。トークンの有効期間は 1 時間です。組織全体のランナーの場合は、組織の設定で同じ手順をたどります。

セルフホストランナーをパブリックリポジトリで使えますか？

GitHub は推奨していません。フォークからの pull request があなたのサーバーでコードを実行する可能性があります。セルフホストランナーはプライベートリポジトリで使ってください。

サーバーに専用 IP は必要ですか？

いいえ。ランナーは GitHub への送信接続を開くだけなので、専用 IP のないプランで動きます。性能面では、多くのプロジェクトは 4 vCPU と RAM 4 GB で足ります。

セルフホスト GitHub Actions ランナーの導入スクリプト

実行手順

しくみ

よくある質問

関連ツール