feat(gitea): 升 28.2.0 并把品牌装饰层纳管为可重跑的仓库真源

自建 Gitea 此前是出厂外观(茶杯标 + 「Gitea: Git with a cup of tea」标题),而品牌「纯字标 + 朱砂条」已在官网落地;同时现网 1.27.2
  落后两个安全版本 —— 1.27.3 的 fix(git): restrict hook permissions 打的正是本实例 8 月被入侵所用的 packObjectsHook
  向量。装饰基准取自升级后从容器抽出的真实模板,不凭记忆手写。

- 升级 28.2.0:pg_dump 后还原到一次性探针库对账(116 表 / 20 仓库 / 8 用户全等),停服 8s;28.0.0 的 git egress BREAKING
  按裁定收为 EGRESS_MODE=strict(实测 app.ini 无旧 ALLOWED_* 键、mirror 仓库 0 个 ⇒ 空白名单不伤业务)。

- 装饰层真源入库 infra/cicd/gitea-custom/(结构即实测 CustomPath=/data/gitea):页头/OG/默认头像换简标与刻版、novalon-
  brand.css 覆盖 --color-primary 全色阶、custom/header.tmpl 外链注入、signin_inner.tmpl
  登录页加字标锁定(220×103)。

- 色阶由脚本生成并自带夹具:先对上游 14 档对账(light/dark 两档 ramp 命名互为反向,手敲必错),再喂上游蓝做反向自证,双双通过才写盘。

- 深档按钮改「黑字朱底」:Gitea 用同一令牌既当按钮底色又当链接文字色,AA 区间为空(按钮白字 L≤0.1833 vs 链接 on #1e1f20 L≥0.2362)⇒ #E13C58
  × #0D0D0D 实测 4.62:1;深档链接 3.92:1 作为已登记让步保留(上游蓝同位 4.14,本就不达标)。

- deploy/verify 带预检、备份、内容 sha256 比对、负对照与 0/1/2/3 退出码分档,核心判红自动回滚(首轮就靠它把「标题未生效」与「装饰未生效」区分开)。

- 纠正两处生产口径失真:仓库那份「加固版」compose 从未上线(真实文件纳管为 infra/cicd/gitea/docker-compose.live.yml);生产
  REQUIRE_SIGNIN_VIEW 实为 false,且 compose 的 DISABLE_REGISTRATION=false 会经 environment-to-ini
  在重建时静默打开注册 —— 已对齐为 true。遗留的匿名浏览面与 SSH_PORT 错配只登记不擅动。
This commit is contained in:
zhangxiang committed 2026-10-22 18:55:55 +08:00
1 parent 03be1c9e36
commit becb9407bd
55 files changed
+1657 -2

No files matched your search

+11 -1
View File
@@ -28,7 +28,7 @@
│ │ │
│ ┌───────▼─────┐ ┌─────▼──────┐
│ │ gitea │ │ jenkins │
└─────────►│ 1.27.2 │ │ 2.568.1 │
└─────────►│ 28.2.0 │ │ 2.568.1 │
│ :3001(本机) │ │ :8080(本机) │
│ :2222 SSH │ └─────┬──────┘
└───────┬─────┘ │
@@ -44,6 +44,16 @@
- 触发:Gitea push → webhook → Jenkins `GenericTrigger` → 构建/测试 → `scripts/deploy.sh` rsync 发布
- 反代与 TLS:`nginx-static-production.conf` 定义 upstream,`conf.d/*.conf` 定义 server 块
## 2026-10-22 升级与品牌化(实测回填)
- **版本**:`gitea/gitea:1.27.2` → **`28.2.0`**(上游已改版本号:`1.27.x → 28.x`)。1.27.3 含 16 条 SECURITY 修复,其中 `fix(git): restrict hook permissions`(#39008)打的正是本实例 8 月被入侵所用的 `packObjectsHook` 向量,28.x 一并收进来;另新增**审计日志**(#38189)与 WebSocket 通知(#36965,`conf.d/git.f.novalon.cn.conf:36-38` 已有 `Upgrade` 头,无需改 nginx)。
- **BREAKING 已处理**:28.0.0 把所有 git 出站操作改走内部 forward proxy,旧 `ALLOWED_DOMAINS/BLOCKED_DOMAINS/ALLOW_LOCALNETWORKS` 作废,改 `[security] EGRESS_MODE = lax|strict` + `ALLOWED_HOST_LIST`(新语法:`*.example.com` 只匹配子域、IP 不支持通配符、`*` 不再是合法条目、非标准端口须显式列出)。实测 app.ini 里**没有任何旧键**、DB 里 **mirror 仓库 = 0** ⇒ 已按裁定设 `EGRESS_MODE=strict` + 空白名单(未来用「从 URL 迁移」需先加白名单)。
- **升级过程**:现场 `pg_dump`(61MB,**不是**文档旧记录的 1.7MB)→ 还原到一次性探针库对账(116 表 / 20 仓库 / 8 用户全对上)→ 改 compose image tag → `docker-compose up -d` → 停服 **8s** 后 healthz 200。回滚锚点:旧镜像 `e8be8e1f776f`(daocloud 镜像站)、`/root/gitea-pre28-*.sql`、`docker-compose.yml.bak-*`。
- **⚠ 两处文档失真已纠正**(详见 `CONTEXT.md` 「CI 生产口径的两处失真」行):
1. 本文件与 `infra/cicd/docker-compose.gitea.yml` 描述的「加固版」**从未上线**;生产实跑 `/home/novalon/docker-app/novalon-cicd/gitea/docker-compose.yml`,现已纳管为 `infra/cicd/gitea/docker-compose.live.yml`。
2. `REQUIRE_SIGNIN_VIEW` 生产是 **false**(`/` 303 → `/explore`,匿名可浏览仓库列表),不是文档写的 true。另:`/etc/s6/gitea/setup:60` 每次启动都跑 `environment-to-ini`,compose 里 `DISABLE_REGISTRATION=false` 会在重建容器时**静默打开注册**——本轮已把它对齐成与 app.ini 一致的 true。
- **品牌装饰层**:图标/主色/登录页换成「睿新致遠 / NOVALON」,真源是仓库里的 `infra/cicd/gitea-custom/`(结构即 `$GITEA_CUSTOM`,实测 `CustomPath=/data/gitea`),部署与回滚见其 README。**未做**:匿名浏览面收口、`SSH_PORT=22` 与宿主 `2222:22` 的克隆地址错配。
## 2026-09-14 审计结论
### 已就绪(无需改动)