fix: 固定容器出站代理(修复 OIDC 登录 404); 并关闭通行密钥

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 -> https://cpp.tongji.sh/oidc/auth?client_id=tjhlp-gitea...
(修复前是 404), 登录页 200 且两张卡片正常, healthz 200。
This commit is contained in:
2026-09-13 16:31:40 +08:00
parent e489d19cb6
commit 25f1ec6cfc
5 changed files with 69 additions and 2 deletions
@@ -31,7 +31,7 @@
<h4 class="ui top attached header center">登录 {{AppName}}</h4> <h4 class="ui top attached header center">登录 {{AppName}}</h4>
<div class="ui attached segment"> <div class="ui attached segment">
<p class="tw-text-center tw-m-0"> <p class="tw-text-center tw-m-0">
同学们请使用<strong>高程统一身份认证</strong>登录, 账号密码与文档作业网站、编程作业网站相同。 请使用<strong>高程统一身份认证</strong>登录, 账号密码与文档作业网站相同
</p> </p>
{{template "user/auth/external_auth_methods" .}} {{template "user/auth/external_auth_methods" .}}
</div> </div>
@@ -43,7 +43,7 @@
<h4 class="ui top attached header center">管理员登录</h4> <h4 class="ui top attached header center">管理员登录</h4>
<div class="ui attached segment"> <div class="ui attached segment">
<p class="tw-text-center tw-m-0 tw-text-sm"> <p class="tw-text-center tw-m-0 tw-text-sm">
此入口仅管理员与助教使用(本地账号)。同学们请使用上方的高程统一身份认证登录。 此入口仅供管理员使用
</p> </p>
<form class="ui form" action="{{.SignInLink}}" method="post"> <form class="ui form" action="{{.SignInLink}}" method="post">
<div class="required field {{if .Err_UserName}}error{{end}}"> <div class="required field {{if .Err_UserName}}error{{end}}">
+14
View File
@@ -60,8 +60,22 @@ services:
GITEA__service__DISABLE_REGISTRATION: "false" GITEA__service__DISABLE_REGISTRATION: "false"
GITEA__service__ENABLE_CAPTCHA: "false" GITEA__service__ENABLE_CAPTCHA: "false"
GITEA__service__REQUIRE_SIGNIN_VIEW: "false" GITEA__service__REQUIRE_SIGNIN_VIEW: "false"
# 不做通行密钥(WebAuthn): 上游登录页那块只有 tw-hidden 元素, 浏览器不支持条件中介时
# 会留下一个空的方框; 关掉后区块不再渲染, 登录页也不会出现 passkey 入口。
GITEA__service__ENABLE_PASSKEY_AUTHENTICATION: "false"
GITEA__mailer__ENABLED: "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:-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}
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 自我推销 ------------------------- # --- 站点元信息与页脚: 去掉 Gitea 自我推销 -------------------------
# 段名里的点要写成 _0X2E_ (Gitea 的 GITEA__section__KEY 编码规则) # 段名里的点要写成 _0X2E_ (Gitea 的 GITEA__section__KEY 编码规则)
GITEA__ui_0X2E_meta__AUTHOR: 同济大学高级语言程序设计课程 GITEA__ui_0X2E_meta__AUTHOR: 同济大学高级语言程序设计课程
+11
View File
@@ -28,6 +28,17 @@ POSTGRES_DATA_DIR=/srv/pgdata
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
GITEA_CUSTOM_DIR=../customization/custom 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=https://cpp.tongji.sh:7890
#GITEA_HTTPS_PROXY=https://cpp.tongji.sh:7890
#GITEA_NO_PROXY=localhost,127.0.0.1,::1,10.80.42.185,.local,.internal
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
# 版本(锁定, 便于回滚) # 版本(锁定, 便于回滚)
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
+23
View File
@@ -145,6 +145,29 @@
> curl -sS --noproxy '*' http://127.0.0.1:2080/api/healthz > 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: https://cpp.tongji.sh/oidc/auth?... (404 = 认证源没注册上)
> ```
--- ---
## 3. 本机关键事实 ## 3. 本机关键事实
+19
View File
@@ -141,6 +141,9 @@ services:
GITEA__service__ENABLE_NOTIFY_MAIL: "false" GITEA__service__ENABLE_NOTIFY_MAIL: "false"
GITEA__service__ENABLE_CAPTCHA: "false" GITEA__service__ENABLE_CAPTCHA: "false"
GITEA__service__REQUIRE_SIGNIN_VIEW: "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_KEEP_EMAIL_PRIVATE: "false"
GITEA__service__DEFAULT_ALLOW_CREATE_ORGANIZATION: "true" GITEA__service__DEFAULT_ALLOW_CREATE_ORGANIZATION: "true"
GITEA__service__DEFAULT_ENABLE_TIMETRACKING: "true" GITEA__service__DEFAULT_ENABLE_TIMETRACKING: "true"
@@ -158,6 +161,22 @@ services:
# 这里显式声明, 避免上游改默认值时行为漂移 # 这里显式声明, 避免上游改默认值时行为漂移
GITEA__oauth2__ENABLED: "true" 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:-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}
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__DISABLE_REGULAR_ORG_CREATION: "true"
GITEA__admin__EXTERNAL_USER_DISABLE_FEATURES: deletion,manage_credentials,change_username,change_full_name GITEA__admin__EXTERNAL_USER_DISABLE_FEATURES: deletion,manage_credentials,change_username,change_full_name