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

# 在 Coolify 上部署 Kaeso

用一个 Compose 文件，部署到您自己的服务器。所有密码和主密钥，由 Coolify 生成；它的代理负责 TLS；PostgreSQL、ClickHouse 和 Valkey，在 Kaeso 旁边运行。

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

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

如果您已经在自己的服务器上运行 [Coolify](https://coolify.io)，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` 分支中的文件，该分支包含最新版本：

   ```text
   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_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 服务器 |

4. 部署，等待所有服务都健康。
5. 把 **Environment Variables** 中的 `SERVICE_REALBASE64_32_MASTERKEY` 复制到密码管理器。主密钥是 `k1:` 后接这个值。Kaeso 用它加密服务商密钥，因此没有它，数据库备份就无法读取。
6. 打开设置链接，创建第一个用户。配置了 SMTP 时，链接会发到 `KAESO_SETUP_EMAIL`。没有配置时，在服务器上打印它，可以用终端，也可以用 Coolify 中该服务器的终端：

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

## 下一步

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

作者：Kaeso Team

## 更多文章

- [在 Google Cloud 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-google-cloud.md)：在 Google Cloud 上，有两套 Terraform 配置，可运行 Kaeso。快速服务器：在 Cloud Shell 中，把 Compose 软件包，装进一台虚拟机（Compute Engine）；托管配置：运行在 Cloud Run 上，配有负载均衡器、Cloud SQL、Memorystore。
- [在 Dokploy 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-dokploy.md)：导入它的模板，部署到您自己的服务器。Traefik 负责 TLS；所有密码和主密钥，由模板生成；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)
