Anydocs Documents
部署与发布

部署到静态托管

用静态产物完成通用部署,而不是绑定某个特定平台脚本。

Anydocs 的公开站点产物是静态文件,所以部署的核心不是“跑哪个平台命令”,而是先构建,再把输出目录整体交给任意静态托管服务。你应把部署理解成对 `build` 结果的发布,而不是对 Studio 或源码仓库直接上线。

Steps

  1. 先构建公开产物
  2. 检查输出目录是否完整
  3. 把整个输出目录交给静态托管
  4. 上线后验证公开边界

先构建公开产物

从文档项目根目录运行 `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 接口的源码项目。