SHA256
Compare commits
2
Commits
68fb567cb3
...
25f1ec6cfc
| Author | SHA256 | Date | |
|---|---|---|---|
|
|
25f1ec6cfc | ||
|
|
e489d19cb6 |
+27
-1
@@ -69,6 +69,8 @@ Gitea 把模板 / 语言 / 静态资源都编进了二进制,但读取时走 `as
|
||||
| meta 作者/描述/关键词 | `[ui.meta] AUTHOR/DESCRIPTION/KEYWORDS` | `GITEA__ui_0X2E_meta__DESCRIPTION` 等 |
|
||||
| 页脚 Powered by / 版本号 | `[other] SHOW_FOOTER_POWERED_BY` / `SHOW_FOOTER_VERSION` | `GITEA__other__SHOW_FOOTER_POWERED_BY` |
|
||||
| 自定义主题配色 | `[ui] THEMES` + `custom/public/assets/css/theme-*.css` | `GITEA__ui__THEMES` |
|
||||
| 关闭通行密钥(WebAuthn) | `[service] ENABLE_PASSKEY_AUTHENTICATION` | `GITEA__service__ENABLE_PASSKEY_AUTHENTICATION` |
|
||||
| 关闭用户名/密码表单 | `[service] ENABLE_PASSWORD_SIGNIN_FORM` | `GITEA__service__ENABLE_PASSWORD_SIGNIN_FORM` |
|
||||
| Logo / favicon | 放 `custom/public/assets/img/{logo,favicon}.svg` 等 | 同上(文件方式) |
|
||||
|
||||
> 环境变量规则:`GITEA__<段名>__<键名>`,段名里的 `.` 不能直接写,要编码成
|
||||
@@ -103,6 +105,7 @@ customization/
|
||||
├── custom/ ★ 挂进容器的覆盖层(= $CustomPath 的内容)
|
||||
│ ├── templates/home.tmpl 落地页
|
||||
│ ├── templates/base/head_navbar.tmpl 导航栏(去掉 docs.gitea.com)
|
||||
│ ├── templates/user/auth/signin.tmpl 登录页(统一身份认证优先, 管理员登录次要)
|
||||
│ ├── public/assets/tjhlp/ask-guide.html 静态「提问指南」页(/assets/tjhlp/...)
|
||||
│ └── options/locale/locale_zh-CN.json 生成物,已 gitignore
|
||||
└── preview/ 本地预览(独立 compose,独立端口/数据)
|
||||
@@ -165,6 +168,27 @@ customization/preview/preview.sh reset # 清空预览数据重新来
|
||||
- **模板改动仍需重启**(`reload`),这是 Gitea 的既有行为。
|
||||
- 需要 docker 权限;当前 shell 不在 docker 组时脚本会自动改用 `sg docker -c`。
|
||||
|
||||
### 3.4 登录页
|
||||
|
||||
登录页 `custom/templates/user/auth/signin.tmpl` 的结构是「统一身份认证(第一张卡) +
|
||||
管理员登录(第二张卡)」,认证源那部分直接复用上游的
|
||||
`{{template "user/auth/external_auth_methods" .}}`,所以**换认证源不用改模板**。
|
||||
|
||||
预览实例默认没有配置任何认证源,登录页就只显示管理员卡片。想看到统一身份认证那张卡,
|
||||
临时加一个认证源即可(用完删掉):
|
||||
|
||||
```bash
|
||||
# 加: 用 github 这类不需要 discovery 的 provider 最省事, 只为看布局
|
||||
sg docker -c "docker exec -u git gitea-preview gitea admin auth add-oauth \
|
||||
--name '高程统一身份认证(测试)' --provider github --key k --secret s"
|
||||
sg docker -c 'docker exec -u git gitea-preview gitea admin auth list' # 看 ID
|
||||
sg docker -c 'docker exec -u git gitea-preview gitea admin auth delete --id 1'
|
||||
```
|
||||
|
||||
**通行密钥(WebAuthn)已关闭**,不是靠模板删的,而是配置:
|
||||
`[service] ENABLE_PASSKEY_AUTHENTICATION = false`(两处 compose 都设了)。
|
||||
上游那块在浏览器不支持条件中介时会渲染成一个空的方框,关掉配置连区块都不再输出。
|
||||
|
||||
---
|
||||
|
||||
## 4. 纳入当前项目 & 部署
|
||||
@@ -295,10 +319,12 @@ cd deploy && ./scripts/backup.sh --quiesce && docker compose pull gitea && docke
|
||||
- ✅ `custom/public/assets/tjhlp/ask-guide.html` 经 `/assets/` 正常访问
|
||||
- ✅ zh-CN 整份覆盖后,仓库 Issue 页显示「创建 Issue / 前往 Issue」,不再出现「工单」
|
||||
- ✅ 语言文件在 dev 模式下改动即生效(模板仍须重启)
|
||||
- ✅ 登录页改成「统一身份认证」优先 + 「管理员登录」卡片,表单仍可正常登录/报错
|
||||
- ✅ 关闭 `ENABLE_PASSKEY_AUTHENTICATION` 后,登录页不再出现空的通行密钥方框
|
||||
|
||||
尚未覆盖(需要时按同样套路加):
|
||||
|
||||
- Logo / favicon 换成本课程的图(需要设计稿;放到 `custom/public/assets/img/`)
|
||||
- 登录页、注册页、错误页文案
|
||||
- 注册页(`user/auth/signup.tmpl`)、错误页文案
|
||||
- 更多术语(合并请求 / 仓库 / 里程碑…)—— 在 `overrides/` 里加规则即可
|
||||
- 自定义主题配色(`[ui] THEMES` + `custom/public/assets/css/theme-*.css`)
|
||||
|
||||
@@ -0,0 +1,92 @@
|
||||
{{/*
|
||||
登录页, 整文件覆盖 Gitea 内置 templates/user/auth/signin.tmpl。
|
||||
|
||||
维护约定:
|
||||
* 上游基线: customization/upstream/<版本>/templates/user/auth/signin.tmpl
|
||||
升级 Gitea 时先 diff 基线, 把上游的结构性改动(新增表单字段/新认证方式)合并回来。
|
||||
* 相对上游的改动只有布局, 逻辑尽量原样搬过来:
|
||||
1) 课程同学走的是「高程统一身份认证」(OIDC), 所以把它放进第一张卡片、配说明文字;
|
||||
卡片正文复用上游的 {{template "user/auth/external_auth_methods" .}},
|
||||
将来新增/更换认证源不用改这个模板。
|
||||
2) 用户名/密码降级为第二张「管理员登录」卡片, 并在正文里写明只有管理员/助教用。
|
||||
3) 不再渲染通行密钥(passkey)区块 —— 上游那块只有 tw-hidden 的元素, 浏览器不支持
|
||||
条件中介时会留下一个空的方框; 服务端已用
|
||||
[service] ENABLE_PASSKEY_AUTHENTICATION = false 关掉该功能。
|
||||
* 只用 Gitea 已编译进 CSS 的 class: Tailwind 工具类是按上游模板裁剪过的,
|
||||
新增 tw-* 前先 grep assets/css/index.css 确认存在(否则不会生效)。
|
||||
* 文案直接写中文(平台只面向中文用户), 表单标签仍走 ctx.Locale.Tr 以便跟随语言设置。
|
||||
*/}}
|
||||
{{template "base/head" .}}
|
||||
<div role="main" aria-label="{{.Title}}" class="page-content user signin">
|
||||
<div class="ui middle very relaxed page grid">
|
||||
{{/* 这些样式与内置模板保持一致, 同时作用于登录/注册/绑定账号页 */}}
|
||||
<div class="column tw-flex tw-flex-col tw-gap-4 tw-max-w-2xl tw-m-auto">
|
||||
<div class="ui container fluid">
|
||||
{{template "base/alert" .}}
|
||||
</div>
|
||||
|
||||
{{$hasExternalAuth := or .OAuth2Providers .EnableOpenIDSignIn .EnableSSPI}}
|
||||
{{if $hasExternalAuth}}
|
||||
<div class="ui container fluid">
|
||||
<h4 class="ui top attached header center">登录 {{AppName}}</h4>
|
||||
<div class="ui attached segment">
|
||||
<p class="tw-text-center tw-m-0">
|
||||
请使用<strong>高程统一身份认证</strong>登录, 账号密码与文档作业网站相同
|
||||
</p>
|
||||
{{template "user/auth/external_auth_methods" .}}
|
||||
</div>
|
||||
</div>
|
||||
{{end}}
|
||||
|
||||
{{if .EnablePasswordSignInForm}}
|
||||
<div class="ui container fluid">
|
||||
<h4 class="ui top attached header center">管理员登录</h4>
|
||||
<div class="ui attached segment">
|
||||
<p class="tw-text-center tw-m-0 tw-text-sm">
|
||||
此入口仅供管理员使用
|
||||
</p>
|
||||
<form class="ui form" action="{{.SignInLink}}" method="post">
|
||||
<div class="required field {{if .Err_UserName}}error{{end}}">
|
||||
<label for="user_name">{{ctx.Locale.Tr "home.uname_holder"}}</label>
|
||||
<input id="user_name" type="text" name="user_name" value="{{.user_name}}" required tabindex="1">
|
||||
</div>
|
||||
{{if not .DisablePassword}}
|
||||
<div class="required field {{if .Err_Password}}error{{end}}">
|
||||
<div class="tw-flex tw-mb-1">
|
||||
<label for="password" class="tw-flex-1">{{ctx.Locale.Tr "password"}}</label>
|
||||
<a href="{{AppSubUrl}}/user/forgot_password" tabindex="4">{{ctx.Locale.Tr "auth.forgot_password"}}</a>
|
||||
</div>
|
||||
<input id="password" name="password" type="password" value="{{.password}}" autocomplete="current-password" required tabindex="2">
|
||||
</div>
|
||||
{{end}}
|
||||
<div class="inline field">
|
||||
<div class="ui checkbox">
|
||||
<label>{{ctx.Locale.Tr "auth.remember_me"}}</label>
|
||||
<input name="remember" type="checkbox" tabindex="5">
|
||||
</div>
|
||||
</div>
|
||||
|
||||
{{template "user/auth/captcha" .}}
|
||||
|
||||
<div class="field">
|
||||
<button class="ui primary button tw-w-full" tabindex="3">
|
||||
{{ctx.Locale.Tr "sign_in"}}
|
||||
</button>
|
||||
</div>
|
||||
</form>
|
||||
</div>
|
||||
</div>
|
||||
{{end}}
|
||||
|
||||
{{if .ShowRegistrationButton}}
|
||||
<div class="ui container fluid">
|
||||
<div class="ui attached segment tw-text-center">
|
||||
<span>{{ctx.Locale.Tr "auth.need_account"}}</span>
|
||||
<a href="{{AppSubUrl}}/user/sign_up">{{ctx.Locale.Tr "auth.sign_up_now"}}</a>
|
||||
</div>
|
||||
</div>
|
||||
{{end}}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
{{template "base/footer" .}}
|
||||
@@ -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:-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 自我推销 -------------------------
|
||||
# 段名里的点要写成 _0X2E_ (Gitea 的 GITEA__section__KEY 编码规则)
|
||||
GITEA__ui_0X2E_meta__AUTHOR: 同济大学高级语言程序设计课程
|
||||
|
||||
@@ -126,6 +126,17 @@ check)
|
||||
! grep -q "工单" "${ROOT}/custom/options/locale/locale_zh-CN.json" &&
|
||||
ok "生成的 zh-CN 语言文件已无「工单」" || bad "语言文件里仍有「工单」"
|
||||
|
||||
# --- 登录页 -----------------------------------------------------------
|
||||
login="$(mktemp)"
|
||||
curl -fsS -H 'Accept-Language: zh-CN' "${BASE_URL}/user/login" -o "${login}"
|
||||
grep -q "管理员登录" "${login}" &&
|
||||
ok "登录页有独立的「管理员登录」卡片" || bad "登录页缺少管理员登录卡片"
|
||||
! grep -q "webauthn-error\|signin-passkey" "${login}" &&
|
||||
ok "登录页已无空的通行密钥(WebAuthn)方框" || bad "登录页仍有通行密钥区块"
|
||||
grep -q 'id="external-login-navigator"' "${login}" ||
|
||||
echo " (提示: 预览未配置认证源, 登录页不显示统一身份认证按钮; 见 customization/README.md 3.4)"
|
||||
rm -f "${login}"
|
||||
|
||||
[ "${fail}" = 0 ] && echo "全部检查通过" || echo "存在检查未通过项"
|
||||
exit "${fail}"
|
||||
;;
|
||||
|
||||
@@ -7,3 +7,4 @@
|
||||
options/locale/locale_zh-CN.json
|
||||
templates/home.tmpl
|
||||
templates/base/head_navbar.tmpl
|
||||
templates/user/auth/signin.tmpl
|
||||
|
||||
@@ -0,0 +1,10 @@
|
||||
{{template "base/head" .}}
|
||||
<div role="main" aria-label="{{.Title}}" class="page-content user signin{{if .LinkAccountMode}} icon{{end}}">
|
||||
<div class="ui middle very relaxed page grid">
|
||||
{{/* these styles are quite tricky and should also apply to the signup and link_account pages */}}
|
||||
<div class="column tw-flex tw-flex-col tw-gap-4 tw-max-w-2xl tw-m-auto">
|
||||
{{template "user/auth/signin_inner" .}}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
{{template "base/footer" .}}
|
||||
@@ -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=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
|
||||
|
||||
# -----------------------------------------------------------------------------
|
||||
# 版本(锁定, 便于回滚)
|
||||
# -----------------------------------------------------------------------------
|
||||
|
||||
@@ -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: https://cpp.tongji.sh/oidc/auth?... (404 = 认证源没注册上)
|
||||
> ```
|
||||
|
||||
---
|
||||
|
||||
## 3. 本机关键事实
|
||||
|
||||
@@ -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:-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__EXTERNAL_USER_DISABLE_FEATURES: deletion,manage_credentials,change_username,change_full_name
|
||||
|
||||
Reference in New Issue
Block a user