blog.dopana

返回

在通过 Cloudflare Workers 构建全球分布式应用时,代码运行在全球 300 多个边缘数据中心,能够以几毫秒的极低延迟响应终端用户。然而,像 Google Cloud SQL for PostgreSQL 这样的关系型数据库,通常部署在特定的单一云区域(例如美国爱荷华州的 us-central1 或新加坡的 asia-southeast1)。

当全球边缘无服务器计算(Serverless Edge)遇上集中式关系型数据库时,开发者会面临两大严峻挑战:连接建立的高网络延迟 与 数据库连接数耗尽(connection exhaustion)。Cloudflare Hyperdrive 便是解决该痛点的核心基础设施。

1. 核心问题:为什么边缘访问中心化数据库如此缓慢?#

在传统的单体或集群架构中,后端 API 服务器与 PostgreSQL 位于同一个数据中心或局域网(VPC)内,两者之间的网络握手延迟通常小于 1ms。

但在 Serverless 边缘环境下,连接机制发生了巨大变化:

  1. 多轮网络往返握手(Handshake Overhead): 当位于东京的 Worker 需要查询位于美国的 Cloud SQL 实例时,每次建立连接都需要执行:
    • DNS 解析
    • TCP 三次握手(1 RTT)
    • TLS/SSL 安全协商(1–2 RTT)
    • PostgreSQL 身份验证(MD5 或 SCRAM-SHA-256)(1–2 RTT) 跨越太平洋往返累计需要 6 到 8 次网络 Round-Trip(RTT)。在执行第一条 SQL 语句之前,仅仅建立连接就需要耗费 200ms 至 500ms!
  2. 连接数耗尽风险: Serverless 实例按需并发伸缩。若短时间内涌入 5,000 个请求,就会有 5,000 个独立的 Worker 实例尝试与 PostgreSQL 建立长连接,这会迅速耗尽数据库内存并击穿 Cloud SQL 的 max_connections 上限。
采用 Cloudflare Hyperdrive 方案传统直连方案:无 Hyperdrive1. TCP 握手2. TLS 协商3. Postgres SCRAM 认证消耗 6-8 个 RTT ~ 300-500ms4. 发送 SQL 查询就近边缘本地连接 ~1ms命中缓存时毫秒级返回维护长效热连接池消除了新建连接的 RTT 损耗Edge Worker - 东京GCP Cloud SQL - us-central1Edge Worker - 东京Hyperdrive 边缘引擎GCP Cloud SQL - us-central1

2. 浅显易懂的比喻(ELI5)#

[!TIP] 全球便利店与远方银行金库的比喻: 想象你在全球各大城市的街区开办了数千家便利店(Edge Workers)。但所有账目的总账本,锁在美国一家银行的地下重型金库里(GCP Cloud SQL)。

  • 没有 Hyperdrive 时: 东京店每当有顾客问:“这瓶绿茶多少钱?”,店员就必须买机票飞到美国,经过层层门禁安检、登记签字、打开金库翻看账本,再坐飞机回东京回答顾客。不仅机票昂贵,顾客还要等上好几天。
  • 有了 Hyperdrive 时: Hyperdrive 就好比在银行金库里派驻了一名常驻全权代表,并拉了一条 7x24 小时不挂断的加密专线热线(连接池 Connection Pooling)。同时,每家便利店收银台前都放着一本小备忘录(查询缓存 Query Caching)。顾客查价格?看一眼柜台小册子 1 毫秒搞定;如果发生新记账,店员拿起热线直接报给金库代表,瞬间更新,无需亲自飞去美国!

3. 网络架构方案:公网 IP vs 私网 IP(VPC)#

将 Cloudflare Hyperdrive 连接到 GCP Cloud SQL 时,通常有两种主流网络接入模式:

方案 2: 私网 IP / VPC 隧道方案 1: 公网 IP 直连Cloudflare 全球边缘网络基于公共互联网的 TLS 加密连接Cloudflare Tunnel TCPVPC 内部私有 IP 10.x.x.xCloudflare WorkerHyperdriveCloud SQL - 公网 IP授权网络白名单GCE 虚拟机cloudflared 守护进程Cloud SQL - 私网 IP

方案 1:Cloud SQL 启用公网 IP(Public IP)#

  • 特点: 配置最为便捷迅速。
  • 安全性保障: 必须在 Cloud SQL 上强制启用“仅允许 SSL 连接”,并在已授权网络(Authorized Networks)中加入 Cloudflare Hyperdrive 的回源出口 IP 段。所有传输数据均全程经过 TLS 强加密。

方案 2:Cloud SQL 纯私网 IP(VPC)通过 Cloudflare Tunnel / GCE 代理#

  • 特点: 极致安全,Cloud SQL 完全不暴露任何公网 IP(仅分配 10.x.x.x 内网地址)。
  • 实现路径: 在相同的 VPC 子网内启动一台轻量级 GCE 虚拟机(如 e2-micro),运行 cloudflared 守护进程建立 Cloudflare Tunnel(或部署 Cloud SQL Auth Proxy)。Hyperdrive 通过该私有隧道直通内网数据库,无需开放外部入站防火墙端口。

