docs: 修正 CI/CD 方案的前提 —— 本机可完整访问互联网

之前测的是错的: 我把 --noproxy '*' 和 -x 一起传给 curl, 等于把要测的代理关掉了,
再叠加当时的一过性网络抖动, 得出了"宿主与容器都上不了外网"的错误结论。重测(2026-09-13):

- 宿主: 国内直连 200, 境外经 127.0.0.1:7890 代理 200;
- 容器: 直连 dl.gitea.com 200 / api.github.com 200 / codeload 301
  (仅 github.com 主站直连会超时), 即容器本来就有网, 不需要代理;
- docker daemon 已配代理(/etc/systemd/system/docker.service.d/http-proxy.conf),
  镜像拉取正常: gitea/act_runner:latest 拉到 arm64 v0.6.1(69.3MB),
  docker.gitea.com/runner-images:ubuntu-22.04 等 job 镜像 manifest 均可取;
- 用 act_runner 镜像自带的 generate-config 确认了两个关键能力:
  label 支持 ":host"(宿主模式), container.network 支持 "host"。

据此重写 deploy/ci-cd.md:
- 主方案改为标准做法: runner 用 gitea/act_runner 容器 + compose 管理,
  job 跑在容器里(network: host, 同路径挂载部署克隆与 docker.sock),
  全程不需要 root(ymy 在 docker 组); 宿主二进制 + host 模式降为备选 B
- 去掉了"离线"带来的一堆绕路(一次性下载二进制、不能写 uses: 等);
  不写 uses: 仍保留, 但理由改成"本项目不需要 + 避开 github.com 主站直连超时",
  并给出需要时的 github_mirror / 代理两条路
- 待确认项从 6 条缩到 3 条实质问题(fork PR 审批、job 镜像工具、workflow 语法支持面)

同时修正 compose/README/.env.example 里"容器上不了外网"的措辞:
默认不用代理的真正理由是"容器直连就通、且宿主 7890 只监听回环容器不可达",
而不是"外网不通"。显式空值挡 compose 自动注入的结论不变。
This commit is contained in:
2026-09-13 17:27:47 +08:00
parent a65970303f
commit ea3ad2bb31
5 changed files with 217 additions and 236 deletions
+9 -8
View File
@@ -161,16 +161,17 @@
> 这个坑很隐蔽: 容器是健康的、健康检查 `200`、登录页 `200`, 只有真正点登录才炸。
>
> `compose.yaml` 现在**显式**给出这几个变量、且默认**空值**(= 容器内不用代理),
> 显式赋值可以挡住自动注入。**默认不用代理是实测结论**:
> * 唯一与功能相关的出站是 OIDC, 目标是 `10.80.42.185`, 容器内直连即 `200`;
> * 容器里会访问外网的只有「检查更新」(纯提示)与个别学生仓库的 webhook
> (`Heai/Test-Webhooks` → `heai.ink`、`jkljkluiouio/hw02` → `debianapi.jkljkluiouio.top`),
> 课程平台自身与课程仓库都不依赖;
> 显式赋值可以挡住自动注入。**默认不用代理的依据**(2026-09-13 实测):
> * 容器**直连外网是通的**: `dl.gitea.com`、`api.github.com`、`codeload.github.com`
> 在容器里直接 curl 分别是 `200/200/301`(`github.com` 主站直连会超时, 但平台不依赖它);
> * 与功能相关的出站只有 OIDC, 目标是 `10.80.42.185`, 容器内直连即 `200`;
> * 宿主 `7890` 那个代理是 **ssh 转发的开发用代理**, `ss -ltn` 显示只监听
> `127.0.0.1:7890`/`[::1]:7890`, 容器两条路都连不上(实测 `curl -x` 直接
> `Could not connect to server`), 配上去只会让每次出站先绕一圈再失败。
> `127.0.0.1:7890`/`[::1]:7890` —— 在容器里 `127.0.0.1` 是容器自己,
> `10.80.42.185:7890` 也不可达(实测 `curl -x` 直接 `Could not connect`),
> 所以这个代理配进容器只会让出站先绕一圈再失败。
>
> 将来有稳定且**容器可达**的代理时, 在 `.env` 里给 `GITEA_HTTP_PROXY`(见 `.env.example`)。
> 将来真要给容器配代理, 必须是**容器可达**的地址(把隧道绑到 LAN 口, 或让容器用
> host 网络), 再在 `.env` 里给 `GITEA_HTTP_PROXY`(见 `.env.example`)。
> **每次 `up -d` 后建议验一次** OIDC 入口是否还通:
> ```bash
> curl -sS --noproxy '*' -o /dev/null -w '%{http_code} %{redirect_url}\n' \