---
title: 在 Render 上部署 Kaeso
description: 借助仓库里的蓝图，在 Render 上运行它：公开边缘、私有网关和控制台，加上 Render Postgres、Key Value。从主密钥到自己的域名，逐步讲解。
url: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-render
markdown: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-render.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-render.md
  de: https://kaeso.app/de/articles/deploy-kaeso-on-render.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - 自托管
  - render
  - 部署
  - 指南
image: https://kaeso.app/articles/deploy-kaeso-on-render/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# 在 Render 上部署 Kaeso

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

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

- 发布日期：2026年11月11日
- 阅读时间：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，用来生成主密钥：

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

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

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

## 部署

1. 打开 [Deploy to Render](https://render.com/deploy?repo=https://github.com/logicplanes/kaeso/tree/prod)。它会从仓库 `logicplanes/kaeso` 的 `prod` 分支创建一个 **Blueprint**，该分支包含最新版本。
2. 填写蓝图需要的值：

   | 值 | 填写内容 |
   | --- | --- |
   | `KAESO_PUBLIC_URL` | `https://` 加边缘服务的地址，例如 `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` 的修改；该修改通过了本地边缘测试和配置检查，但尚未在实际环境中重新测试。

## 下一步

- [文档中的 Render](https://docs.kaeso.app/zh-CN/self-hosting/platforms/render)，包含蓝图的所有细节。
- [备份和主密钥](https://docs.kaeso.app/zh-CN/self-hosting/backups)：备份 Render Postgres，并把主密钥保存在 Render 之外。
- [在哪里运行 Kaeso](https://kaeso.app/zh-CN/articles/where-to-run-kaeso)：Render 与其他平台的比较。

作者：Kaeso Team

## 更多文章

- [在哪里运行 Kaeso：从一台服务器到托管云](https://kaeso.app/zh-CN/articles/where-to-run-kaeso.md)：Kaeso 0.6.0：在您的服务器上，一条命令即可运行；借助仓库中的模板，也能运行在十个平台上。本文介绍四类路径、每条路径不变的部分，以及如何选择。
- [在 Railway 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-railway.md)：点击 Deploy on Railway，即可在 Railway 上运行，主密钥会自动生成；也可以用 Railway CLI，应用基础设施文件。五个服务、一个公开边缘，加上 Railway Postgres、Redis。

[查看所有文章](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)
