在 Coolify 上部署 Kaeso
用一个 Compose 文件,部署到您自己的服务器。所有密码和主密钥,由 Coolify 生成;它的代理负责 TLS;PostgreSQL、ClickHouse 和 Valkey,在 Kaeso 旁边运行。
- 发布日期
- 阅读时间
- 4 分钟
- 作者
- Kaeso Team

如果您已经在自己的服务器上运行 Coolify(在新标签页中打开),Kaeso 就只是再多一个资源。仓库中的 deploy/coolify/compose.yaml 是专为它准备的 Docker Compose 文件:Coolify 代理之后的公开边缘、私有网关和控制台,以及与 Compose 软件包相同的 PostgreSQL、ClickHouse 和 Valkey,全部固定为同一版本。
与云平台不同,这里不需要外部数据库或 ClickHouse:所有内容都运行在您的 Coolify 服务器上,包括请求日志。
您会得到什么01
edge- 镜像
- 控制台镜像,运行
kaeso-edge - 谁能访问
- 所有人,通过 Coolify 的代理访问您的域名
gateway- 镜像
- 网关镜像
- 谁能访问
- 边缘服务
console- 镜像
- 控制台镜像
- 谁能访问
- 边缘服务
postgres、clickhouse、valkey- 镜像
- 与 Compose 软件包相同的版本
- 谁能访问
- 网关
| 服务 | 镜像 | 谁能访问 |
|---|---|---|
edge | 控制台镜像,运行 kaeso-edge | 所有人,通过 Coolify 的代理访问您的域名 |
gateway | 网关镜像 | 边缘服务 |
console | 控制台镜像 | 边缘服务 |
postgres、clickhouse、valkey | 与 Compose 软件包相同的版本 | 网关 |
每个服务都保留了 Compose 软件包的加固措施:禁止获取新权限,移除除数据存储所需之外的所有 Linux capabilities,Kaeso 自己的服务使用只读根文件系统,并设置内存和进程限制。网关以 kaeso 身份登录 PostgreSQL,该用户拥有自己的数据库,但不是超级用户。Valkey 从不驱逐任何键,所以 Valkey 写满时会拒绝写入,而不是丢弃限额计数器。
Coolify 会填写名称以 SERVICE_ 开头的每个值:SERVICE_URL_EDGE_8080 是边缘服务的地址,各个 SERVICE_PASSWORD_… 值是随机密码,SERVICE_REALBASE64_32_MASTERKEY 是 32 个随机字节,也就是主密钥。
部署02
- 01
在 Coolify 中打开一个项目,添加一个 Docker Compose Empty 类型的资源。粘贴
prod分支中的文件,该分支包含最新版本:https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/coolify/compose.yaml - 02
在
edge服务下,把域名设为https://加您的域名,例如https://kaeso.example.com,并把它的 DNS 记录指向服务器。Kaeso 需要一个https地址。 - 03
如果有 SMTP 服务器,在 Environment Variables 下填写:
变量 填写内容 KAESO_MAIL_TRANSPORTsmtp表示发送邮件;默认值log只记录每封邮件的类型KAESO_SETUP_EMAIL您的邮箱地址;配置 SMTP 后,网关把设置链接发送到这里 KAESO_SMTP_HOST、KAESO_SMTP_PORT、KAESO_SMTP_TLS、KAESO_SMTP_USER、KAESO_SMTP_PASSWORD、KAESO_SMTP_FROM您的 SMTP 服务器 - 04
部署,等待所有服务都健康。
- 05
把 Environment Variables 中的
SERVICE_REALBASE64_32_MASTERKEY复制到密码管理器。主密钥是k1:后接这个值。Kaeso 用它加密服务商密钥,因此没有它,数据库备份就无法读取。 - 06
打开设置链接,创建第一个用户。配置了 SMTP 时,链接会发到
KAESO_SETUP_EMAIL。没有配置时,在服务器上打印它,可以用终端,也可以用 Coolify 中该服务器的终端:docker exec $(docker ps --quiet --filter name=gateway-) kaeso setup-link
网关镜像没有 shell,所以 Coolify 中网关容器自己的终端无法运行这条命令;请使用服务器的终端。如果一台服务器上有多个 Kaeso 资源,请把 docker ps 为这个资源列出的网关容器交给 docker exec。
更新和回滚03
发布新版本会修改 Compose 文件中的镜像标签。在 Coolify 中打开该资源的 Compose 文件,把 edge、gateway 和 console 的标签改为新版本,然后部署;Coolify 会保留已生成的值。网关在启动时迁移数据库,只向前进行。要回滚,把标签改回之前的版本即可。
须知04
- Kaeso 的更新器不在这里运行,所以控制台无法更新 Kaeso。每个版本都由您在 Coolify 中部署,这样它就和您的其他应用一起集中管理。
- Coolify 的代理负责终结 TLS。网关会在每个流中写入保活,所以长时间的流不会因代理的空闲超时而中断。
已验证的内容05
2026 年 11 月 9 日,该文件在本地 Docker 中运行,服务健康,路径路由和设置链接正常。它尚未部署到 Coolify 服务器上。如果您部署了,请告诉我们结果如何。
下一步06
- 备份和主密钥(在新标签页中打开):备份服务器上的卷。
- 在哪里运行 Kaeso:Coolify 与其他平台的比较。
作者:Kaeso Team


