动态住宅流量

按 GB 计费的住宅代理，支持国家到城市的定位、按运营商 ASN 或操作系统筛选，以及 1–120 分钟的粘性会话。

四条产品线里能力最全的一条：唯一支持城市级定位、按运营商 ASN 或操作系统筛选和粘性会话参数的产品。按 GB 计费，适合请求多但单次流量小的任务。

计费与套餐

单位：GB
两种购买形态：
- 固定流量包（package）—— 预设好的 GB 档位
- 自定义流量（custom）—— 自己填 GB 数，代码上限 1,000,000 GB，实际范围还受具体产品的 minGb / maxGb 约束
报价有效期：默认 5 分钟。促销结束时间或产品下架时间更早时会进一步缩短，过期需重新询价。
余额：购买后累加到账号的流量池。当前实现中没有代码层面的自动过期或余量作废规则。

支持的定位参数

这条产品线支持全部定位维度，按下面的顺序拼在用户名后：

参数	取值	说明
`country`	两位大写字母	必须大写，`us` 会被拒
`state` 或 `region`	1–100 字节	两个键完全等价，不能同时用
`city`	1–100 字节	精确匹配、区分大小写
`asn`	数字或 `AS` 前缀	按运营商定位就用这个，`64512`、`AS64512`、`as64512` 都行
`os`	`windows`、`android`、`ios`、`mac`	指定代理出口设备的操作系统；“不限”表示不限制系统
`session`	1–64 字节，`[A-Za-z0-9.-]`	必须和 `time` 同时给
`time`	整数 1–120	单位分钟，必须和 `session` 同时给

完整的转义规则、顺序约束和错误示例见用户名参数完整参考。

shell

# 洛杉矶 + 30 分钟粘性
curl -x 'http://USERNAME-country-US-state-California-city-Los%20Angeles-session-job1-time-30:PASSWORD@GATEWAY_HOST:58971' \
  https://api.ipify.org

# 按运营商定位（Comcast 的 AS7922）。asn 不能和州省/城市同时给
curl -x 'http://USERNAME-country-US-asn-7922-session-job1-time-30:PASSWORD@GATEWAY_HOST:58971' \
  https://api.ipify.org

操作系统筛选可以单独使用，也可以与地区组合。例如指定美国 iOS 出口：

shell

curl -x 'http://USERNAME-country-US-os-ios:PASSWORD@GATEWAY_HOST:58971' \
  https://api.ipify.org

定位能力的现实约束

定位参数正确时，仍需有满足条件的可用 IP。使用时请注意：

州省和城市定位取决于该国家是否已开放到对应粒度。城市定位实际要求同时给出国家和州省。
ASN 筛选的可用选项以控制台目录为准。
指定操作系统后，仅使用符合所选系统的代理 IP。
ASN 与州省/城市组合可能不可用，建议分别使用。
会话时长可设置为 1–120 分钟。

暂无满足筛选条件的可用 IP 时，返回 HTTP 503 service_unavailable（SOCKS5 reply 0x01）。可以逐项减少筛选条件后重试。

会话与轮换

带 session + time：同一代理账号使用相同的 session 值和筛选条件，在 time 分钟内保持同一个出口 IP。出口设备离线等情况可能影响 IP 的可用性。

不带 session：每个新 TCP 连接重新分配出口 IP，分配结果可能重复。

相同 session 值搭配不同操作系统时，会分别使用独立会话。粘性会话不保证 IP 永久不变；需要长期固定 IP 的场景请使用静态住宅。

更多细节见粘性会话与轮换。

计费口径

只算隧道内成功转发的双向 payload 字节，握手不计费：

算：CONNECT 隧道建立后的全部字节（含 TLS 记录、HTTP 头、正文）、普通 forward 模式重建后的请求头、上传 + 下载。

不算：你发给网关的 CONNECT 请求头、网关回的 200 Connection Established、SOCKS5 问候与认证、网关到出口的握手、TCP/IP 包头。

计费流量还会乘一个产品倍率，累计后向下取整。详见流量计费口径。

适合什么、不适合什么

适合

网页采集、比价、SERP 抓取
需要按城市或运营商精细定位的验证类任务
短时粘性的多步流程（登录 → 翻页 → 提交）

不适合

大文件下载、视频流 —— 按 GB 会很贵，改用不限量住宅
需要几个月不变的固定 IP —— 用静态住宅
只要低延迟、不在意住宅属性 —— 用数据中心

程序化提取

除了直接拼用户名，还可以用提取接口换出一批 ip:port，用来源 IP 白名单免密接入。适合把地区和会话配置固定在服务端、客户端只拿一批端口用的场景。

OS targeting 目前仅支持账号密码模式，API 提取暂不支持。可在生成器选择 Windows、Android、iOS 或 macOS；选择“不限”时不会添加 os 参数。