用途:为 Next.js 15.5/16 应用提供部署与生产化配置指引,适用于部署到 Vercel、自托管 Node.js、Docker 容器、静态导出到 CDN,以及搭建 CI/CD 与生产监控。
主要能力:
- 输出模式:默认用于 Vercel/Node.js 托管;output: 'standalone' 用于 Docker 容器;output: 'export' 用于无 SSR 的静态托管。
- 部署命令:Vercel 用 vercel --prod;Node.js 自托管用 npm run build && npm start;Docker 用 docker build -t app .;静态导出执行 npm run build 后产物在 out/。
- 环境变量:开发用 .env.local,生产用 .env.production,运行时用平台密钥;Vercel 可用 vercel env add 与 vercel env pull。
- 运行时:默认 Node.js 具备完整功能;Edge 通过 export const runtime = 'edge' 启用,速度快但 API 受限。
- 生产配置:next.config.js 中可配置图片优化、安全响应头、重定向、实验特性(如 ppr);vercel.json 可配置构建命令、区域、函数内存与超时、headers、redirects、rewrites。
- 自托管:支持自定义 server.ts、PM2 进程管理(ecosystem.config.js、pm2 start/monit/logs)。
- Docker:提供多阶段 Dockerfile 与 docker-compose.yml 示例,standalone 模式可减小镜像。
- 静态导出限制:无服务端渲染、无 API 路由、无中间件、无 ISR,图片优化需外部服务。
- 监控与 CI/CD:可接入 Sentry 错误追踪、Vercel Analytics 与 Speed Insights;GitHub Actions 工作流示例包含安装依赖、测试、构建与部署到 Vercel。
- 生产检查:健康检查端点、环境变量清单、缓存与压缩、性能监控等最佳实践。
使用方式:按目标平台选择输出模式与命令,配置 next.config.js 与平台配置文件,设置环境变量后构建部署;容器场景使用 standalone 输出与 Dockerfile。
适用场景:Vercel 部署、自托管 Node.js、Docker 容器化、静态 CDN 托管、CI/CD 流水线与生产监控。
限制:静态导出不支持 SSR、API 路由、中间件与 ISR;Edge Runtime 可用 API 有限;具体收费、价格与平台效果资料未提供。