跳到正文

在 Google Cloud 上部署 Kaeso

在 Google Cloud 上,有两套 Terraform 配置,可运行 Kaeso。快速服务器:在 Cloud Shell 中,把 Compose 软件包,装进一台虚拟机(Compute Engine);托管配置:运行在 Cloud Run 上,配有负载均衡器、Cloud SQL、Memorystore。

发布日期
阅读时间
4 分钟
作者
Kaeso Team
浓郁的深浅蓝色渐变,沿对角线向下折叠,一角透着暖光

Kaeso 仓库中的 deploy/gcp/ 有两套 Terraform 配置,OpenTofu 同样可以应用它们。快速服务器是一台虚拟机上的 Compose 软件包,与您自己的服务器相同。托管配置在 Cloud Run 上运行 Kaeso,使用 Google 的数据存储,适合一台机器已经不够用的实例。

快速服务器

deploy/gcp/quick-server/ 会创建一台运行 Ubuntu 24.04 的 Compute Engine 实例、一个静态地址、允许 HTTP、HTTPS 和 HTTP/3 的防火墙规则、只对您选择的地址范围开放的 SSH,以及可选的 Cloud DNS 记录。首次启动时,实例会运行 Kaeso 的安装脚本:它安装 Docker,写入设置,并启动 Compose 软件包,其中包括 Caddy、内置 ClickHouse 和更新器。

最快的方式是 Open in Cloud Shell(在新标签页中打开)。它会克隆包含最新版本的 prod 分支,并打开这个文件夹。Cloud Shell 中有 terraform 而没有 tofu,所以请使用前者:

cd deploy/gcp/quick-servertofu inittofu apply -var project=my-project -var domain=kaeso.example.com \  -var 'ssh_source_ranges=["203.0.113.0/24"]'
变量含义
project、region、zone实例运行的位置;默认是 europe-west3-a
domainKaeso 应答的域名;不设 dns_zone 时,请把它的 A 记录指向输出 public_ip
kaeso_version要安装的版本;留空则安装最新的稳定版本
machine_type、disk_size_gb默认是 e2-medium 和 40 GB
ssh_source_ranges谁可以访问 SSH,kaeso setup-link 需要它
dns_zone该域名的一个 Cloud DNS 托管区域,用于创建它的记录

实例启动、证书签发后,运行输出 setup_link,打印用于创建第一个用户的一次性链接。从那以后,控制台中的更新就可以使用,与任何 Compose 实例一样。

托管配置

deploy/gcp/managed/ 用 Google Cloud 服务搭建 Kaeso:

  • 一个 VPC,带一个子网、一个无服务器 VPC 连接器和专用服务访问通道;
  • 只有私有地址的 Cloud SQL for PostgreSQL 17,以及使用 noeviction、只能经由 VPC 访问的 Memorystore for Valkey;
  • Secret Manager 中的机密,保存主密钥、PostgreSQL URL、SMTP 密码和 ClickHouse URL,由网关的服务账号读取;
  • 网关的 Cloud Run 服务,默认 2 个 CPU 和 4 GB,至少保持一个实例预热,请求超时为一小时;以及控制台的 Cloud Run 服务。两者都只能通过负载均衡器访问;
  • 一个全局外部 Application Load Balancer,使用托管证书,把 HTTP 重定向到 HTTPS,用路径规则区分网关和控制台,并为长时间的流设置一小时的后端超时;
  • 可选的 Cloud DNS 记录。
cd deploy/gcp/managedtofu inittofu apply -var project=my-project -var domain=kaeso.example.com \  -var "master_keys=$(docker run --rm ghcr.io/logicplanes/kaeso-gateway:0.6.0 master-key generate)" \  -var setup_email=owner@example.com -var smtp_host=smtp.example.com \  -var smtp_user=kaeso -var smtp_password=secret \  -var 'smtp_from=Kaeso <kaeso@example.com>'

请在密码管理器中保存一份主密钥的副本:Kaeso 用它加密服务商密钥。gateway_cpu、gateway_memory、gateway_min_instances 和 gateway_max_instances 决定网关的规格,多个实例通过 Valkey 共享限额、缓存和路由的冷却状态。database_tier、database_disk_gb 和 cache_node_type 决定数据存储的规格。如需请求日志,把 clickhouse_url 设为一个 ClickHouse,例如 ClickHouse Cloud。

域名指向负载均衡器的地址后,托管证书才会签发,这可能需要一小时。之后,网关会把一次性设置链接发送到 setup_email。

访问 Memorystore 时不用密码、不用 TLS,只经由私有网络,因为网关无法出示 Google 的 IAM 令牌,也无法使用它的私有证书颁发机构。网关只信任来自负载均衡器代理地址范围和 Cloud Run 自身前端的 X-Forwarded-For。

更新和回滚

在快速服务器上,可以从控制台更新,也可以自动更新或手动更新。在托管配置上,发布新版本会修改 main.tf 中的镜像标签:应用新配置后,Cloud Run 会创建新的修订版本,并在它们健康后切换流量。网关在启动时迁移数据库,只向前进行。如需主动回滚,应用上一个版本的配置,或在 Cloud Run 中把流量切回上一个修订版本。

已验证的内容

2026 年 11 月 7 日,快速服务器部署在 europe-west3 的一个新项目中,使用第 8 个候选版本。它创建了第一个用户,在同一个 HTTPS 来源上提供控制台和 API,流式发送了五个事件且文本正好为 Kaeso stream works.,把请求写入了 ClickHouse,并忽略了一个伪造的 X-Forwarded-For 地址。托管配置在 CI 中经过 lint 和格式检查,尚未部署过。

下一步

作者:Kaeso Team

本页内容

网关归您。记录也归您。

curl -fsSLhttps://kaeso.app/install.sh | sh