会话

默认情况下,每次请求都会轮换到一个新的 IP。当您需要在多个请求中使用相同的 IP 时,请开启粘性会话。

模式

按请求轮换

发送请求时不带 sid 标志。每个请求使用不同的 IP。

curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-country-us:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 98.207.12.9

粘性会话

在用户名中添加 sid-<id>。id 可以是您选择的任意字符串;使用相同 id 的后续请求会返回相同的 IP,直到 TTL 到期或该 IP 在上游断开连接。ttl-<seconds> 是可选的,且仅在与 sid 一起使用时有效,它会覆盖默认生命周期(120 秒,最小值为 1)。面板的端点构建器默认值也是 120。

customer-USERNAME-country-us-sid-order42             # default 120s lifetime
customer-USERNAME-country-us-sid-order42-ttl-600     # custom 10-minute lifetime

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44

curl -x customer-USERNAME-sid-order42-ttl-600:PASSWORD@p.shifter.io:443 \
  http://ip-info.com/json
# 72.14.201.44  (same)

选择会话 id

• 为每个工作流选择唯一的标识(order-42、user-a7f3、checkout-2024-11-21-1)。
• 两个不同的运行如果同时使用相同的 id,会争用同一个粘性 IP,产生冲突。
• id 是任意的;Shifter 不会解析它。它仅用作缓存键。

会话过期时

• 在 ttl 秒后,映射会失效,下一次请求会轮换到新的 IP(目标定位标志会被保留)。
• 如果底层的住宅 IP 提前断开连接,会话会提前结束,下一次请求会发生轮换。

与地理定位结合使用

粘性会话会遵循您设置的其他标志。会话 id 会在您的过滤条件范围内锁定一个 IP:

customer-USERNAME-country-us-city-los_angeles-sid-scrape1            # default 120s
customer-USERNAME-country-us-city-los_angeles-sid-scrape1-ttl-300    # custom 5-min

在 TTL 有效期内,所有使用相同 id 的请求都会保持在同一个洛杉矶 IP 上。

Caution

请勿在并发的工作流中重复使用同一个会话 id。来自不同脚本的请求会落在同一个 IP 上,这在大多数反机器人系统看来属于可疑行为。

跨机器和地区的会话

粘性会话按地区保存。p.shifter.io 会将每台机器连接到最近的地区，因此两台连接到不同地区的机器使用同一个 sid 时，会获得两个不同的 IP。这会影响：

• 共用同一会话的爬虫和验证码识别服务（识别服务从其自己的服务器连接）。
• 共享一个会话的多台服务器、容器或云函数。
• 需要显示为同一访客的浏览器和独立的 API 客户端。

要在所有地方保持同一个 IP，请让共享该会话的所有工具都连接到同一个地区接入点，例如 fra.p.shifter.io：

customer-USERNAME-country-us-sid-order42-ttl-600:PASSWORD@fra.p.shifter.io:443

始终通过 p.shifter.io 连接的单台机器通常不受影响。

下一步

• 地理定位,在锁定 IP 之前缩小 IP 池范围。
• 集成,了解在 Scrapy、Puppeteer、Playwright 中使用会话 id 的方法。