服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 控制台配置使用池的 Endpoint steering = Hash;API 配置使用 session_affinity=ip_cookie。
- Cloudflare One Client 流量按设备识别;其他接入方式(例如 Cloudflare WAN)按来源 IP 识别。
- 私有负载均衡处理 L3/L4 流量,不读写 Cookie 或 HTTP 标头;session_affinity_ttl 不适用。
- 粘性针对 IP 地址与虚拟网络组成的端点,不会固定 Tunnel 或 Mesh 副本。
先确认它固定的是哪个端点
要让私有网络客户端尽量保持访问同一端点,可在 Cloudflare 控制台将池的 Endpoint steering 设为 Hash,或通过 API 设置 session_affinity=ip_cookie。Cloudflare 于 2026 年 11 月 4 日公布这项能力;端点仍须健康,池配置或客户端标识变化也可能改变选择。
这里的端点由 IP 地址与虚拟网络共同标识,目标可以通过 Cloudflare Tunnel、Cloudflare Mesh 或 Cloudflare WAN 到达。对把会话状态保存在单台服务器上的内部应用,这能让客户端继续使用同一端点;它不表示流量会经过同一个连接器副本。
在控制台使用 Hash
在控制台的负载均衡池设置中,将 Endpoint steering 设为 Hash。私有负载均衡的控制台没有单独的会话粘性控件;Hash 会在池内按客户端标识选择端点。
当客户端标识相同、端点保持健康且池配置未变时,端点选择保持稳定。池或健康状态变化时,客户端仍可能转到其他端点。
通过 API 设置 ip_cookie
如果通过 API 配置,在负载均衡器上将 session_affinity 设为 ip_cookie。对 Cloudflare One Client 流量,Cloudflare 使用设备作为稳定标识,因此设备的 IP 地址变化时仍可保持原端点;其他接入方式(例如 Cloudflare WAN 站点)使用来源 IP。
ip_cookie 这个名称不代表会设置 Cookie。私有负载均衡处理 L3/L4 流量,不读取或设置 Cookie、HTTP 标头;它不存储 Cookie,因此 session_affinity_ttl 不适用。
了解端点粘性的边界
如果端点变得不健康,或你新增、删除、调整池中端点的权重,客户端可能会迁移到另一个端点。粘性不会让客户端继续使用不健康的端点。
会话粘性选择的是端点(IP 地址加虚拟网络),不是具体的 Tunnel 或 Mesh 副本。Cloudflare 会把流量送到离处理请求的数据中心较近的副本;同一客户端可能先后经过不同副本,而各副本到端点时使用的来源 IP 也可能不同。因此,依赖固定来源 IP 的应用仍可能看到不同地址。
Cloudflare 文档提到可在应用前放置代理,或让 Tunnel 只运行一个 cloudflared 副本;单副本会移除副本冗余。这些属于独立的架构取舍,不能由端点粘性自动实现,也不应被当作默认变更。
用接入身份判断是否符合需求
假设一台员工笔记本通过 Cloudflare One Client 从家庭 Wi-Fi 切换到移动热点时,设备标识不会只因客户端 IP 改变而变化;只要端点健康且池未改变,它可以继续访问同一端点。
如果流量从 Cloudflare WAN 接入,使用的标识是来源 IP。由此可推断,来源 IP 改变时用于粘性的标识也会改变,因此不要预期它一定保留原端点。
如果你需要的是池内端点粘性,可按管理方式选择控制台 Hash 或 API 的 ip_cookie。如果应用要求固定的连接器副本或固定来源 IP,这两种设置都不能提供该保证。
资料来源
常见问题
这项功能对所有账户、地区都免费开放吗?
本次核验的公告与会话粘性文档未明确所有账户的方案资格、地区可用性、价格或额度。配置前应核对自己账户的实际产品权限与合同,不能由功能公告推定免费或全球无条件开放。
端点故障后,能保证在多少秒内切换吗?
本次来源说明健康状态变化可能让客户端迁移,但未给出可用于本文的故障切换或收敛时间保证。端点粘性也不能代替应用自身的会话恢复设计。