---
title: 在 Google Cloud 上部署 Kaeso
description: 在 Google Cloud 上，有两套 Terraform 配置，可运行 Kaeso。快速服务器：在 Cloud Shell 中，把 Compose 软件包，装进一台虚拟机（Compute Engine）；托管配置：运行在 Cloud Run 上，配有负载均衡器、Cloud SQL、Memorystore。
url: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-google-cloud
markdown: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-google-cloud.md
language: zh-CN
alternates:
  en: https://kaeso.app/articles/deploy-kaeso-on-google-cloud.md
  de: https://kaeso.app/de/articles/deploy-kaeso-on-google-cloud.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - 自托管
  - google-cloud
  - 部署
  - 指南
image: https://kaeso.app/articles/deploy-kaeso-on-google-cloud/cover.jpg
index: https://kaeso.app/zh-CN/llms.txt
---

# 在 Google Cloud 上部署 Kaeso

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

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

- 发布日期：2026年11月11日
- 阅读时间：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](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/logicplanes/kaeso&cloudshell_git_branch=prod&cloudshell_workspace=deploy/gcp/quick-server)。它会克隆包含最新版本的 `prod` 分支，并打开这个文件夹。Cloud Shell 中有 `terraform` 而没有 `tofu`，所以请使用前者：

```bash
cd deploy/gcp/quick-server
tofu init
tofu 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` |
| `domain` | Kaeso 应答的域名；不设 `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 记录。

```bash
cd deploy/gcp/managed
tofu init
tofu 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 和格式检查，尚未部署过。

## 下一步

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

作者：Kaeso Team

## 更多文章

- [在 Azure 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-azure.md)：一台虚拟机运行 Kaeso，用一键部署按钮，或用 Azure CLI 创建。首次启动时，运行安装脚本；通过 Cloud Shell，即可拿到设置链接，无需 SSH。
- [在 Coolify 上部署 Kaeso](https://kaeso.app/zh-CN/articles/deploy-kaeso-on-coolify.md)：用一个 Compose 文件，部署到您自己的服务器。所有密码和主密钥，由 Coolify 生成；它的代理负责 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)
