在 Render 上部署 Kaeso
借助仓库里的蓝图,在 Render 上运行它:公开边缘、私有网关和控制台,加上 Render Postgres、Key Value。从主密钥到自己的域名,逐步讲解。
- 发布日期
- 阅读时间
- 4 分钟
- 作者
- Kaeso Team

Render 读取蓝图 render.yaml,并创建其中的每个服务。Kaeso 的仓库根目录就有一个蓝图,固定为最新版本。它在 5 个 Render 资源上运行 Kaeso,其中只有一个是公开的。
您会得到什么01
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
| 服务 | 类型 | 镜像 | 套餐 |
|---|---|---|---|
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 会保留它们。
开始之前02
您需要一个 Render 账户、一个用于 Kaeso 邮件的 SMTP 服务器,以及电脑上的 Docker,用来生成主密钥:
docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate把这个密钥保存在密码管理器中。Kaeso 用它加密服务商密钥,因此没有它,数据库备份就无法读取。
如需请求日志,还需要一个 ClickHouse,例如 ClickHouse Cloud。没有它,请求日志关闭,用量、限额和预算照常工作。
部署03
- 01
打开 Deploy to Render(在新标签页中打开)。它会从仓库
logicplanes/kaeso的prod分支创建一个 Blueprint,该分支包含最新版本。 - 02
填写蓝图需要的值:
值 填写内容 KAESO_PUBLIC_URLhttps://加边缘服务的地址,例如https://kaeso-edge.onrender.comKAESO_MASTER_KEYS主密钥 KAESO_SETUP_EMAIL您的邮箱地址;网关把设置链接发送到这里 KAESO_SMTP_HOST、KAESO_SMTP_USER、KAESO_SMTP_PASSWORD、KAESO_SMTP_FROM您的 SMTP 服务器 KAESO_CLICKHOUSE_URL带用户名和密码的 ClickHouse HTTP URL,或留空 - 03
应用蓝图,等待所有服务上线。
- 04
打开网关发送到
KAESO_SETUP_EMAIL的一次性设置链接,创建第一个用户。在有用户之前,网关每次启动都会发送一个新链接。
接下来,在控制台中添加一个服务商密钥,创建一个项目密钥,然后向 https://kaeso-edge.onrender.com/v1 发送第一个请求。
使用自己的域名04
在 kaeso-edge 的 Settings 中添加域名,并按 Render 的提示设置 DNS 记录。然后把 kaeso-gateway 的 KAESO_PUBLIC_URL 设为 https:// 加该域名,并重新部署网关。
客户端地址如何保持真实05
Kaeso 的限额、日志和审计条目都会记录客户端的地址,所以它不能是调用方可以编造的东西。公开流量在到达 Render 之前经过 Cloudflare,而 Render 会追加到调用方的 X-Forwarded-For 后面,而不是替换它。因此边缘服务读取由 Cloudflare 覆盖的 CF-Connecting-IP,并只向网关传递一个地址。网关只信任边缘服务。
网关在端口 8080 上监听,并把指标保留在回环地址上,因为 Render 把私有服务在所有接口上绑定的那一个端口当作其端口。
更新和回滚06
发布新版本会修改 prod 上 render.yaml 中的镜像标签。在蓝图页面上,Manual sync 会按新版本重新部署各服务,网关在启动时迁移数据库。要回滚,在每个服务上使用 Rollback 回到上一次部署。迁移只向前进行,因此如果回滚越过的版本,其迁移是旧版本无法运行的,数据库会保持原样,与任何实例一样。
已验证的内容07
2026 年 11 月 7 日,在候选版本期间,蓝图从法兰克福的空白 Render 项目创建。它创建了全部五个资源,设置邮件送达,健康与就绪检查通过,一次流式补全进入了控制台的请求日志。测试还发现 Render 会追加 X-Forwarded-For,由此有了上文改读 CF-Connecting-IP 的修改;该修改通过了本地边缘测试和配置检查,但尚未在实际环境中重新测试。
下一步08
- 文档中的 Render(在新标签页中打开),包含蓝图的所有细节。
- 备份和主密钥(在新标签页中打开):备份 Render Postgres,并把主密钥保存在 Render 之外。
- 在哪里运行 Kaeso:Render 与其他平台的比较。
作者:Kaeso Team


