Commit Graph
4 Commits
Author SHA256 Message Date
admin 73ce8162aa feat(ci): 落地 main 自动部署的可复用件(runner 配置/部署脚本/定制断言/工作流)
按 deploy/ci-cd.md 方案把除推送触发之外的东西都准备好:

- customization/check.sh <base-url>: 把 preview.sh check 里的"定制生效"断言抽成
  任意实例可跑的脚本(首页/页脚/meta/官网链接/登录页两张卡/无通行密钥方框/
  无「工单」/无 example.com), 另加生产才有的 OIDC 入口 307 断言(404 = 认证源没注册上)。
  实测对生产 17/17 通过。
- deploy/scripts/auto-deploy.sh: build.py -> compose up -d -> verify.sh + check.sh,
  失败自动回滚到 deploy/.state/last-deployed; flock 串行; 结束时把 clone 所有权还给
  ymy(job 容器里是 root); 内网验证强制不走代理。
- deploy/runner/{compose.yaml,config.yaml,.env.example}: act_runner v0.6.1 跑在容器里
  (不需要 root), network: host + 同路径挂载部署克隆 + 宿主 docker CLI/compose 插件,
  capacity 1 保证部署串行。
- .gitea/workflows/deploy.yml: push main + workflow_dispatch, [skip deploy] 跳过,
  concurrency 串行, 只做"同步到 github.sha + 调 auto-deploy.sh"。
- .gitignore: deploy/.state/、deploy/runner/{.env,data/}。

依据见 deploy/ci-cd.md(含全部实测证据与待确认项)。
2026-09-13 22:09:32 +08:00
admin 25f1ec6cfc 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。
2026-09-13 16:31:40 +08:00
admin e489d19cb6 feat: 登录页改为「统一身份认证」优先 + 独立的「管理员登录」卡片
整文件覆盖 templates/user/auth/signin.tmpl(基线已进 upstream/):

- 第一张卡: 站名 + 说明文字 + 认证源按钮。按钮部分仍复用上游的
  {{template "user/auth/external_auth_methods" .}}, 所以换/加认证源不用改模板
- 第二张卡: 「管理员登录」, 正文写明此入口仅管理员与助教使用(本地账号),
  同学们请走统一身份认证 —— 避免同学拿学号去试用户名/密码
- 不再渲染 passkey 区块; 表单字段/验证码/忘记密码/记住设备/注册入口保持上游逻辑,
  仅去掉 autofocus(避免聚焦到次要卡片), 实测登录与报错提示均正常

配套:
- preview.sh check 增加登录页断言(有管理员卡片、无通行密钥方框), 现 15 项全过
- README 新增 3.4 登录页(含「预览里临时加认证源」的做法)、目录树与已验证清单
2026-09-11 17:28:34 +08:00
admin 7d19e2729c feat: 新增 Gitea 定制机制(首页/中文语言/去 Gitea 化)与本地预览
不改 Go 代码、不 fork, 只用官方 CustomPath 覆盖层 + app.ini/env 配置:

- custom/templates: 整文件覆盖 home.tmpl(落地页换成答疑平台介绍)与
  base/head_navbar.tmpl(docs.gitea.com -> 站内提问指南、新增课程官网入口)
- custom/public/assets/tjhlp/ask-guide.html: 站内提问指南静态页
- overrides/ + build.py: 由上游快照确定性生成整份 locale_zh-CN.json
  (工单 -> Issue 等 133 处), 带占位符校验; 缺失键会退回英文, 必须整份覆盖
- build.py 同时负责规范 custom/ 权限: 容器内 Gitea 以 git(982) 运行,
  文件若为 600 只读挂载也会 permission denied 并拒绝启动(生产踩过)
- upstream/<版本>/ + fetch-upstream.sh: 上游基线, 供升级时 diff 与重生成
- preview/: 独立 compose + preview.sh(up/check/reload/admin/reset),
  与生产隔离(独立端口 2081/数据目录/sqlite), 用同一镜像版本验证效果
- website-linkage.md: 官网(VitePress)侧的联动改动提案
2026-09-11 17:07:05 +08:00