4. 实战配置步骤#

步骤 1:准备 GCP Cloud SQL PostgreSQL#

  1. 确认 PostgreSQL 实例正常运行。
  2. 创建专用应用账户并赋予权限:
    CREATE USER worker_app WITH PASSWORD 'your_super_secure_password';
    GRANT CONNECT ON DATABASE my_production_db TO worker_app;
    GRANT USAGE ON SCHEMA public TO worker_app;
    GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO worker_app;
    sql
  3. 若使用公网 IP,在 Google Cloud Console 进入 Cloud SQL > 实例 > 连接 > 网络:
    • 勾选 公网 IP。
    • 开启 仅允许 SSL 连接。
    • 在 已授权网络 中添加 Cloudflare Hyperdrive 出口 IP 段。

步骤 2:通过 Wrangler CLI 创建 Hyperdrive 配置#

在终端中执行命令,创建对应的 Hyperdrive 资源:

Terminal
wrangler hyperdrive create gcp-postgres-hyperdrive \
  --connection-string="postgres://worker_app:your_super_secure_password@34.123.45.67:5432/my_production_db?sslmode=require"
bash

执行成功后,控制台会输出分配的配置 ID:

Output
✅ Successfully created Hyperdrive configuration
📋 Details:
  ID: fc7a9b12c3454e6789a0bcdef1234567
  Name: gcp-postgres-hyperdrive
  Host: 34.123.45.67
  Port: 5432
  Database: my_production_db
  User: worker_app
bash

步骤 3:在 wrangler.toml 中配置 Binding#

在 Worker 项目的配置文件中绑定该 Hyperdrive 实例:

wrangler.toml
name = "my-fast-api"
main = "src/index.ts"
compatibility_date = "2026-09-01"
compatibility_flags = ["nodejs_compat"]

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "fc7a9b12c3454e6789a0bcdef1234567"
toml

[!IMPORTANT] compatibility_flags = ["nodejs_compat"] 是必填配置,用于在 Cloudflare Workers V8 环境中启用 Node.js 标准 socket 与流协议支持。

步骤 4:编写 Worker 业务代码#

Hyperdrive 会通过 env.HYPERDRIVE.connectionString 注入就近边缘数据中心的代理连接串,Worker 会与就近的边缘连接池通信。

方式 A:使用 node-postgres (pg)#

安装依赖:

Terminal
npm install pg
npm install --save-dev @types/pg
bash

编写接口:

方式 B:使用轻量高效的 postgres.js#

步骤 5:通过 Cloudflare Tunnel 接入内网私有 Cloud SQL(进阶)#

若数据库仅具备 VPC 私有 IP:

  1. 在数据库所在 VPC 子网启动一台小规格 GCE 实例(如 e2-micro)。
  2. 在 GCE 上安装并初始化 cloudflared:
    cloudflared tunnel create gcp-sql-tunnel
    bash
  3. 配置 TCP 流量代理:
    /etc/cloudflared/config.yml
    tunnel: <TUNNEL_UUID>
    credentials-file: /etc/cloudflared/<TUNNEL_UUID>.json
    
    ingress:
      - hostname: db-private.yourdomain.com
        service: tcp://10.128.0.5:5432 # Cloud SQL 私网 IP
      - service: http_status:404
    yaml
  4. 创建 Hyperdrive 时使用 Cloudflare Access 凭证进行安全鉴权:
    Terminal
    wrangler hyperdrive create gcp-postgres-hyperdrive \
      --connection-string="postgres://worker_app:secret@db-private.yourdomain.com:5432/my_production_db" \
      --access-client-id="<CLIENT_ID>" \
      --access-client-secret="<CLIENT_SECRET>"
    bash

5. Hyperdrive 智能查询缓存的工作机制#

Hyperdrive 具备完整的 PostgreSQL 协议感知能力,超越了常规的连接池中间件(如 PgBouncer):

  • 只读查询自动缓存(SELECT): 自动解析并缓存幂等的只读查询,后续相同查询直接在 Cloudflare 边缘秒级返回,甚至无需经过回源链路。
  • 写后读强一致性保证(Read-Your-Own-Writes): 一旦会话中开启事务(BEGIN ... COMMIT)或触发写入语句(INSERT、UPDATE、DELETE),Hyperdrive 会自动将后续查询路由回源站,杜绝读到陈旧缓存脏数据。
  • TTL 精细控制: 支持自定义缓存有效期,平衡实时性与源站数据库降载。

6. 总结#

结合 Cloudflare Hyperdrive 与 Google Cloud SQL for PostgreSQL,你能够轻松兼得两者的核心优势:

  1. 全球就近毫秒级响应: Cloudflare Workers 全球边缘计算。
  2. 彻底抹平成倍握手延迟: 连接耗时从几百毫秒降至近乎零开销。
  3. 保护源站数据库安全与负载: 有效规避连接数爆满崩溃,并显著降低 Cloud SQL 实例的计算资源消耗。

参考资料#