外觀

語言

高效 AI 駕馭術

2026 GitHub Actions 自架 Runner 教學:用 Oracle Cloud 免費 ARM 主機跑 arm64 CI

把 Oracle Cloud Always Free 的 Ampere A1(Ubuntu 24.04 ARM)註冊成 GitHub Actions 自架 runner:下載 linux-arm64 版、用 config.sh 註冊、用 svc.sh 裝成系統服務、在 workflow 用 runs-on 指定標籤,再用私人 repo、專用使用者與檔案權限限制存取。

Kelvin Wang · · 9 分鐘閱讀

重點整理

  1. 自架 runner 的用量 GitHub 不收費,也不扣方案內含的運算額度;主機和維護是你自己的事。
  2. GitHub 建議自架 runner 只用在私人 repo:公開 repo 任何人開 PR 都可能在你的主機上跑程式。
  3. 用專用的 Linux 使用者跑 runner,限制它能讀取的檔案與金鑰;runner 程式會自動更新,作業系統和其他軟體要自己更新。
  4. 在 ARM 上跑 CI,Docker 映像檔要有 linux/arm64 版本,否則要靠很慢的模擬。

我有一台東京區(ap-tokyo-1)的 Oracle A1,上面用 systemd 常駐 Claude Code Remote Control,GitHub 用 fine-grained token 連線。這類常駐 ARM 主機也能接 GitHub Actions 的工作,但要先考慮 CI 和既有服務共用主機的風險。

以下步驟依官方文件整理,以 Ubuntu 24.04 ARM 為例,尚未在這台主機上實測。指令裡的 <...> 要換成你自己的值。

為什麼要把 Oracle A1 主機變成 GitHub Actions runner?

兩個理由:私人 repo 的 CI 不扣運算額度,以及原生 arm64 環境。

  • 自架 runner 不扣 GitHub 的額度。GitHub 的計費文件寫明,自架 runner 的用量免費,也不會減少方案內含的運算用量9;私人 repo 用 GitHub 代管的 runner,則會從內含額度扣,用完照分鐘計費10。自架的代價是主機和維護要自己負責2。
  • 原生 arm64,不用模擬。A1 本身就是 ARM 主機,build 出來的東西直接是 arm64。在 x64 機器上用 QEMU 模擬 arm64,Docker 文件說會比原生慢很多13。

公開 repo 的情況不一樣:GitHub 代管的標準 runner 在公開 repo 免費、不限量,也有 ubuntu-24.04-arm 這種 arm64 Linux 規格可以直接用10。所以這篇的做法主要是給私人 repo。

GitHub 代管 arm64 runnerOracle A1 自架 runner
公開 repo免費、不限量GitHub 不建議使用
私人 repo扣方案內含的運算額度,超過照分鐘計費GitHub 端免費,不扣額度
每次工作的環境每個工作一台全新的虛擬機預設重複使用;ephemeral 只自動註銷,清理環境要另外做
軟體與更新GitHub 準備好映像檔runner 程式自動更新,其他全部自己來

開始之前要準備什麼?

  1. 一台能連外的 A1 主機。GitHub 列的網路需求是主機能對外用 HTTPS(443 埠)連線、上下行至少 70 kbps,由 runner 主動連到 GitHub 拿工作3。主機怎麼搶、怎麼建網路,看文末的延伸閱讀。

  2. repo 的管理權限。個人 repo 要是擁有者;組織的 repo 要是組織擁有者或對該 repo 有 admin 權限1。

  3. 確認系統版本。GitHub 列的 Linux 支援版本包含 Ubuntu 20.04 以上;架構方面,文件把 Linux 的 ARM64 標成 public preview3。

  4. 建一個專用的 Linux 使用者。不要用你平常登入、或跑其他服務的帳號,原因在後面的安全段落:

    sudo useradd -m -s /bin/bash gha-runner
    sudo chmod 700 /home/gha-runner
    sudo -l -U gha-runner

    最後一行應顯示這個使用者沒有 sudo 權限。也要確認它不屬於 docker 等能取得主機管理權限的群組;其他服務的家目錄與金鑰是否能被它讀取,仍要另外檢查。

