跳到正文

在 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 服务器上,包括请求日志。

您会得到什么

  • 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 个随机字节,也就是主密钥。

部署

  1. 在 Coolify 中打开一个项目,添加一个 Docker Compose Empty 类型的资源。粘贴 prod 分支中的文件,该分支包含最新版本:

    https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/coolify/compose.yaml
  2. 在 edge 服务下,把域名设为 https:// 加您的域名,例如 https://kaeso.example.com,并把它的 DNS 记录指向服务器。Kaeso 需要一个 https 地址。

  3. 如果有 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 服务器
  4. 部署,等待所有服务都健康。

  5. 把 Environment Variables 中的 SERVICE_REALBASE64_32_MASTERKEY 复制到密码管理器。主密钥是 k1: 后接这个值。Kaeso 用它加密服务商密钥,因此没有它,数据库备份就无法读取。

  6. 打开设置链接,创建第一个用户。配置了 SMTP 时,链接会发到 KAESO_SETUP_EMAIL。没有配置时,在服务器上打印它,可以用终端,也可以用 Coolify 中该服务器的终端:

    docker exec $(docker ps --quiet --filter name=gateway-) kaeso setup-link

网关镜像没有 shell,所以 Coolify 中网关容器自己的终端无法运行这条命令;请使用服务器的终端。如果一台服务器上有多个 Kaeso 资源,请把 docker ps 为这个资源列出的网关容器交给 docker exec。

更新和回滚

发布新版本会修改 Compose 文件中的镜像标签。在 Coolify 中打开该资源的 Compose 文件,把 edge、gateway 和 console 的标签改为新版本,然后部署;Coolify 会保留已生成的值。网关在启动时迁移数据库,只向前进行。要回滚,把标签改回之前的版本即可。

须知

  • Kaeso 的更新器不在这里运行,所以控制台无法更新 Kaeso。每个版本都由您在 Coolify 中部署,这样它就和您的其他应用一起集中管理。
  • Coolify 的代理负责终结 TLS。网关会在每个流中写入保活,所以长时间的流不会因代理的空闲超时而中断。

已验证的内容

2026 年 11 月 9 日,该文件在本地 Docker 中运行,服务健康,路径路由和设置链接正常。它尚未部署到 Coolify 服务器上。如果您部署了,请告诉我们结果如何。

下一步

作者:Kaeso Team

本页内容

网关归您。记录也归您。

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