SHA256
forked from course-team/tjhlp-gitea
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:
+9
-8
@@ -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' \
|
||||
|
||||
Reference in New Issue
Block a user