通过登录进行连接和定位
Updated:
锁定会话、通过地理位置/ASN/ISP/邮政编码限制退出IP，并结合定向功能——所有这些操作均可通过在代理登录名后添加后缀来实现。
工作原理
您的住宅代理登录名应为 login_targetingSuffixes 形式。基础部分 xxx 即您的凭据——在其后附加定位和会话后缀，并以下划线分隔。
base country city session ttl xxx_c_US_city_New-York_s_100_ttl_30s
连接信息
代理主机（特定地区）
主机
地点
res.proxy-seller.com
NL
us.res.proxy-seller.com
美国
asia.res.proxy-seller.com
JP-东京
asia2.res.proxy-seller.com
JP-东京
移植
10000
类型
HTTPS/ SOCKS5（自动检测）。SOCKS5 还支持 UDP 协议，包括访问网站的 HTTP/3 协议——参见HTTP/3 及通过 SOCKS5 传输的 UDP. 不支持通过 HTTPS 连接到代理服务器。
登录名与密码
请通过 提交至主包
PUT/zh-CN/resident/list/tools或针对子用户
PUT/zh-CN/residentsubuser/list/tools
对于并发请求，请使用 10000–10999 号端口。每个端口对应一个独立的出口 IP 地址——1.2.3.4:10005 和 1.2.3.4:10006 属于不同的 IP 地址。
目标语言的后缀处理
在登录名后添加任意组合以限制退出IP。若不添加后缀，每次请求都会从全球IP池中分配一个新的IP地址。
目标 | 后缀 | 注释 |
|---|---|---|
国家 |
| ISO 3166-1 两字母代码，区分大小写。国家列表 → |
子分类 |
| 地区/州ID。子列表 → |
城市 |
| 将空格替换为 -（例如：New-York）。通常与国家名称结合使用。 |
ISP |
| 数字ISP ID。ISP列表 → |
ASN |
| 自治系统编号。 |
邮政编码 |
| 需指定国家（ |
通过连写组合多个后缀：xxx_c_US_city_New-York_asn_12271
会话控制
通过添加会话 ID（可选配 TTL）来在不同请求中复用相同的退出 IP。
控制 | 后缀 | 注释 |
|---|---|---|
会话 ID |
| 任何字母数字字符串。在会话存活期间，相同的ID对应相同的退出IP。非活动会话将在60分钟后过期。 |
会话有效期 (TTL) |
| 自定义会话时长。后缀：s 秒、m 分钟、h 小时。必须遵循 |
# pinned for 10 seconds curl -x xxx_s_100_ttl_10s:[email protected]:10000 https://example.com
# pinned for 15 minutes curl -x xxx_s_100_ttl_15m:[email protected]:10000 https://example.com
# pinned for 1 hour curl -x xxx_s_100_ttl_1h:[email protected]:10000 https://example.com综合整理
将所有后缀连写在一起——国家 + 城市 + ISP + 会话 + TTL 一次性写完。
# country + city + ASN + session curl -x xxx_c_US_city_New-York_asn_12271_s_100:[email protected]:10000 https://example.com
# country + city + session curl -x xxx_c_US_city_New-York_s_100:[email protected]:10000 https://example.com
# country + ASN curl -x xxx_c_US_asn_12271:[email protected]:10000 https://example.com速查表
_c_{country} → _c_US _sd_{subdivision} → _sd_1906 _city_{city} → _city_New-York _isp_{ispId} → _isp_51811 _asn_{asn} → _asn_12389 _zip_{zip} → _zip_10001 (with _c_) _s_{sessionId} → _s_100 _ttl_{duration} → _ttl_30s | _ttl_15m | _ttl_1h常见问题解答
一项已明确的限制：_ttl_ 必须遵守_s_ — 如果没有会话 ID，会话 TTL 就毫无意义。规范中还指出_zip_ 要求_c_。文档中的所有示例均采用固定的排序方式——_c_ →_city_/_sd_ →_isp_/_asn_/_zip_ →_s_ →_ttl_。未指定任意排列组合的行为；除非已在测试请求中验证过其他情况，否则请严格遵循文档中规定的顺序。
是的，但这会缩小IP池的范围。如果两者的交集为空，则无法建立连接（超时）。请根据以下内容进行验证：get-all-isp-codes 在部署之前。
不。邮政编码必须与对应的_c_<country> ——否则代码将存在歧义并被拒绝。
_ttl_0 禁用显式 TTL → 恢复为默认的 60 分钟闲置时间。负值将被拒绝。
您的流量池内不设硬性上限。
是的——只要会话处于活动状态（在TTL/闲置时间窗口内），即使短暂断开连接后，重复使用相同的ID仍会返回相同的退出IP地址。
是的。_C_US 将导致错误；请使用小写_c_US （该值US （根据 ISO 3166-1 标准，该词本身应大写）。同样适用于_isp_,_asn_,_zip_.