From 25f1ec6cfc3090ce0452bcca57812169cb4cce4f42314130cfa3b34d30112e73 Mon Sep 17 00:00:00 2001 From: Maoayo233 Date: Fri, 11 Sep 2026 17:28:34 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E5=9B=BA=E5=AE=9A=E5=AE=B9=E5=99=A8?= =?UTF-8?q?=E5=87=BA=E7=AB=99=E4=BB=A3=E7=90=86(=E4=BF=AE=E5=A4=8D=20OIDC?= =?UTF-8?q?=20=E7=99=BB=E5=BD=95=20404);=20=E5=B9=B6=E5=85=B3=E9=97=AD?= =?UTF-8?q?=E9=80=9A=E8=A1=8C=E5=AF=86=E9=92=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1) 出站代理 —— 这次实际踩到的故障: docker compose 会把「运行 compose 的那个 shell」里的 http_proxy/https_proxy 自动注入容器。登录 shell 里是 127.0.0.1:7890, 而 127.0.0.1 在容器里指向容器自己, 于是 Gitea 启动时 OIDC discovery 失败: initOAuth2Sources() [E] Unable to register source: 高程统一身份认证 due to proxyconnect tcp: dial tcp 127.0.0.1:7890: connect: connection refused 认证源注册不上 -> 登录页按钮照旧显示(数据来自数据库), 但点下去 /QA/user/oauth2/... 返回 404, 统一身份认证完全无法登录。 现在两处 compose 都显式给出这四个变量(默认 = 改造前宿主机上的代理设置, NO_PROXY 含 10.80.42.185 让 OIDC 直连), 显式赋值可挡住自动注入; .env.example 说明如何覆盖/置空, README 记为新陷阱 6(含一行验证命令)。 2) 通行密钥: [service] ENABLE_PASSKEY_AUTHENTICATION=false(两处 compose)。 登录页此前那个"空方框"就是它: 上游该区块只有 tw-hidden 元素, 浏览器不支持 条件中介时 CSS 隐藏一切, 只剩一个带边框的 segment。关掉后连区块都不再输出。 实测: 生产 up -d 后 OIDC 入口 307 -> http://10.80.42.185/oidc/auth?client_id=tjhlp-gitea... (修复前是 404), 登录页 200 且两张卡片正常, healthz 200。 --- .../custom/templates/user/auth/signin.tmpl | 4 ++-- customization/preview/compose.yaml | 14 +++++++++++ deploy/.env.example | 11 +++++++++ deploy/README.md | 23 +++++++++++++++++++ deploy/compose.yaml | 19 +++++++++++++++ 5 files changed, 69 insertions(+), 2 deletions(-) diff --git a/customization/custom/templates/user/auth/signin.tmpl b/customization/custom/templates/user/auth/signin.tmpl index 90b24b9..57889e2 100644 --- a/customization/custom/templates/user/auth/signin.tmpl +++ b/customization/custom/templates/user/auth/signin.tmpl @@ -31,7 +31,7 @@

登录 {{AppName}}

- 同学们请使用高程统一身份认证登录, 账号密码与文档作业网站、编程作业网站相同。 + 请使用高程统一身份认证登录, 账号密码与文档作业网站相同

{{template "user/auth/external_auth_methods" .}}
@@ -43,7 +43,7 @@

管理员登录

- 此入口仅管理员与助教使用(本地账号)。同学们请使用上方的高程统一身份认证登录。 + 此入口仅供管理员使用

