> ## 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.

# 部署

> 将应用部署到生产环境和本地设备。

# 部署

Kazzle 应用可以部署到 Kazzle 的托管服务，或安装到设备电脑上。

## 远程部署

部署是异步的：从应用页面、AI 或检出代码中运行 `kazzle deploy` 都会在服务器端排队一个部署任务。`kazzle deploy` 上传你的检出代码；部署运行器负责构建和发布。

对于每个组件：

1. **UI 组件**被构建成 Docker 镜像，运行 `runtime.prod.build`（如果设置了的话），否则运行 `bun run build`
2. **Process 组件**从 `kazzle.config.ts` 中运行其 `runtime.prod.command` 命令 - 如果缺少该命令，部署会失败
3. 每个组件都有自己的镜像和部署
4. 分配一个生产 URL

从应用页面或通过 AI 触发部署：

```
Deploy my app
```

## 生产 URL

已部署的应用会获得类似 `https://kazzle-{appId}.kazzle.app` 的 URL。拥有多个 process 组件的应用每个组件都会获得一个 URL。公开应用可被任何拥有该 URL 的人访问。私有应用需要 Kazzle 身份验证。

## 生产环境中的运行时命令

| 阶段                     | 命令                             | 时机                   |
| ---------------------- | ------------------------------ | -------------------- |
| `runtime.prod.build`   | 生产构建命令，或在省略时使用 `bun run build` | 部署 UI 组件期间           |
| `runtime.prod.command` | `kazzle.config.ts` 中的生产启动命令    | 在生产环境中，启动 process 组件 |

生产命令必须是裸命令（例如 `bun server/index.ts`）- 已部署的运行时会直接注入 `PORT`、`HOST` 和密钥。详见 [Kazzle CLI](/apps/cli) 页面了解开发/生产环境的区分。

## 本地安装

应用也可以通过 Kazzle 守护进程在设备电脑（你的本地机器）上运行。`runtime.dev.command` 命令以开发模式启动应用。