ページ内ナビ
概要
GitHub Actions Runnerは、GitHub Actions workflowのjobを実行するapplicationです。GitHub-hosted環境でも使われていますが、同じrunnerをLinux、macOS、Windowsの自社machineへ登録し、private network、専用hardware、独自toolchainを使うself-hosted runnerとして運用できます。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日:
主な特徴
自社machineをGitHub Actionsの実行先として登録する
repository、organization、enterpriseの設定からrunnerを登録し、workflowのruns-on labelに一致するjobを受け取ります。OSやarchitecture、custom labelで実行先を分けられます。
private networkや専用hardwareをCIから利用する
self-hosted runnerは自分で用意したhost上で動くため、社内serviceへの接続、GPU、特殊なSDKやdeviceなど、GitHub-hosted runnerでは用意しにくいresourceをjobから利用できます。
出典:[5]
向いている用途
CIを自社network・hardware・OSへ寄せる必要があるteamに向く
on-premise resource、private endpoint、GPUや特殊architecture、長期cacheなどを自分で管理したい場合のGitHub Actions実行基盤になります。
出典:[5]
導入前の確認
public repositoryではself-hosted runnerへ未信頼codeを流さない
GitHub Docsは、public repositoryのforkからpull requestを作ることで危険なcodeがself-hosted machine上で実行され得るため、self-hosted runnerはprivate repositoryでの利用を推奨しています。runner groupやworkflow access policyで利用範囲を絞ります。
出典:[6]
自動更新を止める場合でも30日以内の更新が必要
runnerは通常自動更新されます。自動更新を無効にした場合、新version公開から30日以内に更新しないとjobがqueueされなくなり、critical security updateではそれより早く停止する場合があります。
出典:[5]
参考にした公式資料
- [1]GitHub Actions Runner README(2026-10-03)
- [2]GitHub Actions Runner v2.337.0 release(2026-10-03)
- [3]Runner authentication and authorization design(2026-10-03)
- [4]GitHub Docs — Adding self-hosted runners(2026-10-03)
- [5]GitHub Docs — Self-hosted runners reference(2026-10-03)
- [6]GitHub Docs — Managing access to self-hosted runners(2026-10-03)
- [7]GitHub Actions Runner MIT license(2026-10-03)
編集部からの補足
GPU、社内network、特定OSなどGitHub-hosted runnerでは満たしにくい実行環境が必要なCIに有効です。一方、self-hosted runnerはworkflow codeを自社machine上で実行するため、特にpublic repositoryでは信頼境界をGitHub-hosted runnerより厳しく設計してください。
3ステップで試す
- 1
GitHubのrunner追加画面を開く
対象repositoryまたはorganizationでrunnerを追加し、OSとarchitectureを選択します。
Open Settings > Actions > Runners > New self-hosted runner - 2
画面に生成されたdownload・config commandを実行
表示されたversionを使い、time-limited registration tokenで登録します。tokenは1時間で失効するため保存・再利用しません。
Run the download, extract, and ./config.sh commands shown by GitHub - 3
runnerを起動してworkflowから利用
runnerを起動し、workflowのruns-onでself-hostedと必要なlabelを指定します。常用時はservice化とaccess policyも設計してください。
./run.sh
成長
成長の推移 · 直近30日
6,306 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit(直近30日)
- 35
- Open PR
- 114
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
GitHubデータ
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- Changesets12,466 Stars
共通タグ 2件 · 共通カテゴリ 3件
変更ごとにSemVerの更新種別と変更履歴を記録し、monorepoのversion更新・package公開を一貫して管理する
TypeScript - Allure Report5,548 Stars
共通タグ 2件 · 共通カテゴリ 2件
複数言語・test frameworkの実行結果を統一reportへ変換し、履歴・step・attachmentを可視化する
HTML - n8n206,530 Stars
共通タグ 2件 · 共通カテゴリ 1件
visual workflow・code・AI agent・human approvalを一つのautomation runtimeへ接続する
TypeScript - Dify157,734 Stars
共通タグ 2件 · 共通カテゴリ 1件
AIワークフロー、検索、エージェントを一つの基盤で設計・公開する
TypeScript - Home Assistant91,238 Stars
共通タグ 2件 · 共通カテゴリ 1件
照明・sensor・家電・serviceをlocal-firstなentity/automationへ統合するhome automation engine
Python - Docker Compose38,280 Stars
共通タグ 2件 · 共通カテゴリ 1件
compose.yamlでservice・network・volume・buildを一つのmulti-container applicationとして再現するDocker CLI plugin
Go
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。