主题
构建与发布
一条命令
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,它做四件事:
- 构建:在对应目录执行
npm run build; - 打包:把
dist/打成tar.gz; - 上传:SFTP 传到
/tmp,远端解包; - 镜像:
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/ 长缓存)。