Cloudflare

console.log(process.env.SECRET) // 请注意，这是在全局范围内！因此实际上它不起作用，变量是未定义的！

export default defineEventHandler((event) => {
  // 请注意，所有以下方式都是访问上述变量的有效方法
  useRuntimeConfig(event).helloThere
  useRuntimeConfig(event).secret
  process.env.NITRO_HELLO_THERE
  import.meta.env.SECRET
});

在开发模式中指定变量

在开发时，您可以使用 .env 文件指定环境变量：

NITRO_HELLO_THERE="captain"
SECRET="top-secret"

注意： 请确保将 .env 添加到 .gitignore 文件中，以免您提交它，因为它可能包含敏感信息。

为本地预览指定变量

构建后，当您尝试在本地使用 wrangler dev 或 wrangler pages dev 测试项目时，为了访问环境变量，您需要在项目根目录中指定在 .dev.vars 文件中（如 Pages 和 Workers 文档中所示）。

如果您在开发时使用了 .env 文件，则您的 .dev.vars 应与之相同。

注意： 请确保将 .dev.vars 添加到 .gitignore 文件中，以免您提交它，因为它可能包含敏感信息。

为生产环境指定变量

对于生产环境，请使用 Cloudflare 控制台或 wrangler secret 命令设置环境变量和机密。

使用 `wrangler.toml`/`wrangler.json` 指定变量

您可以指定自定义的 wrangler.toml/wrangler.json 文件，并在其中定义变量。

请注意，这不推荐用于敏感数据，例如机密。

示例：

wrangler.toml

# 共享
[vars]
NITRO_HELLO_THERE="general"
SECRET="secret"

# 为 `--env production` 用法覆盖值
[env.production.vars]
NITRO_HELLO_THERE="captain"
SECRET="top-secret"

直接访问 Cloudflare bindings

绑定允许您与 Cloudflare 平台上的资源交互，这些资源的示例包括键值数据存储 (KVs) 和无服务器 SQL 数据库 (D1s)。

有关绑定的更多详细信息及其用法，请参阅 Cloudflare 的 Pages 和 Workers 文档。

Nitro 提供了高级 API，以便与 KV 存储和数据库交互，强烈建议您优先使用它们，而不是直接依赖低级 API 以确保使用稳定性。

在本地开发中访问绑定

nitro-cloudflare-dev 模块是实验性的。Nitro 团队正在寻找更本地化的集成，这可能在不久的将来使该模块不再需要。

为了在开发模式中访问绑定，我们首先定义绑定。您可以在 wrangler.toml/wrangler.json 文件中完成此操作，或在 Nitro 配置中的 cloudflare.wrangler 下直接完成（接受与 wrangler.json 相同的类型）。

例如，在 wrangler.toml 中定义变量和 KV 命名空间：

wrangler.toml

[vars]
MY_VARIABLE="my-value"

[[kv_namespaces]]
binding = "MY_KV"
id = "xxx"

或在您的 Nitro 配置中：

nitro.config.js

import nitroCloudflareBindings from "nitro-cloudflare-dev";

export default defineNitroConfig({
    cloudflare: {
      wrangler: {
        vars: {
          MY_VARIABLE: "my-value"
        },
        kv_namespaces: [
          {
            binding: "MY_KV",
            id: "xxx"
          }
        ]
      }
    }
});

仅默认环境中的绑定被识别。

接下来，我们安装 nitro-cloudflare-dev 模块和所需的 wrangler 包（如果尚未安装）：

npm i -D nitro-cloudflare-dev wrangler

yarn add -D nitro-cloudflare-dev wrangler

pnpm i -D nitro-cloudflare-dev wrangler

bun i -D nitro-cloudflare-dev wrangler

deno i -D nitro-cloudflare-dev wrangler

然后定义模块：

import nitroCloudflareBindings from "nitro-cloudflare-dev";

export default defineNitroConfig({
  modules: [nitroCloudflareBindings],
});

export default defineNuxtConfig({
  modules: ['nitro-cloudflare-dev']
})

从此时起，当运行

npm run dev

yarn dev

pnpm dev

bun run dev

deno run dev

您将能够从请求事件访问 MY_VARIABLE 和 MY_KV，就像上面所示。

Cleavr

将 Nitro 应用部署到 Cleavr。

Deno Deploy

将 Nitro 应用部署到 Deno Deploy。