Files
Prism/.gitea/act-runner/README.md
T
rose_cat707 af5596aea3
CI / test (push) Successful in 1m24s
CI / docker (push) Failing after 22s
feat: Prism HTTP/SOCKS5 代理网关及管理台
Go 控制面(SQLite + REST API)嵌入 Mihomo 数据面,Vue 3 多语言 Web 管理台。
含订阅/节点/规则/出站/监控/日志、OpenAPI、API Key、Gitea Actions CI 与开源文档;
CI 适配自托管 runner(国内 Go 镜像、act 容器构建、docker.sock 挂载说明)。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-23 14:16:48 +08:00

1.8 KiB
Raw Blame History

act_runner 配置参考

工作流 runs-on: ubuntu-latestdocker job 额外使用 catthehacker/ubuntu:act-22.04 容器(含 Docker CLI)。

构建镜像必须:挂载 Docker Socket

docker job 需要访问宿主机 Docker 引擎。在 runner 所在机器config.yaml 中配置:

container:
  options: -v /var/run/docker.sock:/var/run/docker.sock
  valid_volumes:
    - /var/run/docker.sock

推荐 job 镜像(含 Node + Docker CLI):

runner:
  labels:
    - "ubuntu-latest:docker://catthehacker/ubuntu:act-22.04"
    - "ubuntu-22.04:docker://catthehacker/ubuntu:act-22.04"

修改后 重启 runner(例如 docker restart <runner容器> 或重启 Gitea Runner 服务)。

验证

在 runner 宿主机执行:

docker info
ls -l /var/run/docker.sock

从零部署 runner(可选)

cd .gitea/act-runner
cp .env.example .env   # 填入 Registration Token
docker compose up -d

常见错误

报错 原因 处理
docker: command not found job 容器无 Docker CLI 工作流已指定 act 镜像;或 runner 改用 catthehacker/ubuntu
Cannot connect to Docker daemon 未挂载 docker.sock 按上文修改 config.yaml 并重启 runner
node not in PATH job 镜像无 Node 标签映射改用 catthehacker/ubuntu:act-22.04

Gitea Runner v0.6.x(个人 runner

  1. 找到 runner 的配置文件或环境(安装目录 / docker compose
  2. 确保 runner 进程能访问宿主机 /var/run/docker.sock
  3. Runners 页标签含 ubuntu-latest 且状态 空闲/在线

若使用 Gitea 网页注册的个人 runnerdocker 模式),通常需在 runner 启动参数或 config.yaml 里加入 socket 挂载,具体路径取决于你的安装方式。