> ## 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_*` 公開私密金鑰；這些值會被組合到瀏覽器程式碼中。