---
title: 在 Dokploy 上部署 Kaeso
description: 导入它的模板，部署到您自己的服务器。Traefik 负责 TLS；所有密码和主密钥，由模板生成；PostgreSQL、ClickHouse 和 Valkey，在 Kaeso 旁边运行。
url: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-dokploy
markdown: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-dokploy.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-dokploy.md
  de: https://kaeso.app/de/articles/deploy-kaeso-on-dokploy.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - 自托管
  - dokploy
  - 部署
  - 指南
image: https://kaeso.app/articles/deploy-kaeso-on-dokploy/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# 在 Dokploy 上部署 Kaeso

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

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

- 发布日期：2026年11月11日
- 阅读时间：4 分钟
- 作者：Kaeso Team

[Dokploy](https://dokploy.com) 以 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 文本：

```bash
curl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/logicplanes/kaeso/prod/deploy/dokploy/template.toml
jq -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** 标签页中的应用名称：

```bash
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 服务器上。如果您导入了，[请告诉我们](https://kaeso.app/zh-CN/contact)结果如何。

## 下一步

- [文档中的 Dokploy](https://docs.kaeso.app/zh-CN/self-hosting/platforms/dokploy)。
- [备份和主密钥](https://docs.kaeso.app/zh-CN/self-hosting/backups)：备份服务器上的卷。
- [在哪里运行 Kaeso](https://kaeso.app/zh-CN/articles/where-to-run-kaeso)：Dokploy 与其他平台的比较。

作者：Kaeso Team

## 更多文章

- [在 Coolify 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-coolify.md)：用一个 Compose 文件，部署到您自己的服务器。所有密码和主密钥，由 Coolify 生成；它的代理负责 TLS；PostgreSQL、ClickHouse 和 Valkey，在 Kaeso 旁边运行。
- [在 CapRover 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-caprover.md)：用仓库中的模板，以一键应用的形式，部署到您自己的服务器。共六个应用：一个公开边缘，位于 nginx 之后；PostgreSQL、ClickHouse 和 Valkey，在 Kaeso 旁边运行。

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