跳到正文

在 Dokploy 上部署 Kaeso

导入它的模板,部署到您自己的服务器。Traefik 负责 TLS;所有密码和主密钥,由模板生成;PostgreSQL、ClickHouse 和 Valkey,在 Kaeso 旁边运行。

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

Dokploy(在新标签页中打开) 以 Compose 文件加配置的形式导入模板。Kaeso 仓库中的 deploy/dokploy/ 两者都有:docker-compose.yml 和 template.toml,格式与 Dokploy 自己的模板集相同。它们在您的服务器上运行 Dokploy 的 Traefik 之后的公开边缘、私有网关和控制台,以及 Compose 软件包中的 PostgreSQL、ClickHouse 和 Valkey,全部固定为同一版本。

您会得到什么

  • edge
    镜像
    控制台镜像,运行 kaeso-edge
    谁能访问
    所有人,通过 Traefik 访问模板的域名
  • gateway
    镜像
    网关镜像
    谁能访问
    边缘服务
  • console
    镜像
    控制台镜像
    谁能访问
    边缘服务
  • postgres、clickhouse、valkey
    镜像
    与 Compose 软件包相同的版本
    谁能访问
    网关

每个服务都保留了 Compose 软件包的加固措施:禁止获取新权限,移除除数据存储所需之外的所有 Linux capabilities,Kaeso 自己的服务使用只读根文件系统,并设置内存和进程限制。网关以 kaeso 身份登录 PostgreSQL,该用户拥有自己的数据库,但不是超级用户。

template.toml 为边缘服务在端口 8080 上配置一个域名,并设置环境:随机密码来自 Dokploy 的 hash 辅助函数,由 32 个随机字节组成的主密钥来自它的 base64 辅助函数。在您添加 SMTP 服务器之前,邮件只会被记录。

部署

1. 生成导入文本。 在装有 curl 和 jq 的电脑上,把 prod 分支(包含最新版本)中的模板,转换成 Dokploy 导入用的 Base64 文本:

curl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/docker-compose.ymlcurl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/template.tomljq -n --rawfile compose docker-compose.yml --rawfile config template.toml \  '{compose: $compose, config: $config}' | base64 | tr -d '\n'

2. 导入。 在 Dokploy 中打开一个项目,创建一个 Compose 服务。在 Advanced 下,把文本粘贴到 Import 中。Dokploy 会在应用之前显示 Compose 文件、环境、挂载和域名。

3. 设置域名。 在 Domains 下,把主机改成您的域名,例如 kaeso.example.com,开启使用 Let's Encrypt 的 HTTPS,并把域名的 DNS 记录指向服务器。

4. 填写环境。 在 Environment 下,把 KAESO_PUBLIC_URL 设为 https:// 加该域名;如果有 SMTP 服务器,也一并添加:

变量填写内容
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 服务器

5. 部署,等待所有服务都健康。

6. 保存主密钥。 把 Environment 中的 KAESO_MASTER_KEYS 复制到密码管理器。Kaeso 用它加密服务商密钥,因此没有它,数据库备份就无法读取。

7. 创建第一个用户,使用设置链接。配置了 SMTP 时,链接会发到 KAESO_SETUP_EMAIL。没有配置时,在服务器上打印它,并把 kaeso-example 换成该服务 General 标签页中的应用名称:

docker exec kaeso-example-gateway-1 kaeso setup-link

网关镜像没有 shell,所以 Dokploy 中网关容器的终端无法运行这条命令;请使用服务器的终端。

更新和回滚

发布新版本会修改 docker-compose.yml 中的镜像标签。在 Dokploy 中打开该服务的 Compose 文件,把 edge、gateway 和 console 的标签改为新版本,然后部署;环境会保持不变。网关在启动时迁移数据库,只向前进行。要回滚,把标签改回之前的版本即可。

须知

  • Kaeso 的更新器不在这里运行,所以控制台无法更新 Kaeso;每个版本都由您在 Dokploy 中部署。
  • Traefik 负责终结 TLS。网关会在每个流中写入保活,所以长时间的流不会因代理的空闲超时而中断。

已验证的内容

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

下一步

作者:Kaeso Team

本页内容

网关归您。记录也归您。

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