用途:Cloudflare Hyperdrive 用于让 Cloudflare Workers 连接已有的 PostgreSQL 或 MySQL 数据库,通过边缘连接建立、靠近数据库的连接池和查询缓存,降低从全球 300 多个位置访问单区域数据库的延迟,并缓解连接数限制。
主要能力:支持 PostgreSQL(资料称 v9.0-17.x)与 MySQL(v5.7-8.x);自动缓存只读查询,写操作会使相关缓存失效;支持通过 Wrangler CLI 或 Cloudflare 仪表盘创建配置;支持多个 Hyperdrive 绑定;可与 Drizzle、Prisma 等 ORM 配合(Prisma 需驱动适配器)。
使用方式:先创建配置,例如 npx wrangler hyperdrive create my-postgres-db --connection-string="postgres://user:password@db-host.cloud:5432/database",MySQL 使用 mysql:// 连接串。然后在 wrangler.jsonc 中添加 hyperdrive 绑定,binding 为代码中的访问名(如 HYPERDRIVE),id 为配置 ID;必须启用 nodejs_compat。安装驱动:PostgreSQL 可用 pg 或 postgres,MySQL 用 mysql2。在 Worker 中通过 env.HYPERDRIVE.connectionString 或 host/user/password/database/port 连接并查询,使用 ctx.waitUntil() 在响应后清理连接。本地开发可设置 CLOUDFLARE_HYPERDRIVE_LOCAL_CONNECTION_STRING_<BINDING> 环境变量,或使用 localConnectionString,也可用 npx wrangler dev --remote 连接生产库。
限制与注意:数据库需启用 TLS/SSL,可通过公网或 Cloudflare Tunnel 访问;Workers 并发外部连接上限为 6,连接池 max 建议不超过 5;mysql2 需 disableEval: true;postgres.js 需 prepare: true 才能缓存;ctx.waitUntil() 用于非阻塞清理连接。资料未提供收费、价格与具体性能数据。