服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 100 个配置是每个 Workers Paid 账户的配置数量上限;1,500 条是每个配置连接源数据库的上限,两者不能混算。
- 公告提高了可配置的容量上限,没有说明把现有连接池默认值统一改为 1,500,也没有宣布 Free 计划同步提高。
- 源连接限制是分布式连接池的软上限,网络故障等情况下可能短暂超出;多个配置和其他数据库客户端都要纳入总预算。
- 11 月 11 日公告与页面标注 6 月 9 日更新的限制表存在差异;看到旧值时应核对具体账户和当前配置,不能推断全账号到账时间。
这次提高的是哪两个上限?
Cloudflare 2026 年 11 月 11 日的官方变更公告写明:Workers Paid 计划客户现在可创建最多 100 个 Hyperdrive 配置,此前为 25 个;每个配置可设置的源数据库连接上限提高到 1,500,此前为 100。配置数量按账户计算,源连接数量按配置计算。
截至 11 月 12 日核对,当前限制页仍显示付费账户 25 个配置、每配置约 100 条源连接,页面标注的更新日期为 6 月 9 日。本文将新数字作为 11 月 11 日公告的内容报道,同时保留这处文档差异;它不是每个账户已经显示新值的验收证据。
公告没有给出逐账户开放时间、地区名单、价格变化,也没有说明 Free 计划的额度同步提高。不要把付费公告改写成所有账户通用的承诺。
1,500 条源连接,不等于 1,500 个请求
Hyperdrive 在 Workers 与源数据库之间维护连接池。源连接指 Hyperdrive 到数据库的连接,不是用户浏览器的连接数,也不是网站的请求数;不同 Worker 调用可以复用池中的连接,连接通常按事务借出和归还。
连接池调优文档区分了 Workers 到 Hyperdrive 的客户端连接与 Hyperdrive 到数据库的源连接。文档说前者没有 Hyperdrive 层面的并发连接数量限制,这不代表应用、数据库、套餐或其他服务没有限制。
1,500 是公告提高后的付费可配置上限,不是建议值或统一默认值。当前调优文档给出的最小源连接设置是 5;最大值取决于 Workers 计划。现有配置的实际值仍需在该配置中核对。
先给整个数据库留出连接余量
Cloudflare 建议把 Hyperdrive 的源连接限制设在数据库自己的连接限制以下。预算还要计入其他 Hyperdrive 配置、后台任务、管理工具和直接连接数据库的应用,不能只看其中一个配置。
举一个仅用于算术说明的假设:数据库总连接上限为 200,其他客户端预留 40,两个 Hyperdrive 配置各计划使用 60,那么计划总量为 160,账面还剩 40。这个例子不是推荐的生产配置,也不能保证实际连接数不会超过 160。
原因是 Hyperdrive 的源连接限制属于软上限。官方说明,分布式连接池为在网络故障等情况下维持可用性,可能建立额外连接。应结合数据库提供方的限制、连接监控与实际查询负载保留余量,不能把 1,500 当作可以安全用满的数据库容量。
需要调整时,从单个配置开始核对
官方控制台路径是 Storage & databases → Hyperdrive,选择目标配置,再打开 Settings。在 Origin connection limit 下修改 Maximum connections 并保存。先确认账户计划、目标配置及其数据库预算;控制台显示旧值时,保留具体配置和提示信息,向 Cloudflare 核实可用上限。
文档也提供 Wrangler 命令:npx wrangler hyperdrive update <HYPERDRIVE_ID> --origin-connection-limit=<MAX_CONNECTIONS>。占位符必须替换为你有权管理的配置 ID 与经过预算的连接数;这是一条会修改配置的命令,本文没有执行。
REST API 对应 PATCH https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_ID>/hyperdrive/configs/<HYPERDRIVE_ID>,字段名为 origin_connection_limit。调用需要该账户适用的授权;复制路径或命令并不表示修改已经完成,应以实际配置读回和数据库监控为准。
连接错误出现后,先查等待和数据库状态
如果出现 Failed to acquire a connection from the pool.,官方限制页列出的一个常见原因是长查询或长事务占用连接,导致后续请求等不到可用连接。先检查事务时长、查询耗时和连接使用情况,再决定是否需要更大的池。
Server connection attempt failed: connection_refused 表示源端拒绝了连接尝试,可能涉及数据库提供方的连接限制或防火墙等条件。单凭这条消息不能确定根因,也不能证明提高 Hyperdrive 上限就能解决问题。
调整后观察实际源连接数、等待、错误率与查询表现,并保留原配置值以便比较。避免同时放大多个配置或增加无界重试,否则可能把连接压力直接推给数据库。
公告与限制表不同,如何做出可靠决定?
对外介绍更新时,可以准确说“Cloudflare 11 月 11 日宣布提高 Workers Paid 上限”;执行配置变更时,还要看当前账户实际接受的值。不要把旧表当作新公告不存在,也不要因公告存在就声称所有地区和账户已经完成开放。
核对时分别记录公告日期、文档页面日期、查看时间和实际配置值。本次资料核对发生在 2026 年 11 月 12 日,未访问 Cloudflare 账户、创建配置、连接数据库或做压力测试,因此不提供账户到账、性能提升或成本节省的实测结论。
资料来源
常见问题
创建 100 个配置会让同一个数据库获得更多容量吗?
不会。配置数量增加不改变数据库自身的承载能力。同一数据库上的多个配置仍会共同消耗源端连接,必须合并计算,并计入其他客户端与软上限可能产生的额外连接。
能据此计算新增费用,或判断 Free 计划也获得提高吗?
不能。该公告限定 Workers Paid,并未提供新的费用表或宣布 Free 计划上限提高。实际费用与资格需要按当前账户计划和官方计费条款核对,不能仅凭连接上限推算。
查询超时与缓存大小限制也一起提高了吗?
这条公告只宣布配置数量与源连接上限变化,没有宣布查询时长或缓存大小上限变化。排查查询或缓存问题时,应另查对应限制,不把数据库连接池扩容当作这些限制已经改变的证据。