怎麼下載並註冊 linux-arm64 runner?

  1. 在 GitHub 開新增 runner 的頁面。repo 首頁 → Settings → 左側 Actions → Runners → New self-hosted runner1。

  2. 選 Linux 和 ARM64。頁面會依你選的系統和架構,列出下載、驗證、解壓、註冊的完整指令。

  3. 切換到專用使用者,下載並核對檔案。runner 的版本號和 SHA-256 以頁面上的為準;校驗失敗就停下來,不要解壓:

    sudo -iu gha-runner
    mkdir actions-runner && cd actions-runner
    curl -fL -o "actions-runner-linux-arm64-<VERSION>.tar.gz" "<頁面上的下載網址>" && \
    echo "<SHA256>  actions-runner-linux-arm64-<VERSION>.tar.gz" | sha256sum -c - && \
    tar xzf "./actions-runner-linux-arm64-<VERSION>.tar.gz"
  4. 用註冊 token 跑 config.sh。token 是頁面自動產生的,一小時後失效1。可以順便用 --labels 加自訂標籤,多個標籤用逗號隔開6:

    ./config.sh --url https://github.com/<OWNER>/<REPO> --token <RUNNER_TOKEN> --labels oracle-a1
  5. 先手動跑一次確認連線。看到 Connected to GitHub 和 Listening for Jobs 就代表成功,repo 的 Runners 列表也會出現這台1。確認後按 Ctrl+C 停掉:

    ./run.sh

怎麼讓 runner 開機自動啟動?

手動跑的 run.sh 一關掉終端機就停了。註冊完成後,資料夾裡會多一個 svc.sh,用它把 runner 裝成 systemd 服務4。

  1. 離開 runner 帳號,從管理帳號開 root shell。家目錄已設成 700,管理帳號不能直接進去,需要先用 sudo:

    exit
    sudo -i
    cd /home/gha-runner/actions-runner
  2. 安裝並啟動服務,再離開 root shell。install 後面接使用者名稱,服務就會用那個使用者的身分跑4:

    ./svc.sh install gha-runner
    ./svc.sh start
    ./svc.sh status
    exit
  3. 讓 needrestart 不要在工作中途重啟 runner。Ubuntu 這類 Debian 系統如果有啟用 needrestart,更新套件後它可能重啟 runner 服務;GitHub 提供了一行設定讓它略過4:

    echo '$nrconf{override_rc}{qr(^actions\.runner\..+\.service$)} = 0;' | sudo tee /etc/needrestart/conf.d/actions_runner_services.conf

要停掉或移除服務,同樣先開 root shell、進入 runner 資料夾,再跑 ./svc.sh stop 和 ./svc.sh uninstall;移除前要先停,做完離開 root shell4。

workflow 要怎麼指定這台 runner?

自架 runner 會自動拿到三種標籤:self-hosted、作業系統(linux)、架構(ARM64)5。在 runs-on 寫一串標籤,runner 必須全部符合才會接這個工作;標籤不分大小寫56。

# .github/workflows/arm64-build.yml
name: arm64 build

on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: read

jobs:
  build:
    runs-on: [self-hosted, linux, ARM64]
    steps:
      - uses: actions/checkout@v6
        with:
          persist-credentials: false
      - name: Check architecture
        run: uname -m
      - name: Build
        run: make build

uname -m 在 A1 上會印出 aarch64;make build 要換成專案實際的建置指令。這個工作只需要讀取 repo,因此將 GITHUB_TOKEN 設為唯讀,checkout 後也不保留 Git 憑證716。如果註冊時加了 oracle-a1,可以寫成 [self-hosted, linux, ARM64, oracle-a1];只有這台使用該標籤時,工作才會只派給它。

