fix: 容器默认不用出站代理(实测确认不需要)

上一版把代理默认值设成了改造前宿主机上的 10.80.42.185:7890, 实测其实是多余的:

- 与功能相关的出站只有 OIDC, 目标是 10.80.42.185, 容器内直连 200;
- 容器里会访问外网的只有「检查更新」(纯提示)和个别学生仓库的 webhook
  (Heai/Test-Webhooks -> heai.ink, jkljkluiouio/hw02 -> debianapi.*),
  课程平台自身与课程仓库都不依赖;
- 宿主 7890 是 ssh 转发的开发用代理, ss -ltn 显示只监听 127.0.0.1/[::1],
  容器两条路都连不上(127.0.0.1:7890 是容器自己的回环, 10.80.42.185:7890
  curl -x 直接 Could not connect) —— 配上只会让每次出站先绕一圈再失败。

改成 ${GITEA_HTTP_PROXY:-} 这种空默认值: 仍然显式赋值以挡住 compose 的自动注入
(注入 127.0.0.1:7890 会让 OIDC discovery 失败、登录 404), 但容器里不再配代理。
将来有稳定且容器可达的代理时, 在 deploy/.env 里给 GITEA_HTTP_PROXY 即可。

实测: 重建后容器内 http_proxy 为空, OIDC 入口 307 -> /oidc/auth, healthz 200,
启动无 [E]; 预览 check 全过。
This commit is contained in:
2026-09-13 16:40:01 +08:00
parent 25f1ec6cfc
commit b60e5e9f1e
4 changed files with 45 additions and 24 deletions
+7 -4
View File
@@ -30,10 +30,13 @@ GITEA_CUSTOM_DIR=../customization/custom
# -----------------------------------------------------------------------------
# 容器出站代理(见 compose.yaml 同段落注释 / README 陷阱 6)
# compose 会把「运行 compose 的 shell」里的 http_proxy 自动注入容器。本机登录 shell
# 里的值是 127.0.0.1:7890 —— 那个地址在容器里是容器自己, 一旦被注入, Gitea 启动时
# OIDC discovery 直接失败, 统一身份认证登录 404。所以 compose.yaml 里显式写了默认值,
# 下面这三行一般不用开; 需要改代理/彻底不用代理时再取消注释并修改(置空即不用)。
# 默认: compose.yaml 里显式写成空值, 即容器内【不用代理】。这不是省事, 是有意的:
# * compose 会把「运行 compose 的 shell」里的 http_proxy 自动注入容器, 而本机登录
# shell 里是 127.0.0.1:7890 —— 那个地址在容器里是容器自己, 一旦被注入, Gitea
# 启动时 OIDC discovery 就失败, 统一身份认证登录 404; 显式给空值能挡住注入。
# * 平台本身不需要出站代理: 唯一与功能相关的出站(OIDC)目标是 10.80.42.185,
# 容器内直连即可; 会访问外网的只有「检查更新」(纯提示)和个别学生仓库的 webhook。
# 将来若配了稳定且【容器可达】的代理, 在这里给出即可(别写 127.0.0.1):
# -----------------------------------------------------------------------------
#GITEA_HTTP_PROXY=https://cpp.tongji.sh:7890
#GITEA_HTTPS_PROXY=https://cpp.tongji.sh:7890
+12 -3
View File
@@ -159,9 +159,18 @@
> `/QA/user/oauth2/...` 返回 **404**, 统一身份认证**完全无法登录**。
> 这个坑很隐蔽: 容器是健康的、健康检查 `200`、登录页 `200`, 只有真正点登录才炸。
>
> `compose.yaml` 现在**显式**给出这四个变量(默认 = 改造前宿主机上的代理设置,
> 且 `NO_PROXY` 含 `10.80.42.185` 让 OIDC 走直连), 显式赋值可以挡住自动注入。
> 改代理见 `.env.example` 的同名段落。**每次 `up -d` 后建议验一次**:
> `compose.yaml` 现在**显式**给出这几个变量、且默认**空值**(= 容器内不用代理),
> 显式赋值可以挡住自动注入。**默认不用代理是实测结论**:
> * 唯一与功能相关的出站是 OIDC, 目标是 `10.80.42.185`, 容器内直连即 `200`;
> * 容器里会访问外网的只有「检查更新」(纯提示)与个别学生仓库的 webhook
> (`Heai/Test-Webhooks` → `heai.ink`、`jkljkluiouio/hw02` → `debianapi.jkljkluiouio.top`),
> 课程平台自身与课程仓库都不依赖;
> * 宿主 `7890` 那个代理是 **ssh 转发的开发用代理**, `ss -ltn` 显示只监听
> `127.0.0.1:7890`/`[::1]:7890`, 容器两条路都连不上(实测 `curl -x` 直接
> `Could not connect to server`), 配上去只会让每次出站先绕一圈再失败。
>
> 将来有稳定且**容器可达**的代理时, 在 `.env` 里给 `GITEA_HTTP_PROXY`(见 `.env.example`)。
> **每次 `up -d` 后建议验一次** OIDC 入口是否还通:
> ```bash
> curl -sS --noproxy '*' -o /dev/null -w '%{http_code} %{redirect_url}\n' \
> 'http://127.0.0.1:2080/user/oauth2/%E9%AB%98%E7%A8%8B%E7%BB%9F%E4%B8%80%E8%BA%AB%E4%BB%BD%E8%AE%A4%E8%AF%81'
+18 -9
View File
@@ -161,19 +161,28 @@ services:
# 这里显式声明, 避免上游改默认值时行为漂移
GITEA__oauth2__ENABLED: "true"
# --- 出站代理: 必须显式给值, 不能让 compose 自动注入 -------------------
# --- 出站代理: 显式给值挡掉 compose 的自动注入, 默认【不用代理】 --------
# ★ docker compose 会把【运行 compose 的那个 shell 里】的 http_proxy/https_proxy
# 自动注入容器, 而不同 shell 的值可能不同。若注入的是 127.0.0.1:7890,
# 那个地址在容器里指向容器自己的 loopback, 于是 Gitea 启动时 OIDC discovery 失败:
# 自动注入容器。本机登录 shell 里是 127.0.0.1:7890, 而那个地址在容器里指向
# 容器自己, 于是 Gitea 启动时 OIDC discovery 失败:
# initOAuth2Sources() [E] Unable to register source: 高程统一身份认证 due to
# proxyconnect tcp: dial tcp 127.0.0.1:7890: connect: connection refused
# 后果: /user/oauth2/<认证源> 返回 404, 统一身份认证登录不可用(2026-09-11 实际踩到)。
# 默认值 = 改造前宿主机 app.ini 所在环境的代理设置(容器可达的局域网代理),
# 且 NO_PROXY 覆盖 10.80.42.185, 让 OIDC discovery 直连。改/清空见 deploy/.env。
HTTP_PROXY: ${GITEA_HTTP_PROXY:-https://cpp.tongji.sh:7890}
HTTPS_PROXY: ${GITEA_HTTPS_PROXY:-https://cpp.tongji.sh:7890}
http_proxy: ${GITEA_HTTP_PROXY:-https://cpp.tongji.sh:7890}
https_proxy: ${GITEA_HTTPS_PROXY:-https://cpp.tongji.sh:7890}
# 显式赋值可以挡住注入 —— 哪怕给的是空值。
#
# 为什么默认不用代理(2026-09-11 实测结论):
# * 与功能相关的出站只有 OIDC, 目标是 10.80.42.185, 容器内直连就是 200;
# * 容器里唯一会访问外网的是「检查更新」(纯提示)和个别学生仓库里的 webhook
# (Heai/Test-Webhooks -> heai.ink、jkljkluiouio/hw02 -> debianapi.*),
# 课程平台自身与课程仓库都不依赖它们;
# * 宿主 7890 那个代理是 ssh 转发的开发用代理, 只监听宿主 127.0.0.1,
# 容器既连不上 127.0.0.1:7890(那是容器自己的回环)也连不上
# 10.80.42.185:7890(实测 connect refused) —— 配上只会让出站多绕一圈再失败。
# 将来若真有稳定且容器可达的代理, 在 deploy/.env 里给 GITEA_HTTP_PROXY 即可。
HTTP_PROXY: ${GITEA_HTTP_PROXY:-}
HTTPS_PROXY: ${GITEA_HTTPS_PROXY:-}
http_proxy: ${GITEA_HTTP_PROXY:-}
https_proxy: ${GITEA_HTTPS_PROXY:-}
NO_PROXY: ${GITEA_NO_PROXY:-localhost,127.0.0.1,::1,10.80.42.185,.local,.internal}
no_proxy: ${GITEA_NO_PROXY:-localhost,127.0.0.1,::1,10.80.42.185,.local,.internal}