运行时配置

支持环境感知的配置,可在运行时访问。
nitro.config.ts
import { defineConfig } from "nitro";

export default defineConfig({
  serverDir: "./",
  runtimeConfig: {
    apiKey: "",
  },
});

运行时配置允许你定义可在运行时被环境变量覆盖的配置值。

定义配置模式

nitro.config.ts 中声明带有默认值的运行时配置:

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

export default defineConfig({
  serverDir: "./",
  runtimeConfig: {
    apiKey: "",
  },
});

在运行时访问

使用 useRuntimeConfig 在你的处理程序中访问配置值:

server.ts
import { defineHandler } from "nitro";
import { useRuntimeConfig } from "nitro/runtime-config";

export default defineHandler((event) => {
  const runtimeConfig = useRuntimeConfig();
  return { runtimeConfig };
});

环境变量

通过带有 NITRO_ 前缀的环境变量覆盖配置值:

.env
# 切勿提交敏感数据。这仅用于演示目的。
NITRO_API_KEY=secret-api-key

了解更多