从这里开始 · 定位与会话
把对出口的所有要求写进用户名。
国家/地区、美国州、城市、运营商、会话标识和有效期。两个共享网关均支持这六个参数,顺序不限。
语法#
先写用户名,再追加 -key-value 对。键和值均使用小写;顺序不限;密码保持不变。完全不带参数时,系统会从任意国家/地区选择出口,并在每次连接时更换。
USER-cc-us-state-tx-city-austin-sid-a1b2c3-ttl-30m:PASS
│ │ │ │ │ │
│ │ │ │ │ └─ 保持 30 分钟
│ │ │ │ └─ 会话 ID:相同 ID 使用相同 IP
│ │ │ └─ 城市(仅限字母和数字)
│ │ └─ 美国州(仅适用于美国)
│ └─ 国家/地区,ISO 3166-1 alpha-2
└─ 你的用户名参数#
| 参数 | 取值 | 说明 |
|---|---|---|
| -cc- | 两位国家/地区代码:us、de、br、jp | 从该国家/地区出口。住宅网络覆盖 199 个国家/地区;移动网络代理池覆盖结账页面列出的国家/地区。 |
| -state- | 美国州代码:tx、ca、ny | 从该州出口。必须搭配 -cc-us;其他国家/地区不可用。 |
| -city- | 城市名称,使用小写且仅含字母和数字:newyork、berlin、saopaulo | 从该城市出口。必须搭配 -cc-。每个国家/地区页面均以准确参数值列出可用城市。 |
| -asn- | 自治系统编号,不带 AS 前缀:7922、3320 | 从该运营商宣告的网络出口。与 -cc- 搭配使用。在移动网络代理池中,可通过此参数选择运营商。 |
| -sid- | 字母和数字,最多 32 个字符:a1b2c3、job42 | 粘性会话。携带相同 ID 的请求会共用同一出口,直到有效期结束或设备离线。使用新 ID 即会获得新 IP。 |
| -ttl- | 分钟或小时,范围从 1m 到 24h:10m、2h | 粘性会话的有效期,从首次请求开始计算。使用 -sid- 但未提供 -ttl- 时,默认为 10m。 |
轮换与会话#
不使用 -sid- 时,网关会为收到的每个新连接选择新出口。客户端若保持连接,或通过同一个 CONNECT 隧道发送多个请求,会在该连接的整个存续期间使用同一出口。若要每个请求都轮换,请禁用连接保持,或在每次调用后关闭连接;若要让多个连接使用同一 IP,请使用会话 ID。
- 任意数量的并行连接只要使用相同的
-sid-值,就会使用相同的 IP。可按需同时运行任意数量的会话,没有上限。 - 有效期结束或住宅设备断线后,下一个使用该 ID 的请求会获得一个仍符合其他参数的新 IP。设计流程时应考虑这一点:任何住宅网络都可能在流程中途更换 IP。
- 若要立即强制更换,请修改 ID。ID 的作用域限定在你的账户内,且不产生费用。
- 住宅和移动网络代理池均支持粘性会话。独享 ISP、数据中心和移动设备代理均使用一个固定 IP,并忽略
-sid-和-ttl-。
示例#
| 需求 | 用户名 |
|---|---|
| 每次连接都从任意国家/地区获取新 IP | USER |
| 每次连接都获取新的美国 IP | USER-cc-us |
| 一个得克萨斯州住宅出口 | USER-cc-us-state-tx |
| 任意柏林 IP | USER-cc-de-city-berlin |
| 一个保持十分钟的柏林 IP | USER-cc-de-city-berlin-sid-7f3a9 |
| 一个保持两小时的日本 IP | USER-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 变为 newyork,São Paulo 变为 saopaulo,Düsseldorf 变为 dusseldorf,Frankfurt am Main 列为 frankfurt。请使用国家/地区页面显示的值,不要猜测;网关会精确匹配该字符串。
无法满足参数时会怎样#
| 情形 | 响应 | 处理方法 |
|---|---|---|
未知键或值格式错误(-country-us、-ttl-90x) | 400 Bad Request | 修正字符串;响应正文会指出相关参数。 |
使用 -city- 或 -state- 但未提供 -cc-,或在美国以外使用 -state- | 400 Bad Request | 添加 -cc-us,或移除该参数。 |
| 当前没有符合参数组合的在线出口(例如小城市加特定 ASN) | 502 Bad Gateway | 重试,然后放宽条件:先移除 -asn-,再移除 -city-。 |
| 向独享地址发送参数 | 已忽略 | 无需处理;IP 是固定的。 |