rose_cat707
70c44e92fb
Go 控制面（SQLite + REST API）嵌入 Mihomo 数据面，Vue 3 多语言 Web 管理台。 含订阅/节点/规则/出站/监控/日志、OpenAPI、API Key、Gitea Actions CI（runs-on: default） 与开源文档；镜像发布至 git.rc707blog.top Container Registry。 Co-authored-by: Cursor <cursoragent@cursor.com>
43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
# act_runner 参考部署（可选）
|
||
|
||
工作流 `.gitea/workflows/ci.yml` 使用 **`runs-on: default`**。
|
||
Gitea Runners 页中 runner 的**标签必须包含 `default`**，且状态为**在线/空闲**。
|
||
|
||
## 已有 runner 时
|
||
|
||
若你已在 Gitea 注册了 runner（例如个人 runner、标签 `default`、docker 模式），**无需**使用本目录，直接 push 代码触发 CI 即可。
|
||
|
||
确认：**设置 → Actions → Runners** 中可见在线 runner，标签列含 `default`。
|
||
|
||
## 从零部署（可选）
|
||
|
||
```bash
|
||
cd .gitea/act-runner
|
||
cp .env.example .env
|
||
# 编辑 .env，填入 GITEA_RUNNER_REGISTRATION_TOKEN
|
||
docker compose up -d
|
||
```
|
||
|
||
Token 获取：仓库 **Settings → Actions → Runners → Registration Token**
|
||
|
||
部署成功后 Runners 页应显示标签 **`default`**。
|
||
|
||
## Docker 构建要求
|
||
|
||
`docker` job 需要 runner 能访问 Docker 引擎。docker 模式 runner 须挂载宿主机 socket：
|
||
|
||
```yaml
|
||
volumes:
|
||
- /var/run/docker.sock:/var/run/docker.sock
|
||
```
|
||
|
||
本目录 `docker-compose.yml` 与 `config.yaml` 已包含该配置。
|
||
|
||
## 常见问题
|
||
|
||
| 现象 | 处理 |
|
||
|------|------|
|
||
| 没有匹配 default 标签的在线运行器 | 确认 runner 在线；或 `runs-on` 与 Runners 页标签一致 |
|
||
| docker job 无法连接 Docker | 检查 act_runner 是否挂载 `/var/run/docker.sock` |
|
||
| push 镜像 unauthorized | 仓库 Secret 配置 `REGISTRY_TOKEN`（write:package） |
|