部署指南索引
仓库根目录 DEPLOYMENT.md 含更完整的平台说明与排错。
推荐流程
- Vercel 部署（入门）
- 绑定域名
- 流量增大时：静态导出 · Netlify · Cloudflare Pages
全部部署文档
| 文档 | 场景 |
|---|---|
| deploy-vercel.md | Vercel 默认 SSR/ISR |
| vercel-domain.md | 自定义域名 + Cloudflare |
| vercel-accelerate.md | 国内访问加速 |
| vercel-static.md | yarn export 降额度 |
| vercel-redeploy.md | 重新部署 |
| netlify.md | Netlify（4.0.9+） |
| cloudflare-pages.md | Cloudflare 静态 |
| notion-image-proxy.md | Cloudflare Worker 图片反代、浏览器长期缓存与 304 验证 |
| edgeone-pages.md | 腾讯云 EdgeOne（Node 版本、ENOSPC、Next SSG 预设） |
| build-tuning.md | 构建超时 / Notion 预热与限流（环境变量） |
| vps.md | VPS / Docker（Node 22+） |
构建超时排错
若在 Cloudflare、Netlify 等平台出现 timeout of 300 seconds 或 prefetch 极慢，请参阅 构建性能调优（BUILD_PREFETCH_ENABLED、STATIC_PAGE_GENERATION_TIMEOUT 等）。
环境要求（2026）
- Node.js 22（见
.nvmrc/.node-version）。Node 20 已无法安装当前依赖，Cloudflare、Netlify、VPS、Docker 等构建环境都应同步使用 Node 22。 - Yarn：
yarn→yarn build/yarn export - 必配：
NOTION_PAGE_ID
Docker 镜像发布说明
4.10.9 起，主仓库的 GHCR Docker 镜像发布流程会随镜像生成 provenance 与 SBOM attestation。自托管用户如果从 ghcr.io/notionnext-org/notionnext 拉取镜像，可以在 GitHub Packages / Actions 记录中查看镜像来源和依赖清单。
这不会改变本地 Dockerfile 构建方式；如果你仍按 VPS / Docker 教程在服务器上自行 docker build，原流程保持不变。
EdgeOne
Node 版本、磁盘 ENOSPC、框架预设 Next SSG 等见 edgeone-pages.md。构建时若 .next/cache 不可写，项目会回退系统临时目录，见 lib/cache/build_session.js。