diff --git a/customization/preview/compose.yaml b/customization/preview/compose.yaml index f57a15e..7d4cb01 100644 --- a/customization/preview/compose.yaml +++ b/customization/preview/compose.yaml @@ -60,8 +60,22 @@ services: GITEA__service__DISABLE_REGISTRATION: "false" GITEA__service__ENABLE_CAPTCHA: "false" GITEA__service__REQUIRE_SIGNIN_VIEW: "false" + # 不做通行密钥(WebAuthn): 上游登录页那块只有 tw-hidden 元素, 浏览器不支持条件中介时 + # 会留下一个空的方框; 关掉后区块不再渲染, 登录页也不会出现 passkey 入口。 + 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} + 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} + # --- 站点元信息与页脚: 去掉 Gitea 自我推销 ------------------------- # 段名里的点要写成 _0X2E_ (Gitea 的 GITEA__section__KEY 编码规则) GITEA__ui_0X2E_meta__AUTHOR: 同济大学高级语言程序设计课程 diff --git a/deploy/.env.example b/deploy/.env.example index 7d3e553..fb12a71 100644 --- a/deploy/.env.example +++ b/deploy/.env.example @@ -28,6 +28,17 @@ POSTGRES_DATA_DIR=/srv/pgdata # ----------------------------------------------------------------------------- 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 里显式写了默认值, +# 下面这三行一般不用开; 需要改代理/彻底不用代理时再取消注释并修改(置空即不用)。 +# ----------------------------------------------------------------------------- +#GITEA_HTTP_PROXY=http://10.80.42.185:7890 +#GITEA_HTTPS_PROXY=http://10.80.42.185:7890 +#GITEA_NO_PROXY=localhost,127.0.0.1,::1,10.80.42.185,.local,.internal + # ----------------------------------------------------------------------------- # 版本(锁定, 便于回滚) # ----------------------------------------------------------------------------- diff --git a/deploy/README.md b/deploy/README.md index 8765e5b..517718d 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -145,6 +145,29 @@ > curl -sS --noproxy '*' http://127.0.0.1:2080/api/healthz > ``` +> **⚠️ 6. compose 会把 shell 的 `http_proxy` 注入容器 —— 会让 OIDC 登录整条 404。** +> `docker compose up` 会自动把**运行它的那个 shell** 里的 `HTTP_PROXY`/`HTTPS_PROXY`/ +> `NO_PROXY`(大小写都算)注入容器。本机登录 shell 里是 +> `http_proxy=http://localhost:7890`,而 **`localhost`/`127.0.0.1` 在容器里指向容器自己**, +> 于是 Gitea 启动时拉 OIDC discovery 失败: +> ```text +> initOAuth2Sources() [E] Unable to register source: 高程统一身份认证 due to +> Error: Failed to initialize OpenID Connect Provider ... proxyconnect tcp: +> dial tcp 127.0.0.1:7890: connect: connection refused +> ``` +> 认证源注册不上 → 登录页的按钮还在(它来自数据库), 但点下去 +> `/QA/user/oauth2/...` 返回 **404**, 统一身份认证**完全无法登录**。 +> 这个坑很隐蔽: 容器是健康的、健康检查 `200`、登录页 `200`, 只有真正点登录才炸。 +> +> `compose.yaml` 现在**显式**给出这四个变量(默认 = 改造前宿主机上的代理设置, +> 且 `NO_PROXY` 含 `10.80.42.185` 让 OIDC 走直连), 显式赋值可以挡住自动注入。 +> 改代理见 `.env.example` 的同名段落。**每次 `up -d` 后建议验一次**: +> ```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' +> # 期望: 307 + Location: http://10.80.42.185/oidc/auth?... (404 = 认证源没注册上) +> ``` + --- ## 3. 本机关键事实 diff --git a/deploy/compose.yaml b/deploy/compose.yaml index 8138e89..27aba5b 100644 --- a/deploy/compose.yaml +++ b/deploy/compose.yaml @@ -141,6 +141,9 @@ services: GITEA__service__ENABLE_NOTIFY_MAIL: "false" GITEA__service__ENABLE_CAPTCHA: "false" GITEA__service__REQUIRE_SIGNIN_VIEW: "false" + # 不做通行密钥(WebAuthn): 上游登录页的 passkey 区块只有 tw-hidden 的元素, + # 浏览器不支持条件中介时就渲染成一个空方框; 关闭后区块不再输出。 + GITEA__service__ENABLE_PASSKEY_AUTHENTICATION: "false" GITEA__service__DEFAULT_KEEP_EMAIL_PRIVATE: "false" GITEA__service__DEFAULT_ALLOW_CREATE_ORGANIZATION: "true" GITEA__service__DEFAULT_ENABLE_TIMETRACKING: "true" @@ -158,6 +161,22 @@ services: # 这里显式声明, 避免上游改默认值时行为漂移 GITEA__oauth2__ENABLED: "true" + # --- 出站代理: 必须显式给值, 不能让 compose 自动注入 ------------------- + # ★ docker compose 会把【运行 compose 的那个 shell 里】的 http_proxy/https_proxy + # 自动注入容器, 而不同 shell 的值可能不同。若注入的是 127.0.0.1:7890, + # 那个地址在容器里指向容器自己的 loopback, 于是 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} + 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} + # --- 管理员限制 ----------------------------------------------------- GITEA__admin__DISABLE_REGULAR_ORG_CREATION: "true" GITEA__admin__EXTERNAL_USER_DISABLE_FEATURES: deletion,manage_credentials,change_username,change_full_name