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