文档菜单

从这里开始 · 定位与会话

把对出口的所有要求写进用户名。

国家/地区、美国州、城市、运营商、会话标识和有效期。两个共享网关均支持这六个参数,顺序不限。

阅读约 4 分钟 6 个章节 更新于

语法#

先写用户名,再追加 -key-value 对。键和值均使用小写;顺序不限;密码保持不变。完全不带参数时,系统会从任意国家/地区选择出口,并在每次连接时更换。

结构解析
USER-cc-us-state-tx-city-austin-sid-a1b2c3-ttl-30m:PASS
│    │     │        │           │          │
│    │     │        │           │          └─ 保持 30 分钟
│    │     │        │           └─ 会话 ID:相同 ID 使用相同 IP
│    │     │        └─ 城市(仅限字母和数字)
│    │     └─ 美国州(仅适用于美国)
│    └─ 国家/地区,ISO 3166-1 alpha-2
└─ 你的用户名

参数#

参数取值说明
-cc-两位国家/地区代码:usdebrjp从该国家/地区出口。住宅网络覆盖 199 个国家/地区;移动网络代理池覆盖结账页面列出的国家/地区。
-state-美国州代码:txcany从该州出口。必须搭配 -cc-us;其他国家/地区不可用。
-city-城市名称,使用小写且仅含字母和数字:newyorkberlinsaopaulo从该城市出口。必须搭配 -cc-。每个国家/地区页面均以准确参数值列出可用城市。
-asn-自治系统编号,不带 AS 前缀:79223320从该运营商宣告的网络出口。与 -cc- 搭配使用。在移动网络代理池中,可通过此参数选择运营商。
-sid-字母和数字,最多 32 个字符:a1b2c3job42粘性会话。携带相同 ID 的请求会共用同一出口,直到有效期结束或设备离线。使用新 ID 即会获得新 IP。
-ttl-分钟或小时,范围从 1m24h10m2h粘性会话的有效期,从首次请求开始计算。使用 -sid- 但未提供 -ttl- 时,默认为 10m

轮换与会话#

不使用 -sid- 时,网关会为收到的每个新连接选择新出口。客户端若保持连接,或通过同一个 CONNECT 隧道发送多个请求,会在该连接的整个存续期间使用同一出口。若要每个请求都轮换,请禁用连接保持,或在每次调用后关闭连接;若要让多个连接使用同一 IP,请使用会话 ID。

  • 任意数量的并行连接只要使用相同的 -sid- 值,就会使用相同的 IP。可按需同时运行任意数量的会话,没有上限。
  • 有效期结束或住宅设备断线后,下一个使用该 ID 的请求会获得一个仍符合其他参数的 IP。设计流程时应考虑这一点:任何住宅网络都可能在流程中途更换 IP。
  • 若要立即强制更换,请修改 ID。ID 的作用域限定在你的账户内,且不产生费用。
  • 住宅和移动网络代理池均支持粘性会话。独享 ISP、数据中心和移动设备代理均使用一个固定 IP,并忽略 -sid--ttl-

示例#

需求用户名
每次连接都从任意国家/地区获取新 IPUSER
每次连接都获取新的美国 IPUSER-cc-us
一个得克萨斯州住宅出口USER-cc-us-state-tx
任意柏林 IPUSER-cc-de-city-berlin
一个保持十分钟的柏林 IPUSER-cc-de-city-berlin-sid-7f3a9
一个保持两小时的日本 IPUSER-cc-jp-sid-tokyo1-ttl-2h
一个 Comcast 用户 (AS7922)USER-cc-us-asn-7922
德国电信移动网络用户,保持 15 分钟USER-cc-de-asn-3320-sid-m1-ttl-15m
二十个并行的巴西会话USER-cc-br-sid-w01 … USER-cc-br-sid-w20

城市名称#

城市值采用小写 ASCII 城市名称,并移除空格、连字符、撇号和重音符号:New York 变为 newyorkSão Paulo 变为 saopauloDüsseldorf 变为 dusseldorfFrankfurt am Main 列为 frankfurt。请使用国家/地区页面显示的值,不要猜测;网关会精确匹配该字符串。

无法满足参数时会怎样#

情形响应处理方法
未知键或值格式错误(-country-us-ttl-90x400 Bad Request修正字符串;响应正文会指出相关参数。
使用 -city--state- 但未提供 -cc-,或在美国以外使用 -state-400 Bad Request添加 -cc-us,或移除该参数。
当前没有符合参数组合的在线出口(例如小城市加特定 ASN)502 Bad Gateway重试,然后放宽条件:先移除 -asn-,再移除 -city-
向独享地址发送参数已忽略无需处理;IP 是固定的。

准备好即可开始

粘贴端点,亲眼查看出口变化。

创建账户,充值 $20,然后针对真实目标运行快速入门示例。未使用的金额会保留在余额中。