在 Azure 上部署 Kaeso
一台虚拟机运行 Kaeso,用一键部署按钮,或用 Azure CLI 创建。首次启动时,运行安装脚本;通过 Cloud Shell,即可拿到设置链接,无需 SSH。
- 发布日期
- 阅读时间
- 4 分钟
- 作者
- Kaeso Team

Kaeso 的 Azure 模板是一台快速服务器:一台虚拟机上的 Compose 软件包,与您自己的服务器相同,带有负责 TLS 的 Caddy、用于请求日志的内置 ClickHouse 和更新器。它不需要自己的域名就能启动,因为 Azure 会给这台机器一个 DNS 名称,Caddy 会为它获取证书。整个部署大约需要五分钟。
仓库中的 deploy/azure/ 存放 Azure 资源管理器模板,旁边的 createUiDefinition.json 决定门户中表单的样子。
您会得到什么01
- 一个只有一个子网的虚拟网络,以及一个网络安全组:只允许 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 的任何机密。安装脚本会在服务器上生成主密钥和各个密码。
用按钮部署02
- 01打开 Deploy to Azure(在新标签页中打开) 并登录。门户从
prod分支读取模板,该分支包含最新版本。 - 02选择一个订阅、一个新资源组和一个区域,并填写下面的参数。
- 03创建部署,等待它完成。安装脚本运行完毕,部署才会完成。
- 04在部署的 Outputs 下,复制
setupLink,在 Azure Cloud Shell(在新标签页中打开) 或用 Azure CLI 运行它。它无需 SSH 就能打印一次性设置链接。打开该链接,创建第一个用户。 - 05如果有自己的域名,把它的 CNAME 记录指向输出
fqdn,或把 A 记录指向publicIp。Caddy 会一直重试,直到域名能够解析,然后获取证书。
用 Azure CLI 部署03
在仓库的一个克隆中,创建一个资源组,并把模板部署到其中:
az group create --name kaeso --location westeuropeaz 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。
参数04
| 参数 | 含义 |
|---|---|
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 | 区域;默认与资源组相同 |
保存主密钥05
Kaeso 用 /opt/kaeso/master-keys 中的主密钥加密服务商密钥,因此没有它,数据库备份就无法读取。请把一份副本与备份分开保存:运行输出 setupLink 中的命令,把脚本换成 cat /opt/kaeso/master-keys 即可打印它,然后存入密码管理器。
更新06
更新方式与任何 Compose 实例相同:从控制台更新,在您选择的时间窗口内自动更新,或手动更新。模板只负责创建服务器;再次部署它并不会更新 Kaeso。
须知07
- 这里只有快速服务器。仓库中还没有使用 Azure Container Apps、Azure Database for PostgreSQL 和托管缓存的模板。
- 这些规格都是 x64 的。如需 Arm64 规格,请部署 Arm64 版的 Ubuntu 24.04,并手动运行安装脚本。
已验证的内容08
模板通过了 Microsoft 的 ARM 模板测试工具包。它尚未从空白的 Azure 账户部署过;同一个安装脚本已在 AWS 和 Google Cloud 上部署过。如果您部署了,请告诉我们结果如何。
下一步09
- 文档中的 Azure(在新标签页中打开),包含每个参数。
- 升级(在新标签页中打开):更新器如何安装新版本。
- 在哪里运行 Kaeso:Azure 与其他平台的比较。
作者:Kaeso Team