找不到符合標籤、又在線且閒著的 runner 時,工作會一直排隊;排超過 24 小時就失敗3。所以主機關機或 runner 服務掛掉時,工作不會馬上報錯,只會卡在 Queued。

自架 runner 有哪些安全風險?

上面比較的 GitHub 代管 arm64 runner,每次工作都使用新的虛擬機;自架 runner 預設重複使用主機,惡意的 workflow 程式可能留在機器裡,影響之後的工作710。

私人 repo 也不是完全安全:能 fork 並開 PR 的人(通常是有讀取權限的人)一樣能在 runner 上執行程式,碰得到 secrets 和 GITHUB_TOKEN7。能做的是把損害範圍縮小:

  • 用專用使用者跑 runner。如果 gh 把 token 存在 Claude Code 使用者的家目錄,同帳號執行的 workflow 也可能讀到它。分開帳號後,還要限制家目錄與金鑰的讀取權限,確認 runner 沒有 sudo 或其他提權途徑。單純新增一個帳號,不會讓其他服務的檔案自動變成不可讀。
  • 減少 runner 能接觸的金鑰。檢查主機上的 SSH 私鑰、API token 和它能連到的敏感服務,讓 workflow 只拿到工作需要的權限7。部署金鑰可以放在 Actions secrets,只交給需要的工作,但已遭入侵的常駐 runner 仍可能在後續工作使用 secret 時竊取它;存放位置不能取代執行環境的隔離。
  • 不要隨手把 runner 使用者加進 docker 群組。Docker 文件寫明,docker 群組等於 root 權限15。把 runner 使用者加入這個群組,就代表 workflow 能取得主機的 root 權限。
  • ephemeral 還需要清理環境。註冊時加 --ephemeral,runner 做完一個工作就自動從 GitHub 註銷;磁碟上的程式與資料不會因此消失,要另外清理或重建環境,再重新註冊37。

runner 要怎麼更新和移除?

  • runner 程式會自己更新。預設有新版時,runner 會在被派到工作時更新,沒有工作的話一週內更新3。
  • 作業系統和其他軟體要自己更新。GitHub 只負責 runner 程式本身2,Ubuntu 的套件、Docker、編譯工具都要自己跑 sudo apt update && sudo apt upgrade。
  • 關掉自動更新的話,63 天內一定要升級。用 --disableupdate 註冊的 runner,新版本可供更新後 63 天內沒升級,GitHub 就不再派工作給它;遇到重大安全更新,沒更新前也不會派3。沒有自行管理版本的需求,就保留自動更新。
  • 14 天沒連線會被自動移除。一般 runner 超過 14 天沒連上 GitHub,會被自動移除;ephemeral runner 是 1 天8。主機停太久,回來要重新註冊。
  • 要移除時從 GitHub 開始。repo 的 Settings → Actions → Runners → 點這台 → Remove,頁面會給一行附有限時 token 的移除指令,在主機上跑完會同時清掉設定檔和服務8。

在 ARM 上跑 CI 有什麼不一樣?

  • Docker 映像檔要有 arm64 版本。拉多平台映像檔時,Docker 會自動選符合主機架構的版本;只有 linux/amd64 的映像檔,在 arm64 主機上不靠模擬就跑不起來13。用到的 base image、服務容器,先確認有 linux/arm64。
  • Docker container action 也一樣。這類 action 只能在 Linux runner 上跑,而且自架 runner 要先裝好 Docker11;它的映像檔在你的 A1 上執行,所以同樣要有 arm64 版本。Docker Engine 本身支援 Ubuntu 24.04 和 arm6414。
  • 用之前先看 action 的說明。不是每個 action 都測過 ARM64 Linux,特別是會下載預先編譯好的執行檔的那種,README 沒寫支援就先在 workflow_dispatch 試跑一次。
  • 主機上沒有預裝的工具。GitHub 代管的 runner 映像檔裝好了一堆語言和工具;自架 runner 只有你自己裝的東西2,workflow 用到什麼就要先在主機上裝好,或在步驟裡安裝。

