---
title: 在哪里运行 Kaeso：从一台服务器到托管云
description: Kaeso 0.6.0：在您的服务器上，一条命令即可运行；借助仓库中的模板，也能运行在十个平台上。本文介绍四类路径、每条路径不变的部分，以及如何选择。
url: https://kaeso.app/zh-CN/articles/where-to-run-kaeso
markdown: https://kaeso.app/zh-CN/articles/where-to-run-kaeso.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/where-to-run-kaeso.md
  de: https://kaeso.app/de/articles/where-to-run-kaeso.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - 自托管
  - 部署
  - 指南
image: https://kaeso.app/articles/where-to-run-kaeso/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# 在哪里运行 Kaeso：从一台服务器到托管云

Kaeso 0.6.0：在您的服务器上，一条命令即可运行；借助仓库中的模板，也能运行在十个平台上。本文介绍四类路径、每条路径不变的部分，以及如何选择。

> Kaeso 的所有页面、文章和文档页面都列在 https://kaeso.app/zh-CN/llms.txt 中。

- 发布日期：2026年11月11日
- 阅读时间：5 分钟
- 作者：Kaeso Team

Kaeso 是一个您自己运行的网关，所以第一个问题就是：在哪里运行。在 0.6.0 之前，答案是一台装有 Docker 的服务器。现在有 11 种：用一条命令装在您自己的服务器上，或用 [Kaeso 仓库](https://github.com/logicplanes/kaeso)中的模板部署到 10 个平台，每个模板都固定为一个版本。

本指南按路径的类别整理它们，说明每条路径都保持不变的内容，并帮您做出选择。每个平台都有自己的指南，链接见下文。

## 您自己的服务器，一条命令

在任何拥有公开域名的 Linux 服务器或 Mac 上：

```bash
curl -fsSL https://kaeso.app/install.sh | sh -s -- --domain kaeso.example.com
```

安装脚本把最新版本下载到 `./kaeso`，写入设置和主密钥，并启动 Compose 软件包：网关、控制台、PostgreSQL、ClickHouse、Valkey、负责 TLS 的 Caddy，以及更新器。Docker 停止时它会启动 Docker；在 Linux 上，您要求时它还会安装 Docker；它会检查域名的 DNS 记录和证书，并打印用于创建第一个用户的链接。控制台中的**更新**从首次启动起就能使用。

大多数实例都应该走这条路径。下面的所有路径，都是在别人的基础设施上运行同一个版本。

## 四类路径

| 路径 | 是什么 | 平台 |
| --- | --- | --- |
| 平台模板 | 平台读取的文件：公开边缘、私有网关和控制台，以及平台的 PostgreSQL 和 Valkey | [Render](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-render)、[Railway](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-railway)、[DigitalOcean](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-digitalocean)、[Fly.io](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-fly-io) |
| 快速服务器 | 一台运行 Compose 软件包的虚拟机，与您自己的服务器相同 | [AWS](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-aws)、[Azure](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-azure)、[Google Cloud](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-google-cloud) |
| 托管生产环境 | 云的容器、负载均衡器、PostgreSQL 和 Valkey，机密保存在云的密钥存储中 | [AWS](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-aws)、[Google Cloud](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-google-cloud) |
| 自托管平台 | 您自己服务器上的 Compose 文件或一键应用，位于平台的代理之后 | [Coolify](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-coolify)、[Dokploy](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-dokploy)、[CapRover](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-caprover) |

### 如何选择

- **您想让它运行起来，又不想有自己的服务器：** 选平台模板。Render 和 Railway 点一个按钮就能创建全部内容；DigitalOcean 也一样，Valkey 运行在应用内部。
- **您想在已有的云账户上，运行完整的 Compose 软件包，带更新器，请求日志存在内置的 ClickHouse 中：** 选 AWS、Azure 或 Google Cloud 上的快速服务器。
- **您预计会有真实流量，并希望由云来托管数据库：** 选 AWS（ECS Fargate、RDS、ElastiCache）或 Google Cloud（Cloud Run、Cloud SQL、Memorystore）上的托管堆栈。它们需要区域、域名、证书和规格，所以不是一键部署。
- **您已经在运行 Coolify、Dokploy 或 CapRover：** 使用它们的模板，Kaeso 就和您的其他应用并排运行。

## 每条路径都保持不变的内容

无论选哪条路径，实例的行为都一样：

- **同一来源。** 控制台和 API 在同一个域名上应答。`/v1`、`/v1beta`、`/v2`、`/platform`、`/mcp`、`/oauth` 和 `/.well-known/oauth-*` 到达网关，其他所有路径到达控制台。在大多数平台上，由控制台镜像的第二个命令 `kaeso-edge` 负责这种路由；在 DigitalOcean 上由应用的 ingress 规则负责，在托管堆栈上由负载均衡器负责，在快速服务器上由 Caddy 负责。
- **流不被缓冲。** 边缘服务立即转发每个数据块，负载均衡器的等待时间长于网关的保活间隔。
- **只相信平台代理给出的客户端地址。** 边缘服务从代理设置、调用方无法伪造的请求头中读取地址，网关只信任边缘服务。
- **健康检查**用 `/healthz` 检查进程，用 `/readyz` 检查 PostgreSQL、Valkey 和 ClickHouse。指标端口永不公开。
- **同一版本。** 网关、控制台和边缘服务固定为同一版本；发布新版本时会更新模板。

在平台上，Kaeso 自己的更新器是关闭的：由平台推出和回滚版本。版本的数据库迁移只向前进行，所以回滚越过某次迁移时，数据库会保持原样，与任何实例一样。

## 每条路径都需要的内容

| 需要 | 方式 |
| --- | --- |
| 主密钥 | `docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate`，保存在平台的密钥存储和密码管理器中。有些模板会为您生成 |
| 电子邮件 | 一个 SMTP 服务器。Kaeso 通过邮件发送登录链接、邀请和提醒 |
| 第一个用户 | `KAESO_SETUP_EMAIL`：在第一个用户创建之前，网关每次启动都会把一次性设置链接发到这个地址，因为网关镜像没有 shell |
| 请求日志 | 在 `KAESO_CLICKHOUSE_URL` 中填入外部 ClickHouse，例如 ClickHouse Cloud。不填则请求日志关闭，用量、限额和预算照常工作 |
| 公开地址 | `KAESO_PUBLIC_URL`，用户和应用使用的 `https` 地址 |

Kaeso 用主密钥加密服务商密钥，因此没有主密钥，数据库备份就无法读取。请在平台之外保存一份副本。

## 已验证的内容

每篇指南都如实说明了哪些部分在实际环境中部署过，哪些只做过检查。简而言之：Render 蓝图、Railway 按钮和文件，以及 AWS 和 Google Cloud 上的快速服务器，都在候选版本期间从空白账户部署过。边缘服务、Coolify 文件和 Dokploy 模板在本地 Docker 中运行过。DigitalOcean 的规范通过了 App Platform 的校验，Fly.io 文件通过了 `fly.toml` 模式检查，Azure 模板通过了 Microsoft 的模板测试工具包，托管堆栈通过了 CI 中的 lint 检查。[文档中的平台页面](https://docs.kaeso.app/zh-CN/self-hosting/platforms)保存着完整的记录。

如果您在实际测试尚未完成的平台上部署了 Kaeso，我们很想知道结果：[告诉我们](https://kaeso.app/zh-CN/contact)，或在 [GitHub](https://github.com/logicplanes/kaeso/issues) 上提交 issue。

作者：Kaeso Team

## 更多文章

- [用别名路由，实现回退、条件和分流](https://kaeso.app/zh-CN/articles/alias-routes.md)：在 Kaeso 0.6.0 中，别名带有一条路由。模型失败时，回退到另一个模型；把企业流量或长提示词，发往别处；按调用方，对两个模型做 A/B 测试。这一切，应用代码一行都不用改。
- [在 Render 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-render.md)：借助仓库里的蓝图，在 Render 上运行它：公开边缘、私有网关和控制台，加上 Render Postgres、Key Value。从主密钥到自己的域名，逐步讲解。

[查看所有文章](https://kaeso.app/zh-CN/articles.md)

## 网关归您。记录也归您

```bash
curl -fsSL https://kaeso.app/install.sh | sh
```

[安装 Kaeso](https://docs.kaeso.app/zh-CN/self-hosting/installation) · [打开在线演示](https://demo.kaeso.app)
