---
title: 在 Azure 上部署 Kaeso
description: 一台虚拟机运行 Kaeso，用一键部署按钮，或用 Azure CLI 创建。首次启动时，运行安装脚本；通过 Cloud Shell，即可拿到设置链接，无需 SSH。
url: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-azure
markdown: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-azure.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-azure.md
  de: https://kaeso.app/de/articles/deploy-kaeso-on-azure.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - 自托管
  - azure
  - 部署
  - 指南
image: https://kaeso.app/articles/deploy-kaeso-on-azure/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# 在 Azure 上部署 Kaeso

一台虚拟机运行 Kaeso，用一键部署按钮，或用 Azure CLI 创建。首次启动时，运行安装脚本；通过 Cloud Shell，即可拿到设置链接，无需 SSH。

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

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

Kaeso 的 Azure 模板是一台快速服务器：一台虚拟机上的 Compose 软件包，与您自己的服务器相同，带有负责 TLS 的 Caddy、用于请求日志的内置 ClickHouse 和更新器。它不需要自己的域名就能启动，因为 Azure 会给这台机器一个 DNS 名称，Caddy 会为它获取证书。整个部署大约需要五分钟。

仓库中的 `deploy/azure/` 存放 Azure 资源管理器模板，旁边的 `createUiDefinition.json` 决定门户中表单的样子。

## 您会得到什么

- 一个只有一个子网的虚拟网络，以及一个网络安全组：只允许 HTTP、HTTPS 和 HTTP/3 进入，SSH 只对您给出的地址范围开放。
- 一个静态公共地址，带有 `<region>.cloudapp.azure.com` 下的 DNS 名称。
- 一台 Ubuntu 24.04 虚拟机，启用受信任启动和启动诊断，带 40 GB 磁盘，默认是 `Standard_B2als_v2`，2 个 vCPU 和 4 GB 内存。
- 一个自定义脚本扩展，在首次启动时运行 Kaeso 的安装脚本：它安装 Docker，写入设置，并启动 Compose 软件包。

模板中不含 Kaeso 的任何机密。安装脚本会在服务器上生成主密钥和各个密码。

## 用按钮部署

1. 打开 [Deploy to Azure](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Flogicplanes%2Fkaeso%2Fprod%2Fdeploy%2Fazure%2Fquick-server.json/createUIFormUri/https%3A%2F%2Fraw.githubusercontent.com%2Flogicplanes%2Fkaeso%2Fprod%2Fdeploy%2Fazure%2FcreateUiDefinition.json) 并登录。门户从 `prod` 分支读取模板，该分支包含最新版本。
2. 选择一个订阅、一个新资源组和一个区域，并填写下面的参数。
3. 创建部署，等待它完成。安装脚本运行完毕，部署才会完成。
4. 在部署的 **Outputs** 下，复制 `setupLink`，在 [Azure Cloud Shell](https://shell.azure.com) 或用 Azure CLI 运行它。它无需 SSH 就能打印一次性设置链接。打开该链接，创建第一个用户。
5. 如果有自己的域名，把它的 CNAME 记录指向输出 `fqdn`，或把 A 记录指向 `publicIp`。Caddy 会一直重试，直到域名能够解析，然后获取证书。

## 用 Azure CLI 部署

在仓库的一个克隆中，创建一个资源组，并把模板部署到其中：

```bash
az group create --name kaeso --location westeurope
az deployment group create --resource-group kaeso \
  --template-file deploy/azure/quick-server.json \
  --parameters domain=kaeso.example.com \
  adminPasswordOrKey="$(cat ~/.ssh/id_ed25519.pub)" sshSourceAddress=203.0.113.0/24
```

部署完成后，该命令会打印各项输出。像上面第 4 步那样，运行其中的 `setupLink`。

## 参数

| 参数 | 含义 |
| --- | --- |
| `domain` | Kaeso 应答的域名；留空则使用该地址的 DNS 名称 |
| `dnsLabel` | 该地址在 `<region>.cloudapp.azure.com` 下的 DNS 名称；留空则根据资源组生成 |
| `kaesoVersion` | 要安装的版本；留空则安装最新的稳定版本 |
| `vmSize`、`diskSizeGb`、`diskType` | 默认是 `Standard_B2als_v2`、40 GB 和标准 SSD |
| `adminUsername`、`authenticationType`、`adminPasswordOrKey` | 服务器的管理员，使用 SSH 公钥或密码 |
| `sshSourceAddress` | 可以访问 SSH 的地址范围；留空则保持端口 22 关闭 |
| `location` | 区域；默认与资源组相同 |

## 保存主密钥

Kaeso 用 `/opt/kaeso/master-keys` 中的主密钥加密服务商密钥，因此没有它，数据库备份就无法读取。请把一份副本与备份分开保存：运行输出 `setupLink` 中的命令，把脚本换成 `cat /opt/kaeso/master-keys` 即可打印它，然后存入密码管理器。

## 更新

更新方式与任何 Compose 实例相同：从控制台更新，在您选择的时间窗口内自动更新，或手动更新。模板只负责创建服务器；再次部署它并不会更新 Kaeso。

## 须知

- 这里只有快速服务器。仓库中还没有使用 Azure Container Apps、Azure Database for PostgreSQL 和托管缓存的模板。
- 这些规格都是 x64 的。如需 Arm64 规格，请部署 Arm64 版的 Ubuntu 24.04，并手动运行安装脚本。

## 已验证的内容

模板通过了 Microsoft 的 ARM 模板测试工具包。它尚未从空白的 Azure 账户部署过；同一个安装脚本已在 AWS 和 Google Cloud 上部署过。如果您部署了，[请告诉我们](https://kaeso.app/zh-CN/contact)结果如何。

## 下一步

- [文档中的 Azure](https://docs.kaeso.app/zh-CN/self-hosting/platforms/azure)，包含每个参数。
- [升级](https://docs.kaeso.app/zh-CN/self-hosting/upgrades)：更新器如何安装新版本。
- [在哪里运行 Kaeso](https://kaeso.app/zh-CN/articles/where-to-run-kaeso)：Azure 与其他平台的比较。

作者：Kaeso Team

## 更多文章

- [在 AWS 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-aws.md)：在 AWS 上运行 Kaeso，有两个模板，都基于 CloudFormation。快速服务器，一键把 Compose 软件包，装进一台 Graviton 实例；托管堆栈，运行在 ECS Fargate 上，配有负载均衡器、RDS 和 ElastiCache。
- [在 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。

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