> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 环境

> 注入到应用中的平台变量和同级组件 URL。

# 环境

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

## 进程变量

| 变量               | 描述                    | 示例                       |
| ---------------- | --------------------- | ------------------------ |
| `PORT`           | 进程应监听的端口              | `3000`                   |
| `HOST`           | 要绑定的主机                | `0.0.0.0`                |
| `KAZZLE_API_URL` | Kazzle 运行时助手使用的基础 URL | `https://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`），然后将组件指向该集合 + 环境：

```typescript theme={"theme":"material-theme-darker"}
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
```

从生成的应用调用 Kazzle 的 `/ai/*` 端点时使用 `KAZZLE_API_KEY`。切勿通过 `VITE_*` 暴露私钥；这些值会被打包到浏览器代码中。