Skip to content

构建与发布 ​

一条命令 ​

bash
./deploy.sh                 # 构建并发布主站两个版本(电脑版 + 手机版)
./deploy.sh pc              # 只发电脑 / 平板版
./deploy.sh mobile          # 只发手机版
./deploy.sh docs            # 只发项目文档
./deploy.sh blog            # 只发技术随笔
./deploy.sh sites           # 只补两个子域的 nginx 配置与证书
./deploy.sh nginx           # 只校验 / 应用主站 nginx 配置
./deploy.sh --skip-build    # 用现有 dist 直接发
./deploy.sh --dry-run       # 只打印计划,不连服务器

deploy.sh 只是入口,真正干活的是 scripts/deploy.py,它做四件事:

  1. 构建:在对应目录执行 npm run build;
  2. 打包:把 dist/ 打成 tar.gz;
  3. 上传:SFTP 传到 /tmp,远端解包;
  4. 镜像:rsync -a --delete 到目标目录,发布前备份旧版本。

构建流程细节 ​

电脑版 pc-web ​

bash
node scripts/gen-pages.mjs                       # 1. 生成所有 HTML 与 sitemap
node scripts/fetch-lottery.mjs --best-effort     # 2. 抓彩票数据(失败保留旧快照)
vite build                                       # 3. 多页构建
node scripts/postbuild.mjs                       # 4. 把 dist/pages 提到根目录

产物里每个工具一个目录,URL 形如 /text/word-counter/,共 100+ 个 HTML 页面(工具、栏目、教育、测算、法务页与首页)。

手机版 mobile-web ​

bash
vite build       # base='./',产物可直接挂到任意子目录

产物入口是 dist/index.html,路由用 hash(/m/#/t/text/word-counter),所以服务器只需要一条 fallback 规则。

文档 docs-site ​

bash
vitepress build     # 产物 dist/,开启 cleanUrls

随笔 blog-site ​

bash
vitepress build     # 产物 dist/,同时生成 rss.xml 与 sitemap.xml

发布时发生了什么 ​

本地 dist ──tar.gz──► /tmp/deploy-<app>-<时间> ──rsync──► /var/www/emphant-*
                                        └── 发布前备份 ──► /var/www/.releases/
  • rsync -a --delete 保证目标目录与产物完全一致,删掉的文件会同步删除;
  • 主站发布电脑版时排除 /m/(--exclude=/m/),不会顺手清掉手机版;
  • 备份保留最近 5 份,镜像前完成,失败可以直接回滚;
  • 全部成功后校验关键文件是否存在(index.html、assets/、工具页),再 nginx -t + reload。

环境变量 ​

bash
SSH_HOST=121.43.28.40 \
SSH_USER=root \
SSH_PASS='***' \
REMOTE_PC=/var/www/emphant \
REMOTE_M=/var/www/emphant/m \
./deploy.sh

完整列表见 环境变量。

发布前检查清单 ​

  • [ ] npm run build 本地通过,没有 TS / Vue 编译报错
  • [ ] 首页、一个文本工具、一个测算工具都能打开并计算
  • [ ] 新增页面已出现在 sitemap.xml
  • [ ] 改了 nginx 配置的话,先在本地看一眼 diff
  • [ ] 发布后抽查 https://emphant.com、https://docs.emphant.com、https://blog.emphant.com

发布后验证 ​

bash
curl -I https://emphant.com/
curl -I https://emphant.com/text/word-counter/
curl -I https://docs.emphant.com/guide/
curl -I https://blog.emphant.com/rss.xml

状态码应为 200,content-type 正确,cache-control 符合预期(首页 no-cache,/assets/ 长缓存)。

文档随仓库一起更新,站点内容全部在浏览器本地运行。