VPS でセルフホスト型 GitHub Actions ランナーをセットアップする方法

セルフホスト型ランナーは、ウォームキャッシュ付きの定額 CI を提供します——分課金なし、あなたのツールチェーン、あなたのマシン。これは最小限のセットアップ手順です。セルフホストが GitHub ホストの分数に勝る理由や Docker ジョブの詳細は、完全ガイド と GitHub Actions 向け VPS ユースケース を参照してください。

1. 非 root ユーザーを作る（ランナーは root を拒否する）

adduser --disabled-password --gecos "" runner
su - runner

2. ランナーをダウンロードする

GitHub で：Settings → Actions → Runners → New self-hosted runner → Linux。これで正確なダウンロードと一度きりのトークンが得られます。次に：

mkdir actions-runner && cd actions-runner
curl -o actions-runner-linux-x64.tar.gz -L \
  https://github.com/actions/runner/releases/latest/download/actions-runner-linux-x64.tar.gz
tar xzf actions-runner-linux-x64.tar.gz

3. リポジトリに登録する

./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token YOUR_TOKEN

4. サービスとしてインストールする（再起動を生き延びる）

./run.sh をターミナルで実行しないこと——インストールします：

sudo ./svc.sh install runner
sudo ./svc.sh start
sudo ./svc.sh status

ランナーは GitHub の UI で Idle として表示され、自分を対象とするジョブを拾います。

5. ワークフローから使う

jobs:
  build:
    runs-on: self-hosted
    steps:
      - uses: actions/checkout@v4
      - run: make build && make test

Docker ジョブ（任意）

Docker を一度インストールすれば、ワークフローは実行間でレイヤーキャッシュを保持したままイメージをビルドできます：

sudo apt install -y docker.io
sudo usermod -aG docker runner

VPS に Docker をインストール を参照。サイジング：Small（月 $8） はほとんどの CI に快適です。重いコンパイルには一段上へ。約1分で root、KYC なし、暗号資産で支払い。