跳转到主要内容

​
环境

Kazzle 将一小组平台变量注入到应用进程中。你的凭证来自 kazzle.config.ts 中的保险库。

​
进程变量

变量描述示例
PORT进程应监听的端口3000
HOST要绑定的主机0.0.0.0
KAZZLE_API_URLKazzle 运行时助手使用的基础 URLhttps://api.kazzle.app
PORT、HOST 和 KAZZLE_API_URL 为进程组件设置。Kazzle 不会自动为应用进程创建 API 密钥；仅在应用确实需要时才添加显式凭证。 你的进程应绑定到 HOST:PORT。Kazzle 在此基础上处理预览路由和生产域名。

​
同级组件 URL

当应用有多个组件时，Kazzle 可以注入 URL，让一个组件能够访问另一个组件：
变量描述
KAZZLE_APP_COMPONENT_{NAME}_URL运行时同级组件的 URL
名称来自组件的 name 字段：转换为大写，非字母数字字符变为下划线。名为 API Server 的同级组件变为 KAZZLE_APP_COMPONENT_API_SERVER_URL。 这些 URL 在部署的同级组件存在时指向它。否则指向该同级组件的当前开发地址。

​
应用凭证

应用凭证通过密钥集合 + 环境到达组件。在保险库中存储密钥，使用你想要的环境变量名称（例如 KAZZLE_API_KEY），然后将组件指向该集合 + 环境： 
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
从生成的应用调用 Kazzle 的 /ai/* 端点时使用 KAZZLE_API_KEY。切勿通过 VITE_* 暴露私钥；这些值会被打包到浏览器代码中。