跳到正文

在 Render 上部署 Kaeso

借助仓库里的蓝图,在 Render 上运行它:公开边缘、私有网关和控制台,加上 Render Postgres、Key Value。从主密钥到自己的域名,逐步讲解。

发布日期
阅读时间
4 分钟
作者
Kaeso Team
淡雅的橙色、粉色与紫色渐变,沿对角线向上折叠,一角透着暖光

Render 读取蓝图 render.yaml,并创建其中的每个服务。Kaeso 的仓库根目录就有一个蓝图,固定为最新版本。它在 5 个 Render 资源上运行 Kaeso,其中只有一个是公开的。

您会得到什么

  • kaeso-edge
    类型
    Web Service
    镜像
    控制台镜像,运行 kaeso-edge
    套餐
    0.5 CPU,512 MB
  • kaeso-gateway
    类型
    Private Service
    镜像
    网关镜像
    套餐
    2 CPU,4 GB
  • kaeso-console
    类型
    Private Service
    镜像
    控制台镜像
    套餐
    0.5 CPU,512 MB
  • kaeso-valkey
    类型
    Key Value
    镜像
    Render 提供,noeviction
    套餐
    256 MB
  • kaeso-postgres
    类型
    Postgres
    镜像
    Render 提供,版本 18
    套餐
    1 CPU,2 GB

只有边缘服务是公开的。它通过 Render 的私有网络,把 API、MCP 服务器及其登录发往网关,把其他所有路径发往控制台。Postgres 和 Key Value 的 ipAllowList 为空,因此只有这些服务能访问它们。每个服务都设置了 autoDeployTrigger: off:Render 不会因提交而重新部署,您的实例会停留在您选择的版本上。

在创建蓝图之前修改套餐或区域;之后 Render 会保留它们。

开始之前

您需要一个 Render 账户、一个用于 Kaeso 邮件的 SMTP 服务器,以及电脑上的 Docker,用来生成主密钥:

docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate

把这个密钥保存在密码管理器中。Kaeso 用它加密服务商密钥,因此没有它,数据库备份就无法读取。

如需请求日志,还需要一个 ClickHouse,例如 ClickHouse Cloud。没有它,请求日志关闭,用量、限额和预算照常工作。

部署

  1. 打开 Deploy to Render(在新标签页中打开)。它会从仓库 logicplanes/kaeso 的 prod 分支创建一个 Blueprint,该分支包含最新版本。

  2. 填写蓝图需要的值:

    值填写内容
    KAESO_PUBLIC_URLhttps:// 加边缘服务的地址,例如 https://kaeso-edge.onrender.com
    KAESO_MASTER_KEYS主密钥
    KAESO_SETUP_EMAIL您的邮箱地址;网关把设置链接发送到这里
    KAESO_SMTP_HOST、KAESO_SMTP_USER、KAESO_SMTP_PASSWORD、KAESO_SMTP_FROM您的 SMTP 服务器
    KAESO_CLICKHOUSE_URL带用户名和密码的 ClickHouse HTTP URL,或留空
  3. 应用蓝图,等待所有服务上线。

  4. 打开网关发送到 KAESO_SETUP_EMAIL 的一次性设置链接,创建第一个用户。在有用户之前,网关每次启动都会发送一个新链接。

接下来,在控制台中添加一个服务商密钥,创建一个项目密钥,然后向 https://kaeso-edge.onrender.com/v1 发送第一个请求。

使用自己的域名

在 kaeso-edge 的 Settings 中添加域名,并按 Render 的提示设置 DNS 记录。然后把 kaeso-gateway 的 KAESO_PUBLIC_URL 设为 https:// 加该域名,并重新部署网关。

客户端地址如何保持真实

Kaeso 的限额、日志和审计条目都会记录客户端的地址,所以它不能是调用方可以编造的东西。公开流量在到达 Render 之前经过 Cloudflare,而 Render 会追加到调用方的 X-Forwarded-For 后面,而不是替换它。因此边缘服务读取由 Cloudflare 覆盖的 CF-Connecting-IP,并只向网关传递一个地址。网关只信任边缘服务。

网关在端口 8080 上监听,并把指标保留在回环地址上,因为 Render 把私有服务在所有接口上绑定的那一个端口当作其端口。

更新和回滚

发布新版本会修改 prod 上 render.yaml 中的镜像标签。在蓝图页面上,Manual sync 会按新版本重新部署各服务,网关在启动时迁移数据库。要回滚,在每个服务上使用 Rollback 回到上一次部署。迁移只向前进行,因此如果回滚越过的版本,其迁移是旧版本无法运行的,数据库会保持原样,与任何实例一样。

已验证的内容

2026 年 11 月 7 日,在候选版本期间,蓝图从法兰克福的空白 Render 项目创建。它创建了全部五个资源,设置邮件送达,健康与就绪检查通过,一次流式补全进入了控制台的请求日志。测试还发现 Render 会追加 X-Forwarded-For,由此有了上文改读 CF-Connecting-IP 的修改;该修改通过了本地边缘测试和配置检查,但尚未在实际环境中重新测试。

下一步

作者:Kaeso Team

本页内容

网关归您。记录也归您。

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