测试
以我自建的项目为例：https://github.com/idev-sig/file-downloader
基础镜像：https://github.com/catthehacker/docker_images/pkgs/container/ubuntu
将下面的内容保存至项目或用户根目录（~/）的 .actrc
-P ubuntu-24.04=ghcr.io/catthehacker/ubuntu:act-latest
-P ubuntu-24.04-arm=ghcr.io/catthehacker/ubuntu:act-latest
-P ubuntu-24.04=ghcr.io/catthehacker/ubuntu:rust-latest
event.json
测试 dev 分支的 .github/workflows/docker-dev.yml
{
"ref": "refs/heads/dev",
"before": "0000000000000000000000000000000000000000",
"after": "1111111111111111111111111111111111111111",
"repository": {
"full_name": "idev-sig/file-downloader"
},
"pusher": {
"name": "jetsung"
},
"head_commit": {
"id": "1111111111111111111111111111111111111111",
"message": "Test commit",
"timestamp": "2025-07-31T12:00:00Z",
"author": {
"name": "test",
"email": "test@gmail.com"
}
}
}
.secrets 密钥
GITHUB_TOKEN=ghp_aaaaaaaaaaa
.env 环境变量 （event.json 中设置的不起作用）
GITHUB_REPOSITORY=idev-sig/file-downloader
执行
act push -e event.json --secret-file .secrets --env-file .env
# 若不设置 .env 则
act push -e event.json --secret-file .secrets --env GITHUB_REPOSITORY=idev-sig/file-downloader
常见 问题
[build/build] ❗ ::error::Unable to get the ACTIONS_RUNTIME_TOKEN env variable
act 默认没有启动 artifact server，导致 ACTIONS_RUNTIME_TOKEN / ACTIONS_RUNTIME_URL 等内部变量是空的。解决办法如下：
--artifact-server-path ./.artifacts
