使用
安裝前先知道:有已知漏洞
pickfit 在安裝時會一併裝上的套件裡找到 1 個已知的高風險或嚴重漏洞(OSV.dev,2026年11月16日),安裝前請先考慮。
go:github.com/klauspost/compress v1.18.7github.com/klauspost/compress 處理雙區塊 frame 時發生 panic (GO-2026-6865,高風險,1.20.2 已修正)
Linux x86_64
需要先準備
- 執行環境:
go (to build from source) - 系統套件:
docker
下載 act_Linux_x86_64 發行版 tarball,並將 act 執行檔安裝到 ~/.local/bin
mkdir -p ~/.local/bin /tmp/act && curl -fsSL -o /tmp/act/act.tar.gz https://github.com/nektos/act/releases/latest/download/act_Linux_x86_64.tar.gz && tar -xzf /tmp/act/act.tar.gz -C /tmp/act && install -m755 /tmp/act/act ~/.local/bin/act
README 與實測不符之處
- README 寫: (not mentioned)
實際可行: 首次執行若沒有 -P 或 ~/.config/act/actrc,act 會要求選擇預設映像檔並等待輸入(非互動模式下會卡住)。加上 -P 可略過此提示
確認能用
act --version輸出應包含「act version」。
先試試這個
mkdir -p /tmp/demo/.github/workflows && cd /tmp/demo && git init -q && cat > .github/workflows/ci.yml <<'EOF'
name: CI
on: push
jobs:
build:
runs-on: ubuntu-latest
steps:
- run: echo "hello from act $GITHUB_WORKSPACE"
test:
runs-on: ubuntu-latest
needs: build
steps:
- run: echo testing
EOFcd /tmp/demo && act push -P ubuntu-latest=-self-hosted進入 .github/workflows 內有工作流程檔案的 Git 儲存庫,執行 act push -P ubuntu-latest=-self-hosted。
它能做什麼
- 在自己的電腦上執行 GitHub Actions 工作流程已測試
怎麼使用
- 進入
.github/workflows內有工作流程檔案的 Git 儲存庫。 - 執行
act push -P ubuntu-latest=-self-hosted,跑由 push 觸發的工作流程。 - 檢查輸出中每個 job 是否都有「Job succeeded」一行。
- 進入
- 用工作流程 job 取代 Makefile已測試
怎麼使用
- 在
.github/workflows的工作流程檔案中,把要做的任務定義成 job。 - 用
act -j <job> -P ubuntu-latest=-self-hosted執行單一 job。
- 在
- 使用與 GitHub 相同的環境變數和檔案未測試
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以啟動
- 3 項功能中 2 項可用
- 需要網路
macOS 和 Windows:專案說支援,但 pickfit 還沒試過。
適合用來
- 不用 push 就能測試 GitHub 工作流程檔案的變更
- 把 GitHub Actions 工作流程當成本機任務執行器,取代 Makefile
可替代 make。
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
主要功能可用
- 從頭重跑
- 需要網路
- 檢查於 2026年11月15日
- 版本 0.2.97
測試機器遇到的差異
- README: Install Go, git clone git@github.com:nektos/act.git, make install
測試中: 使用 https://github.com/nektos/act/releases/latest/download/act_Linux_x86_64.tar.gz 的預先建置執行檔(不需要 Go)。SSH clone URL 還需要 GitHub SSH 金鑰;匿名 clone 須改用 HTTPS - README: act uses the Docker API to run containers for each action
測試中: 沙盒中沒有 Docker:容器執行失敗,出現 'failed to connect to the docker API'。改用 -P ubuntu-latest=-self-hosted 可直接在主機上執行 job