www_site/docs/production-deployment-2026-09-12.md

生产部署记录（2026-09-12）

发布

• 发布提交：49a916b（首页菜单增加"主页"入口；全站按钮改为透明底 + hover 动态背景，按钮内文字前加品牌 logo 小图标 components/brand-icon.tsx；CMS 中文化标签、i18n（en/zh）、自定义退出按钮 /cms/api/cms-logout）。
• 发布目录：/home/flym/releases/49a916b-www（www，服务器构建）、/home/flym/releases/cms-49a916b（CMS，服务器构建）。
• 软链：kaotings-www→releases/49a916b-www、kaotings-cms→releases/cms-49a916b、kaotings-api→releases/ad87a71/services/api（未变更，未重启）。
• 数据库迁移：无（CMS 改动仅为标签/i18n/组件，无字段结构变化）。

过程

1. 本地提交 49a916b 并推送 origin（57c854a..49a916b）。
2. git archive 打包 www 全量与 apps/cms，scp 上传（kaotings_deploy 密钥）。
3. 服务器 cp -a 上一发布后解包覆盖；关键文件 SHA256 与本地一致（lib/content.ts、brand-icon.tsx、payload.config.ts）。
4. 服务器构建：www（NODE_ENV=production CMS_PUBLIC_API_URL=http://127.0.0.1:3001/cms npm run build）与 CMS（npm run build）均成功。
5. CMS 产物完整性：.next/node_modules 经符号链接实文件 319 个（pino 207），符合"服务器构建"要求，无 09-11 的 Windows 构建空目录问题。
6. 切换顺序：先 CMS（重启 kaotings-cms，验证 200）→ 再 www（重启 kaotings-web）。软链属主为 flym，切换本身无需 sudo；仅 systemctl restart 使用 sudo。

回滚

• www 回滚：kaotings-www→releases/ad87a71-www + systemctl restart kaotings-web。
• CMS 回滚：kaotings-cms→releases/cms-ad87a71-c + systemctl restart kaotings-cms。
• 无迁移，回滚无数据兼容问题。

验收

• systemctl is-active：kaotings-api / kaotings-cms / kaotings-web 均 active。
• GET /healthz（127.0.0.1:8000 与 https://www.kaotings.com）：ok / 200。
• www 首页（本地 3000 与外部 https 一致）：主导航含"主页"（→/）；登录/联系我们为统一透明底按钮（hover 出背景）；页面 /_next/image 图标 18 处（含按钮 logo 与品牌标）；/icon.png 200。
• CMS：/cms/admin 200；/cms/api/products?where[status][equals]=published 200（www 产品列表依赖正常）。
• 管理端中文标签/i18n 与退出按钮：代码已上线，登录态界面待人工目视确认。