# 部署说明(阶段 6,需 QQ 批准后才做) 本文件只是操作手册,`scripts/deploy.sh` 默认是**预演**,不加 `--yes` 绝不会动线上。 ## 一、前提 1. 已在本地/镜像里打开 `preview/index.html`,日夜两种模式都看过,认可配色与留白。 2. 仓库已打标签 `v1.0-rc1`(`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-<时间戳>`。 ## 四、回滚 ```bash sudo tar xzf /var/backups/gitea-custom-<时间戳>.tar.gz -C / sudo chown -R git:git /var/lib/gitea/custom sudo systemctl restart gitea ``` ## 五、部署后自查清单 - [ ] `https://git.qyhhh.top/` 首页 logo 变成蓝白 Git-Q,圆外无白框 - [ ] 浏览器标签页 favicon 是新的小圆章 - [ ] 顶栏、按钮、链接全部蓝白,无绿色残留 - [ ] 代码块字体为 JetBrains Mono - [ ] 系统浅色/深色切换时,主题自动跟随(`qq-auto`) - [ ] 用户设置里仍能选回 `github-auto` 等旧主题(说明没破坏原有主题) - [ ] 无 500 错误、无模板解析报错(`journalctl -u gitea -n 50 --no-pager`)