跳至正文

会话

每个连接重新选择出口,或用自定义会话 ID 锁定同一 IP,最长 30 分钟。

轮换

用户名中不带会话参数时,每次新建到网关的连接,都会从符合定向条件的上游中重新选择出口。住宅网络上通常会换成新 IP;ISP 和数据中心网络上则是分配给你的 IP 之一。这是默认行为,也适合绝大多数抓取任务:某个 IP 被封,通常不会影响下一个连接。

# 三个连接,每次重新选择
for i in 1 2 3; do
  curl -s -x icn-01.gw.scalardata.ai:7777 -U "k7f3q2-acme-country-kr:PASSWORD" https://ipinfo.io/ip
done

需要注意:轮换以连接为单位,而不是以 HTTP 请求为单位。HTTPS 下客户端会建立一条 CONNECT 隧道,并可能借助 keep-alive 在隧道内连续发送多个请求,这些请求共用同一出口 IP。要强制重新选择出口,请关闭连接或禁用 keep-alive。普通 http:// 请求每个连接只处理一个,网关返回响应后即关闭连接,因此每个请求都会重新选择出口。

粘性会话

在用户名中加入 session-ID,网关便会将该 ID 锁定到一个出口 IP,之后复用该 ID 的每个连接都从同一 IP 发出,直到会话结束。凡是有状态的操作都适合用它:登录韩国平台、在电商网站添加商品到购物车、翻阅与访客 IP 绑定的结果页等。

# 三次请求,同一 IP,最长保持 15 分钟
for i in 1 2 3; do
  curl -s -x icn-01.gw.scalardata.ai:7777 \
    -U "k7f3q2-acme-country-kr-session-order77-sessduration-15:PASSWORD" \
    https://ipinfo.io/ip
done

单次会话最长 30 分钟。时长通过 sessduration-MIN 设置,取值 1 到 30;不带时按代理用户的默认值,未设默认值则为 10 分钟。计时从该 ID 的第一个连接开始,而不是每次请求重置。会话到期后,同一 ID 的下一个连接会重新选择出口并重新计时,因此一个 ID 可以无限次复用。

如果需要同一 IP 保持数小时甚至数天,粘性会话并不合适。ISP 地址在订阅有效期间一直分配给你的账号;但连接会在这些 IP 之间轮换,会话最多可锁定其中一个 30 分钟。暂不支持指定某一个 IP。

会话 ID 的工作机制

会话 ID 由客户端自行指定,网关不负责分发,任意字母和数字组合都可以。ID 的作用域限定在首次使用时的代理用户、网络和定向参数上,因此:

  • 同一 ID 用在两个不同代理用户上,是两个独立的会话。
  • 沿用已有 ID 但改动任一定向参数,会开始一个新会话,因为已锁定的 IP 未必满足新的定向条件。
  • 不同 ID 各自独立选择出口,仍可能落在同一个出口上;在只从已分配 IP 中选择的 ISP、数据中心网络上尤其如此。要分散并行 worker,请给每个 worker 分配独立的 ID。
# 两个并行的独立会话
k7f3q2-acme-country-kr-session-worker1
k7f3q2-acme-country-kr-session-worker2

会话数量本身没有上限,但会话中的连接计入连接数限制(见错误中的 429)。会话本身不单独计费。

出口 IP 掉线时

如果会话锁定的上游停止服务,或新建连接失败,网关会为该会话改锁一个满足同样定向条件的其他上游(到期时间不变),失败的连接会在新上游上重试一次。此后会话的来源地址就与之前不同。传输过程中断开的连接不会重试。

对大多数任务来说这无关紧要。但对于已登录的流程,网站可能把地址变化视为新访客并要求重新登录。如果你的业务对此比较敏感:

  • 会话中途出现登录提示或 cookie 被重置时,当作一次普通的网络闪断处理即可:换一个新的会话 ID,重新登录。
  • 尽量缩短会话时长。IP 保持得越久,中途掉线的概率越高。
  • 把有状态的环节迁移到一直分配给你的 ISP 或数据中心 IP 上,并用会话 ID 锁定其中一个。

长时间不用的会话也会提前释放:连续 5 分钟既无新连接也无流量的 ID,不会继续为其保留 IP。之后再复用该 ID,等同于开启一个全新会话。