在哪里运行 Kaeso:从一台服务器到托管云
Kaeso 0.6.0:在您的服务器上,一条命令即可运行;借助仓库中的模板,也能运行在十个平台上。本文介绍四类路径、每条路径不变的部分,以及如何选择。
- 发布日期
- 阅读时间
- 5 分钟
- 作者
- Kaeso Team

Kaeso 是一个您自己运行的网关,所以第一个问题就是:在哪里运行。在 0.6.0 之前,答案是一台装有 Docker 的服务器。现在有 11 种:用一条命令装在您自己的服务器上,或用 Kaeso 仓库(在新标签页中打开)中的模板部署到 10 个平台,每个模板都固定为一个版本。
本指南按路径的类别整理它们,说明每条路径都保持不变的内容,并帮您做出选择。每个平台都有自己的指南,链接见下文。
您自己的服务器,一条命令01
在任何拥有公开域名的 Linux 服务器或 Mac 上:
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 记录和证书,并打印用于创建第一个用户的链接。控制台中的更新从首次启动起就能使用。
大多数实例都应该走这条路径。下面的所有路径,都是在别人的基础设施上运行同一个版本。
四类路径02
- 平台模板
- 是什么
- 平台读取的文件:公开边缘、私有网关和控制台,以及平台的 PostgreSQL 和 Valkey
- 快速服务器
- 是什么
- 一台运行 Compose 软件包的虚拟机,与您自己的服务器相同
- 托管生产环境
- 是什么
- 云的容器、负载均衡器、PostgreSQL 和 Valkey,机密保存在云的密钥存储中
- 自托管平台
- 是什么
- 您自己服务器上的 Compose 文件或一键应用,位于平台的代理之后
| 路径 | 是什么 | 平台 |
|---|---|---|
| 平台模板 | 平台读取的文件:公开边缘、私有网关和控制台,以及平台的 PostgreSQL 和 Valkey | Render、Railway、DigitalOcean、Fly.io |
| 快速服务器 | 一台运行 Compose 软件包的虚拟机,与您自己的服务器相同 | AWS、Azure、Google Cloud |
| 托管生产环境 | 云的容器、负载均衡器、PostgreSQL 和 Valkey,机密保存在云的密钥存储中 | AWS、Google Cloud |
| 自托管平台 | 您自己服务器上的 Compose 文件或一键应用,位于平台的代理之后 | Coolify、Dokploy、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 就和您的其他应用并排运行。
每条路径都保持不变的内容03
无论选哪条路径,实例的行为都一样:
- 同一来源。 控制台和 API 在同一个域名上应答。
/v1、/v1beta、/v2、/platform、/mcp、/oauth和/.well-known/oauth-*到达网关,其他所有路径到达控制台。在大多数平台上,由控制台镜像的第二个命令kaeso-edge负责这种路由;在 DigitalOcean 上由应用的 ingress 规则负责,在托管堆栈上由负载均衡器负责,在快速服务器上由 Caddy 负责。 - 流不被缓冲。 边缘服务立即转发每个数据块,负载均衡器的等待时间长于网关的保活间隔。
- 只相信平台代理给出的客户端地址。 边缘服务从代理设置、调用方无法伪造的请求头中读取地址,网关只信任边缘服务。
- 健康检查用
/healthz检查进程,用/readyz检查 PostgreSQL、Valkey 和 ClickHouse。指标端口永不公开。 - 同一版本。 网关、控制台和边缘服务固定为同一版本;发布新版本时会更新模板。
在平台上,Kaeso 自己的更新器是关闭的:由平台推出和回滚版本。版本的数据库迁移只向前进行,所以回滚越过某次迁移时,数据库会保持原样,与任何实例一样。
每条路径都需要的内容04
| 需要 | 方式 |
|---|---|
| 主密钥 | 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 用主密钥加密服务商密钥,因此没有主密钥,数据库备份就无法读取。请在平台之外保存一份副本。
已验证的内容05
每篇指南都如实说明了哪些部分在实际环境中部署过,哪些只做过检查。简而言之:Render 蓝图、Railway 按钮和文件,以及 AWS 和 Google Cloud 上的快速服务器,都在候选版本期间从空白账户部署过。边缘服务、Coolify 文件和 Dokploy 模板在本地 Docker 中运行过。DigitalOcean 的规范通过了 App Platform 的校验,Fly.io 文件通过了 fly.toml 模式检查,Azure 模板通过了 Microsoft 的模板测试工具包,托管堆栈通过了 CI 中的 lint 检查。文档中的平台页面(在新标签页中打开)保存着完整的记录。
如果您在实际测试尚未完成的平台上部署了 Kaeso,我们很想知道结果:告诉我们,或在 GitHub(在新标签页中打开) 上提交 issue。
作者:Kaeso Team


