diff --git a/customization/preview/compose.yaml b/customization/preview/compose.yaml index 7d4cb01..cd094f2 100644 --- a/customization/preview/compose.yaml +++ b/customization/preview/compose.yaml @@ -65,14 +65,14 @@ services: GITEA__service__ENABLE_PASSKEY_AUTHENTICATION: "false" GITEA__mailer__ENABLED: "false" - # --- 出站代理 ------------------------------------------------------- - # 显式给值, 防止 compose 把宿主 shell 的 http_proxy(本机是 127.0.0.1:7890, - # 在容器里指向容器自己)自动注入; 生产上这会直接让 OIDC discovery 失败, - # 见 deploy/compose.yaml 同位置注释与 deploy/README.md 陷阱 6。 - HTTP_PROXY: ${GITEA_HTTP_PROXY:-http://10.80.42.185:7890} - HTTPS_PROXY: ${GITEA_HTTPS_PROXY:-http://10.80.42.185:7890} - http_proxy: ${GITEA_HTTP_PROXY:-http://10.80.42.185:7890} - https_proxy: ${GITEA_HTTPS_PROXY:-http://10.80.42.185:7890} + # --- 出站代理: 显式给值挡掉自动注入, 默认不用代理 --------------------- + # compose 会把宿主 shell 的 http_proxy(本机是 127.0.0.1:7890, 在容器里指向 + # 容器自己)自动注入; 生产上这会直接让 OIDC discovery 失败(登录 404)。 + # 预览与生产都不需要出站代理, 理由见 deploy/compose.yaml 同位置注释。 + 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} diff --git a/deploy/.env.example b/deploy/.env.example index fb12a71..10e6d82 100644 --- a/deploy/.env.example +++ b/deploy/.env.example @@ -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=http://10.80.42.185:7890 #GITEA_HTTPS_PROXY=http://10.80.42.185:7890 diff --git a/deploy/README.md b/deploy/README.md index 517718d..389fac0 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -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' diff --git a/deploy/compose.yaml b/deploy/compose.yaml index 27aba5b..117b262 100644 --- a/deploy/compose.yaml +++ b/deploy/compose.yaml @@ -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:-http://10.80.42.185:7890} - HTTPS_PROXY: ${GITEA_HTTPS_PROXY:-http://10.80.42.185:7890} - http_proxy: ${GITEA_HTTP_PROXY:-http://10.80.42.185:7890} - https_proxy: ${GITEA_HTTPS_PROXY:-http://10.80.42.185: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}