Nimbus 站点默认构建为静态文件，因此任何能提供文件的主机都能运行它。Astro 的部署指南涵盖各主机的设置。
前置条件
- 一个 Nimbus 站点。用
--deploy other创建可跳过 Cloudflare 文件，或从现有站点删除wrangler.jsonc以及deploy、predeploy和preview:cf脚本。
步骤
-
设置站点地址
在
astro.config.ts中，把 Nimbus 配置里的site设为读者将使用的地址。在 Netlify 和 Vercel 的生产构建中，当site仍是占位符时，Nimbus 会从主机读取地址。 -
构建
npm run build yarn run build pnpm run build bun run build -
发布输出
将
dist/目录上传到主机，或把主机的构建设置指向npm run build，并把dist作为输出目录。
验证
打开部署后的地址，然后打开首页的 Markdown 版本 /index.md。两者都能加载：主机正在提供 HTML 和智能体文件。
使用服务器
按请求渲染、远程 MCP 服务器和页面 URL 上的 Markdown需要服务器。为你的主机添加适配器：
npx @cloudflare/nimbus-docs add adapter-node
yarn nimbus-docs add adapter-node
pnpm nimbus-docs add adapter-node
bunx @cloudflare/nimbus-docs add adapter-node对于 Netlify 或 Vercel，使用 adapter-netlify 或 adapter-vercel。在 Node 上，安装器会添加一个 start 脚本 node ./dist/server/entry.mjs。要创建带服务器的新站点，向脚手架传入 --adapter。
重定向与响应头
astro.config.ts 中的重定向会应用于所有主机。旧的 Markdown 和 llms.txt URL 也需要主机规则；参见重定向。Nimbus 会把响应头写入 _headers，Cloudflare 和 Netlify 以外的主机可能会忽略它；请在主机自身的配置中设置发现响应头。
从 CI 部署
“最后更新”行和 sitemap 的日期来自 git 历史，而大多数 CI 系统只克隆最新提交。在 GitHub Actions 的 checkout 步骤设置 fetch-depth: 0，或在构建前运行 git fetch --unshallow。
GitHub Pages
本站就是通过 GitHub Pages 发布的，可以作为最小可用的参考：
.github/workflows/deploy.yml在每次推送到main时用 Bun 安装依赖、执行bun run build，并把dist/作为 Pages 产物上传。- 仓库的 Settings → Pages 中，Source 选择 GitHub Actions。
- 自定义域名在 Pages 设置中填写（本站为
nimbus.ndjp.net），并添加对应的 DNS 记录：四条 A 记录指向 GitHub Pages 的地址，或一条 CNAME 指向<owner>.github.io。 - 证书签发后启用 Enforce HTTPS，HTTP 请求会自动 301 到 HTTPS。
如果站点部署在子路径而不是自定义域名根路径，请先阅读在路径下提供服务。