NNext.js 中文网 GitHub

部署

了解如何部署你的 Next.js 应用程序。

Next.js 可以部署为 Node.js 服务器、Docker 容器、静态导出,或经过适配以在不同平台上运行。

部署选项功能支持
Node.js 服务器全部
Docker 容器全部
静态导出有限
适配器各不相同(已验证的适配器会运行测试套件)

Node.js 服务器#

Next.js 可以部署到任何支持 Node.js 的提供商。请确保你的 package.json 中包含 "build" 和 "start" 脚本:

package.json
{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start"
  }
}

然后,运行 npm run build 来构建你的应用程序,并运行 npm run start 启动 Node.js 服务器。该服务器支持所有 Next.js 功能。如果需要,你还可以改用自定义服务器。

Node.js 部署支持所有 Next.js 功能。了解如何为你的基础设施配置它们。

模板#

Docker#

Next.js 可以部署到任何支持 Docker 容器的提供商。这包括像 Kubernetes 这样的容器编排工具,或运行 Docker 的云提供商。有关容器化应用的最佳实践,请参阅 Docker 官方的 Next.js 和 React.js 指南。

Docker 部署支持所有 Next.js 功能。了解如何为你的基础设施配置它们。

开发注意事项: 虽然 Docker 非常适合生产部署,但在 Mac 和 Windows 上进行开发时,考虑使用本地开发(npm run dev)而非 Docker,以获得更好的性能。了解更多关于优化本地开发的信息。

模板#

以下示例展示了容器化 Next.js 应用程序的最佳实践:

  • Docker 独立输出 - 使用 output: "standalone" 部署 Next.js 应用程序,生成一个仅包含所需运行时文件和依赖的最小化、可用于生产的 Docker 镜像。
  • Docker 导出输出 - 使用 output: "export" 部署完全静态的 Next.js 应用程序,生成优化的 HTML 文件,可由轻量级容器或任何静态托管环境提供服务。
  • Docker 多环境 - 为开发、预发布和生产环境管理独立的 Docker 配置,使用不同的环境变量。

此外,托管提供商也提供了有关部署 Next.js 的指导:

静态导出#

Next.js 使你能够以静态站点或单页应用程序(SPA)的形式起步,之后可选择升级以使用需要服务器的功能。

由于 Next.js 支持静态导出,它可以部署并托管在任何能够提供 HTML/CSS/JS 静态资源的 Web 服务器上。这包括 AWS S3、Nginx 或 Apache 等工具。

以静态导出方式运行不支持需要服务器的 Next.js 功能。了解更多。

模板#

适配器#

Next.js 可以通过适配在不同平台上运行,以支持它们的基础设施能力。部署适配器 API让平台能够自定义 Next.js 应用程序的构建和部署方式。

已验证的适配器#

已验证的适配器是开源的,会运行完整的 Next.js 兼容性测试套件,并托管在 Next.js GitHub 组织下。Next.js 团队会在重大版本发布前与这些平台协调测试。每个适配器的公开测试结果即将推出。了解更多关于已验证适配器的信息。

Cloudflare 和 Netlify 正在开发基于 Adapter API 的已验证适配器。与此同时,它们提供了自己的 Next.js 集成(见下文)。

其他平台#

以下平台提供了自己的 Next.js 集成。这些集成并非基于公开的 Adapter API 构建,也未经过 Next.js 团队的验证,因此功能支持和兼容性可能有所不同。有关详细信息,请参阅各提供商的文档:

有关哪些 Next.js 功能需要特定平台能力的详细信息,请参阅部署到平台。

Next.js 中文网