跳到正文

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

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

发布日期
阅读时间
5 分钟
作者
Kaeso Team
浓郁的兰花紫与粉色渐变,呈柔和的水平褶皱

Kaeso 是一个您自己运行的网关,所以第一个问题就是:在哪里运行。在 0.6.0 之前,答案是一台装有 Docker 的服务器。现在有 11 种:用一条命令装在您自己的服务器上,或用 Kaeso 仓库(在新标签页中打开)中的模板部署到 10 个平台,每个模板都固定为一个版本。

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

您自己的服务器,一条命令

在任何拥有公开域名的 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 记录和证书,并打印用于创建第一个用户的链接。控制台中的更新从首次启动起就能使用。

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

四类路径

  • 平台模板
    是什么
    平台读取的文件:公开边缘、私有网关和控制台,以及平台的 PostgreSQL 和 Valkey
  • 快速服务器
    是什么
    一台运行 Compose 软件包的虚拟机,与您自己的服务器相同
  • 托管生产环境
    是什么
    云的容器、负载均衡器、PostgreSQL 和 Valkey,机密保存在云的密钥存储中
  • 自托管平台
    是什么
    您自己服务器上的 Compose 文件或一键应用,位于平台的代理之后

如何选择

  • 您想让它运行起来,又不想有自己的服务器: 选平台模板。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 检查。文档中的平台页面(在新标签页中打开)保存着完整的记录。

如果您在实际测试尚未完成的平台上部署了 Kaeso,我们很想知道结果:告诉我们,或在 GitHub(在新标签页中打开) 上提交 issue。

作者:Kaeso Team

本页内容

网关归您。记录也归您。

curl -fsSLhttps://kaeso.app/install.sh | sh