# 部署说明(阶段 6,需 QQ 批准后才做) 本文件只是操作手册,`scripts/deploy.sh` 默认是**预演**,不加 `--yes` 绝不会动线上。 ## 一、前提 1. 已在本地/镜像里打开 `preview/index.html`,日夜两种模式都看过,认可配色与留白。 2. 仓库已按实际版本打候选标签 `vX.Y.Z-rcN`(`git tag -l` 可查)。 3. QQ 明确说过「可以部署」。 ## 二、预演(随时可做,零风险) ```bash cd ~/projects/Gitea-font ./scripts/deploy.sh ``` 它会列出将被复制的文件清单、备份路径与后续动作,然后退出,线上不变。 ## 三、真部署 ```bash ./scripts/deploy.sh --yes # 复制 custom/ + 重启 ./scripts/deploy.sh --yes --patch-ini # 另外把 app.ini 的 [ui] 主题切成 qq 系列 ``` `--patch-ini` 做的事:把 `DEFAULT_THEME` 改为 `qq-auto`,并在 `THEMES` 后追加 `qq-auto,qq-light,qq-dark`(原有主题全部保留,可随时在用户设置里切回)。 原 `app.ini` 会备份成 `/etc/gitea/app.ini.bak-<时间戳>`。 ## 四、回滚 部署脚本会完整备份 `custom/`(包含三套 `theme-qq*.css`)和 `app.ini`,并在重启或 HTTP 健康检查失败时自动回滚。人工回滚统一使用: ```bash ./scripts/rollback.sh --list ./scripts/rollback.sh /var/backups/gitea-custom-<时间戳>.tar.gz ``` `rollback.sh` 会先校验归档、再备份当前状态、停止服务,并通过 `rsync --delete` 精确恢复。旧版本部署脚本生成的备份缺少 QQ 主题,默认拒绝;只有确认承担主题缺失风险时才可附加 `--allow-incomplete`。 ## 五、部署后自查清单 - [ ] `https://git.qyhhh.top/` 首页 logo 变成蓝白 Git-Q,圆外无白框 - [ ] 浏览器标签页 favicon 是新的小圆章 - [ ] 顶栏、按钮、链接全部蓝白,无绿色残留 - [ ] 代码块字体为 JetBrains Mono - [ ] 系统浅色/深色切换时,主题自动跟随(`qq-auto`) - [ ] 用户设置里仍能选回 `github-auto` 等旧主题(说明没破坏原有主题) - [ ] 无 500 错误、无模板解析报错(`journalctl -u gitea -n 50 --no-pager`)