部署说明

生产构建

（服务端代码）

npm run build
node dist/index.js

基础部署建议

• 使用 pm2 或容器编排管理进程
• 配置反向代理（Nginx）与 HTTPS
• 将敏感配置放入环境变量，不提交到仓库

健康检查与日志

• 提供健康检查接口用于探针监控
• 记录关键日志：登录、房间加入、异常栈
• 统一日志采集，便于排障与审计

多实例注意事项

• Redis 用于共享状态与 Pub/Sub 同步（世界聊天）
• 所有实例需保持一致的 JWT 签名配置
• 建议配置连接数上限，避免单实例过载

人数压力测

上线前或扩容前，可使用专用 loadtest_room 与 loadtest/concurrent-join.ts 做并发连接与消息打点；生产务必关闭压测房或限制访问。详见 人数压力测。

文档站静态资源（VitePress）

• 默认 base 为 /，打包后 HTML 会引用以 / 开头的资源（如 /assets/...），适合站点挂在域名根路径（含 GitHub Pages + 自定义域名，见下）。
• GitHub Pages 自定义域名：在仓库 Settings → Pages 绑定域名后，对外访问一般为 https://你的域名/（内容在根路径，没有 /仓库名/ 前缀）。此时必须把 VitePress 的 base 设为 '/'，否则 HTML 仍会请求 /仓库名/assets/...，在自定义域名下会 404。
• GitHub Pages 默认子路径（未用自定义域名、仅用 https://<用户>.github.io/<仓库名>/）时，必须把 base 设为 /'<仓库名>/'（首尾都要有 /）。若 base 仍为 /，会出现首页闪一下后变为站内 404（路由按域名根解析，与实际子路径不一致）。
• 不要用 base: './' 代替子路径：多级目录页面上的 ./assets/... 容易解析到错误目录。
• 构建产物目录：docs/.vitepress/dist，可用 npm run docs:build / npm run docs:preview。
• 本地 docs:dev：base 为 / 时从 http://localhost:端口/ 打开即可。若曾使用非根 base（如 /仓库名/），须从 http://localhost:端口/仓库名/ 打开，否则静态资源与 favicon 会请求到错误路径。