---
title: 在 AWS 上部署 Kaeso
description: 在 AWS 上运行 Kaeso，有两个模板，都基于 CloudFormation。快速服务器，一键把 Compose 软件包，装进一台 Graviton 实例；托管堆栈，运行在 ECS Fargate 上，配有负载均衡器、RDS 和 ElastiCache。
url: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-aws
markdown: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-aws.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-aws.md
  de: https://kaeso.app/de/articles/deploy-kaeso-on-aws.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - 自托管
  - aws
  - 部署
  - 指南
image: https://kaeso.app/articles/deploy-kaeso-on-aws/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# 在 AWS 上部署 Kaeso

在 AWS 上运行 Kaeso，有两个模板，都基于 CloudFormation。快速服务器，一键把 Compose 软件包，装进一台 Graviton 实例；托管堆栈，运行在 ECS Fargate 上，配有负载均衡器、RDS 和 ElastiCache。

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

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

Kaeso 仓库中的 `deploy/aws/` 有两个 CloudFormation 模板，满足两种不同的需求。**快速服务器**是一台 EC2 实例上的 Compose 软件包，和您自己的服务器完全一样，一键即可启动。**托管堆栈**在 ECS Fargate 上运行 Kaeso，使用 AWS 自己的数据存储，适合一台机器已经不够用的实例。

每个版本都会把这两个模板上传到 `https://kaeso-cloudformation.s3.amazonaws.com/vX.Y.Z/`，稳定版本还会上传到 `latest/`。

## 快速服务器

