docs: add FAQ for flaky github.com checkout failures

2026-07-20 12:20:25 +08:00
parent 7e32c6e2b8
commit a9a554ac69
1 changed files with 1 additions and 0 deletions
@@ -116,3 +116,4 @@ shell.Run "cmd /c act_runner.exe daemon >> runner.log 2>&1", 0, False
 | workflow 一直排队不执行 | `runs-on` 标签与 runner labels 不匹配，改成 `windows-latest` |
 | 任务里 `docker`/`gcc`/`make` 找不到 | host 模式没有这些工具，见 README 的工具链清单 |
 | 注册时报令牌错误 | 注册令牌已过期或被用掉，重新生成一个 |
 | `actions/checkout` 步骤报 `github.com ... wsarecv` 连接失败 | runner 到 github.com 的网络不稳定（偶发）。处理：① 在 Actions 页面重跑该任务，多数情况重跑即成功；② 管理员可在服务端 `app.ini` 设 `[actions] DEFAULT_ACTIONS_URL` 指向可达镜像；③ workflow 里改用 `git clone https://x-access-token:${{ secrets.GITHUB_TOKEN }}@<实例域名>/${{ github.repository }}.git` 从实例拉代码，完全不依赖 github.com |