Netlify

将 Nitro 应用部署到 Netlify 函数或边缘。

预设: netlify

Read more in Netlify 函数.

Note

与此提供商的集成可以通过零配置实现。

通常,将应用部署到 Netlify 不需要任何配置。 Nitro 会自动检测你处于 Netlify 构建环境中,并构建正确版本的服务器。

对于新站点,Netlify 会检测到你正在使用 Nitro,并将发布目录设置为 dist,将构建命令设置为 npm run build。如果你正在升级现有站点,请检查这些设置,并在需要时更新它们。

要添加自定义重定向,请使用 routeRules,或将 _redirects 文件添加到你的 public 目录中。

要进行部署,只需像平常为 Netlify 执行的那样推送到你的 git 仓库即可

Note

创建新项目时,请确保发布目录设置为 dist

#Netlify 边缘函数

预设: netlify_edge

Netlify Edge Functions 使用 Deno 和强大的 V8 JavaScript 运行时,让你可以运行全局分布的函数,以实现最快的响应时间。

Read more in Netlify 边缘函数.

使用此预设时,Nitro 会直接在边缘运行服务器,使其距离用户更近。

Note

创建新项目时,请确保发布目录设置为 dist

#Netlify 静态

预设: netlify_static

使用 netlify_static 预设预渲染你的应用,并将其作为完全静态站点(无函数)部署到 Netlify。

#自定义部署配置

你可以在 nitro.config 中使用 netlify.config 键提供额外的部署配置。它遵循 Netlify Frameworks APIconfig.json 格式,并会与内置的自动生成配置合并。

nitro.config.ts
import { defineConfig } from "nitro";

export default defineConfig({
  netlify: {
    config: {
      // Netlify Image CDN remote images
      images: {
        remote_images: ["https://example.com/.*"],
      },
      // Custom headers
      headers: [{ for: "/static/*", values: { "cache-control": "public, max-age=31536000" } }],
      // Custom redirects
      redirects: [{ from: "/old", to: "/new", status: 301 }],
    },
  },
});

支持的键:

Note

顶层的 netlify.images 选项已弃用。请改用 netlify.config.images