2 OCPU/12 GB 的主機要注意什麼?

  • 每個 runner 程序一次跑一個工作。GitHub 只把工作派給在線而且閒著的 runner3。同一台主機若裝了多個 runner 程序,就可能同時跑多個工作;和 Claude Code 這類常駐服務也會共用 CPU 與記憶體。
  • 磁碟會慢慢被吃掉。Docker 映像檔、build cache 都存在本機;Always Free 的開機磁碟加區塊儲存合計 200 GB 免費12,50 GB 的開機磁碟不夠時可以再加。
  • 跑 CI 不代表主機不會被收回。Oracle 的閒置條件是:7 天內 CPU 使用率的第 95 百分位低於 20%、網路使用率低於 20%,A1 再加上記憶體使用率低於 20%;同時符合時,主機可能被回收12。偶爾跑 CI,不能保證主機不會被判定為閒置。

常見問題

一台主機可以給好幾個 repo 用嗎?

repo 層級的 runner 只服務一個 repo;組織層級的 runner 可以服務組織裡的多個 repo2。個人帳號下的多個 repo,需要各自的 runner 安裝目錄、註冊設定與服務。這些服務可以同時接工作,資源和權限都要分開評估。

runner 需要固定 IP 或開防火牆嗎?

GitHub 的網路需求只列了對外:runner 主動連到 GitHub 拿工作,主機要能對外連 443 埠,文件沒有要求開對內的連接埠3。如果你的組織有設 IP 允許清單,才需要把主機的 IP 加進去3。

Oracle 收回主機後要怎麼辦?

在 GitHub 上把舊的 runner 移除(機器不在了就用 Force remove),新主機重新安裝工具、註冊 runner,並補回 workflow 使用的標籤8。標籤與建置環境一致時,workflow 通常不用改;需要保留的產物與資料,不能只放在 runner 本機。

想深入 2026 Oracle Cloud 免費 ARM 主機怎麼搶?常駐 Claude Code + Git repo 合作流程解析 搶 A1 主機的腳本、網路設定、固定 IP,以及在主機上接 GitHub 的方式。

資料來源

  1. 1. Adding self-hosted runners · GitHub Docs · 2026-11-13 查詢
  2. 2. Self-hosted runners · GitHub Docs · 2026-11-13 查詢
  3. 3. Self-hosted runners reference · GitHub Docs · 2026-11-13 查詢
  4. 4. Configuring the self-hosted runner application as a service · GitHub Docs · 2026-11-13 查詢
  5. 5. Using self-hosted runners in a workflow · GitHub Docs · 2026-11-13 查詢
  6. 6. Using labels with self-hosted runners · GitHub Docs · 2026-11-13 查詢
  7. 7. Secure use reference · GitHub Docs · 2026-11-13 查詢
  8. 8. Removing self-hosted runners · GitHub Docs · 2026-11-13 查詢
  9. 9. GitHub Actions billing · GitHub Docs · 2026-11-13 查詢
  10. 10. Choosing the runner for a job · GitHub Docs · 2026-11-13 查詢
  11. 11. About custom actions · GitHub Docs · 2026-11-13 查詢
  12. 12. Always Free Resources · Oracle Cloud Infrastructure Documentation · 2026-11-13 查詢
  13. 13. Multi-platform builds · Docker Docs · 2026-11-13 查詢
  14. 14. Install Docker Engine on Ubuntu · Docker Docs · 2026-11-13 查詢
  15. 15. Linux post-installation steps for Docker Engine · Docker Docs · 2026-11-13 查詢
  16. 16. actions/checkout · GitHub · 2026-11-13 查詢

關於作者

Kelvin Wang

電機工程師,和 AI Agent 做工具,分享工程與投資的實作筆記。

更多關於我