[Launch on AWS](https://console.aws.amazon.com/cloudformation/home#/stacks/create/review?templateURL=https%3A%2F%2Fkaeso-cloudformation.s3.amazonaws.com%2Flatest%2Fquick-server.yaml&stackName=kaeso) 会在 CloudFormation 中打开已发布的模板。它会创建：

- 一台运行 Ubuntu 24.04 的 Graviton 实例，默认是 `t4g.medium`，带 40 GB 磁盘；
- 一个弹性 IP，以及一个允许 HTTP、HTTPS 和 HTTP/3 的安全组，SSH 只对您选择的地址范围开放；
- 可选的 Route 53 域名记录。

首次启动时，实例会运行 Kaeso 的安装脚本。它安装 Docker，写入设置，生成主密钥，并启动 Compose 软件包，其中包括 Caddy、用于请求日志的内置 ClickHouse 和更新器。所以控制台中的**更新**可以使用，与任何 Compose 实例一样。

在 CLI 中，用仓库的一个克隆：

```bash
aws cloudformation deploy --stack-name kaeso --template-file deploy/aws/quick-server.yaml \
  --parameter-overrides Domain=kaeso.example.com KeyName=my-key \
  AllowedSshCidr=203.0.113.0/24 HostedZoneId=Z0123456789
```

| 参数 | 含义 |
| --- | --- |
| `Domain` | Kaeso 应答的域名；不设 `HostedZoneId` 时，请把它的 A 记录指向输出 `PublicIp` |
| `KaesoVersion` | 要安装的版本；留空则安装最新的稳定版本 |
| `InstanceType`、`DiskSizeGb` | 默认是 `t4g.medium` 和 40 GB |
| `KeyName`、`AllowedSshCidr` | SSH 访问，`kaeso setup-link` 需要它 |
| `HostedZoneId` | 该域名的一个 Route 53 托管区域，用于创建它的记录 |

堆栈创建完成、Caddy 拿到证书后，通过 SSH 运行输出 `SetupLink`。它会打印用于创建第一个用户的一次性链接。

## 托管堆栈

`deploy/aws/managed.yaml` 用 AWS 服务搭建 Kaeso：

- 一个 VPC，包含两个公有子网、两个私有子网和一个 NAT 网关；
- 一个 Application Load Balancer，使用您的 ACM 证书，把 HTTP 重定向到 HTTPS，用路径规则把 API、MCP 服务器及其登录发往网关、其他所有内容发往控制台，并为长时间的流设置 300 秒的空闲超时；
- 一个运行在 Fargate 上、使用 Graviton 的 ECS 集群，位于私有子网中：一个网关服务，默认 2 个任务，每个 2 个 vCPU 和 4 GB；以及一个控制台服务；
- RDS PostgreSQL 18，以及使用 `noeviction`、TLS 和 AUTH 令牌的 ElastiCache Valkey，两者都只有网关能访问；
- Secrets Manager 中的机密，保存主密钥、数据库密码、Valkey 令牌、SMTP 密码和 ClickHouse URL；
- CloudWatch 日志组，以及可选的 Route 53 别名记录。

```bash
aws cloudformation deploy --stack-name kaeso --template-file deploy/aws/managed.yaml \
  --capabilities CAPABILITY_IAM --parameter-overrides \
  Domain=kaeso.example.com \
  CertificateArn=arn:aws:acm:eu-central-1:123456789012:certificate/example \
  MasterKeys="$(docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate)" \
  SetupEmail=owner@example.com SmtpHost=smtp.example.com SmtpUser=kaeso \
  SmtpPassword=secret SmtpFrom="Kaeso <kaeso@example.com>"
```

主密钥也请在密码管理器中保存一份副本：Kaeso 用它加密服务商密钥。其他参数决定堆栈的规格：网关的 `GatewayCpu`、`GatewayMemory` 和 `GatewayCount`，以及数据存储的 `DatabaseInstanceClass`、`DatabaseStorageGb` 和 `CacheNodeType`。多个网关任务通过 Valkey 共享限额、缓存和路由的冷却状态。如需请求日志，把 `ClickHouseUrl` 设为一个 ClickHouse，例如 ClickHouse Cloud；留空则保持关闭。

在第一个用户创建之前，网关会把一次性设置链接发送到 `SetupEmail`。它只信任来自 VPC（负载均衡器节点所在之处）的 `X-Forwarded-For`。负载均衡器检查网关的 `/readyz` 和控制台的 `/healthz`，网关任务停止时有 75 秒的时间处理完剩余请求。

## 更新和回滚

在快速服务器上，可以从控制台更新，也可以在您选择的时间窗口内自动更新，或手动更新，与任何 Compose 实例一样。再次部署模板并不会更新 Kaeso。

在托管堆栈上，发布新版本会修改 `managed.yaml` 中的镜像标签。把新模板部署到堆栈上：ECS 会替换任务，并借助断路器在失败时自动回滚；网关在启动时迁移数据库，只向前进行。如需主动回滚，部署上一个版本的模板即可。

## 已验证的内容

2026 年 11 月 7 日，快速服务器以 CloudFormation 堆栈的形式，在 `us-east-1` 从空白账户启动，使用第 8 个候选版本。在测试实例上把主密钥文件的所有权改回安装脚本之后，它创建了第一个用户，并通过了路由、流式传输和日志记录的检查。模板现在不再更改这个所有权，但修正后的模板尚未从空白账户重新部署。托管堆栈在 CI 中经过 lint 和格式检查，尚未部署过。

## 下一步

- [文档中的 AWS](https://docs.kaeso.app/zh-CN/self-hosting/platforms/aws)，包含每个参数。
- [多个网关](https://docs.kaeso.app/zh-CN/self-hosting/scaling)：一个、两个和三个网关各能承担多少。
- [在哪里运行 Kaeso](https://kaeso.app/zh-CN/articles/where-to-run-kaeso)：AWS 与其他平台的比较。

作者：Kaeso Team

## 更多文章

- [在 Fly.io 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-fly-io.md)：在 Fly.io 上，以四个应用运行，都在私有网络中：边缘服务、网关、控制台和 Valkey；数据库：Fly Managed Postgres。从创建应用，到您自己的证书，每条命令都在这里。
- [在 Azure 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-azure.md)：一台虚拟机运行 Kaeso，用一键部署按钮，或用 Azure CLI 创建。首次启动时，运行安装脚本；通过 Cloud Shell，即可拿到设置链接，无需 SSH。

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