部署与发布
部署到静态托管
用静态产物完成通用部署,而不是绑定某个特定平台脚本。
Anydocs 的公开站点产物是静态文件,所以部署的核心不是“跑哪个平台命令”,而是先构建,再把输出目录整体交给任意静态托管服务。你应把部署理解成对 `build` 结果的发布,而不是对 Studio 或源码仓库直接上线。
Steps
- 先构建公开产物
- 检查输出目录是否完整
- 把整个输出目录交给静态托管
- 上线后验证公开边界
先构建公开产物
从文档项目根目录运行 `build`。如果不传 `--output`,默认写到项目下的 `dist/`;也可以显式输出到单独目录,便于 CI 或托管平台上传。
npx @anydocs/cli build ./my-docs-project
npx @anydocs/cli build ./my-docs-project --output ./build检查输出目录是否完整
部署前至少确认输出目录里有站点入口、语言目录、静态资源目录,以及 `llms.txt`、`search-index.<lang>.json`、`mcp/` 等公开机器可读产物。缺哪些文件,通常说明页面状态、语言配置或构建输入本身有问题。
build/
index.html
_next/
zh/
en/
llms.txt
search-index.zh.json
mcp/把整个输出目录交给静态托管
无论你用 Nginx、Apache、Vercel、Netlify、Cloudflare Pages、GitHub Pages 还是对象存储,本质动作都一样:上传或复制构建产物目录,不是上传源码项目。对传统服务器来说,通常就是把输出目录同步到静态站点根目录。
cp -r ./build/* <your-static-site-dir>/上线后验证公开边界
部署完成后,检查默认语言入口、几个已发布页面、搜索、`llms.txt` 与 `mcp/` 资源是否可访问。同时确认草稿和评审中的页面没有被暴露。如果你在本地 preview 里也看不到某页,先回到页面状态检查,而不是先怀疑托管平台。
适合的平台: 常见静态托管平台包括 Nginx / Apache、Vercel、Netlify、Cloudflare Pages、GitHub Pages、AWS S3 或 OSS。
不要直接部署源码: 部署对象应该是 `build` 产物目录,而不是包含 `pages/`、`navigation/`、Studio 代码或本地 authoring 接口的源码项目。