- 主站单独部署
- docs 子应用单独部署
推荐方案一:子域名部署
主站
- 仓库根目录作为项目根
- 构建命令:
npm run build - 输出目录:
dist - 绑定域名:
www.tidemind.ai
文档站
- 项目根目录指向
docs/ - 构建命令:
npm run build - 启动命令:
npm run start - 绑定域名:
docs.tidemind.ai
推荐方案二:同域路径 /docs
如果你希望文档挂到主站路径下:
- 主站仍保留在
www.tidemind.ai - 通过网关、Nginx 或平台层的 rewrite / proxy,把
/docs转发到 docs 应用
当前代码里的衔接规则
主站中 docs 链接统一通过环境变量和默认值生成:- 开发环境默认:
http://localhost:3001 - 生产环境默认:
/docs
本地联调
启动主站
启动文档站
构建检查
主站
文档站
搜索索引
文档站在postbuild 中会自动运行 pagefind:
docs/public/_pagefind 供搜索使用。