在 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,全部固定为同一版本。
您会得到什么01
edge- 镜像
- 控制台镜像,运行
kaeso-edge - 谁能访问
- 所有人,通过 Traefik 访问模板的域名
gateway- 镜像
- 网关镜像
- 谁能访问
- 边缘服务
console- 镜像
- 控制台镜像
- 谁能访问
- 边缘服务
postgres、clickhouse、valkey- 镜像
- 与 Compose 软件包相同的版本
- 谁能访问
- 网关
| 服务 | 镜像 | 谁能访问 |
|---|---|---|
edge | 控制台镜像,运行 kaeso-edge | 所有人,通过 Traefik 访问模板的域名 |
gateway | 网关镜像 | 边缘服务 |
console | 控制台镜像 | 边缘服务 |
postgres、clickhouse、valkey | 与 Compose 软件包相同的版本 | 网关 |
每个服务都保留了 Compose 软件包的加固措施:禁止获取新权限,移除除数据存储所需之外的所有 Linux capabilities,Kaeso 自己的服务使用只读根文件系统,并设置内存和进程限制。网关以 kaeso 身份登录 PostgreSQL,该用户拥有自己的数据库,但不是超级用户。
template.toml 为边缘服务在端口 8080 上配置一个域名,并设置环境:随机密码来自 Dokploy 的 hash 辅助函数,由 32 个随机字节组成的主密钥来自它的 base64 辅助函数。在您添加 SMTP 服务器之前,邮件只会被记录。
部署02
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_TRANSPORT | smtp 表示发送邮件;默认值 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 中网关容器的终端无法运行这条命令;请使用服务器的终端。
更新和回滚03
发布新版本会修改 docker-compose.yml 中的镜像标签。在 Dokploy 中打开该服务的 Compose 文件,把 edge、gateway 和 console 的标签改为新版本,然后部署;环境会保持不变。网关在启动时迁移数据库,只向前进行。要回滚,把标签改回之前的版本即可。
须知04
- Kaeso 的更新器不在这里运行,所以控制台无法更新 Kaeso;每个版本都由您在 Dokploy 中部署。
- Traefik 负责终结 TLS。网关会在每个流中写入保活,所以长时间的流不会因代理的空闲超时而中断。
已验证的内容05
2026 年 11 月 9 日,模板中的 Compose 文件在本地 Docker 中运行,服务健康,路径路由和设置链接正常。它尚未导入到 Dokploy 服务器上。如果您导入了,请告诉我们结果如何。
下一步06
- 备份和主密钥(在新标签页中打开):备份服务器上的卷。
- 在哪里运行 Kaeso:Dokploy 与其他平台的比较。
作者:Kaeso Team


