Cloudflare

import { defineHandler } from "nitro/h3";

console.log(process.env.SECRET) // 注意这是在全局作用域中！所以它实际上不起作用，变量是 undefined！

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

在开发模式中指定变量

对于开发，你可以使用 .env 或 .env.local 文件来指定环境变量：

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

注意： 确保将 .env 和 .env.local 添加到 .gitignore 文件中，这样你就不会提交它，因为它可能包含敏感信息。

为本地预览指定变量

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

如果你在开发时使用 .env 或 .env.local 文件，你的 .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 绑定

绑定允许你与 Cloudflare 平台的资源交互，此类资源的示例是键值数据存储（KVs）和无服务器 SQL 数据库（D1s）。

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

Nitro 提供了高级 API 来与诸如 KV Storage 和 Database 等原语交互，强烈建议优先使用它们，而不是直接依赖低级 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 { defineNitroConfig } from "nitro/config";
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 npm:-D nitro-cloudflare-dev wrangler

然后定义模块：

nitro.config.js

import nitroCloudflareBindings from "nitro-cloudflare-dev";

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

从这一刻起，当运行

npm run dev

yarn dev

pnpm dev

bun run dev

deno run dev

你将能够从请求事件访问 MY_VARIABLE 和 MY_KV，如上所示。

Cleavr

Deploy Nitro apps to Cleavr.

Deno Deploy

将 Nitro 应用部署到 Deno Deploy。