For the complete documentation index, see llms.txt. This page is also available as Markdown.

会话与轮换

「会话」是让多次请求保持同一住宅出口 IP 的机制。helodata 支持两种模式,按请求通过用户名指定。

轮换模式(默认)

省略 sessionsesstime 段。每个新 TCP 连接都从匹配 IP 池中重新挑选。

helo_s1a2b3c4d5e-type-res-region-us

适用场景:

  • 不需要保留 cookie 的单次抓取

  • 通过 IP 多样性绕过反爬

  • 大规模并行爬取,追求 IP 池最大多样性

注意:单客户端中的 keep-alive 连接复用可能在连接关闭前都使用同一 IP。如果需要严格的「每请求一新 IP」,请强制新建连接(Connection: close)。

粘性模式

同时追加 session-{id}sesstime-{分钟}完整用户名字符串相同的请求会复用同一出口 IP,最长 sesstime 分钟。

helo_s1a2b3c4d5e-type-res-region-us-session-job1-sesstime-30
约束

sesstime 上限(住宅)

30 分钟

会话 ID 字符集

[a-z0-9],最多 32 字符

IP 保证

best-effort——上游 IP 掉线可能重新分配

会话计时

首次请求触发

适用场景:

  • 多步骤流程(登录 → 搜索 → 下单)

  • 反爬信号会在几分钟内绑定 IP 的站点

  • 需要响应可复现的测试

粘性下的并发

session_id 相同但其他参数不同(不同地理、不同子账号)的两次请求被视为不同会话完整用户名才是会话键,不仅仅是 ID。

例如:

会开两个独立会话,一个落在美国,一个落在德国。

会话掉线恢复

若上游 IP 中途掉线,使用同一用户名的下一次请求会拿到新 IP 并重置计时。响应头会标记:

长流程中要监测这个头,出现时考虑重置客户端状态(cookie、指纹)。

用法示例

N 个并发粘性会话池

users 按轮询分给工作线程即可。

用完即弃

追踪每个会话的失败次数。超过阈值(如 60 秒内 3 次失败)即抛弃该会话 ID,生成新 ID。

会话不会做的事

  • 不会延长流量额度——带宽依然按字节扣费

  • 不会自动维持 cookie、请求头、TLS 指纹——这是客户端的工作

  • 不保证某个特定 IP——只保证窗口期内 IP 稳定

相关

  • ASN 定位 — 结合会话可在整个流程中锁定同一 ISP

  • 国家与城市 — 地理字段必须一致才能共享会话

  • 407 错误 — 会话语法错误时常见

最后更新于

这有帮助吗?