From a9a554ac69b770302435a3749eccd31e0c6ab56e Mon Sep 17 00:00:00 2001 From: antior Date: Mon, 20 Jul 2026 12:20:25 +0800 Subject: [PATCH] docs: add FAQ for flaky github.com checkout failures --- docs/add-runner.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/add-runner.md b/docs/add-runner.md index 4f05138..b82a653 100644 --- a/docs/add-runner.md +++ b/docs/add-runner.md @@ -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 |