跳到主要内容
NextProxyNextProxy文档

高级住宅流量

按 GB 计费、流量不过期的高级住宅代理。任意动态住宅子账号在用户名里加 type-premium 即可接入,支持国家、州省、城市、设备操作系统定位和 1–120 分钟粘性会话。

高级住宅是另一条按 GB 计费的住宅线,流量单独计余额、不过期。它不需要单独的子账号:任何动态住宅子账号在用户名里加上 type-premium,这次连接就走高级住宅的线路和余额。

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

网关地址、端口、协议都和动态住宅一样,HTTP 和 SOCKS5 共用 58971。

和动态住宅的区别

动态住宅高级住宅
接入用户名不带 type,或带 type-residential用户名带 type-premium
余额动态住宅流量池独立的高级住宅余额
地区目录动态住宅目录高级住宅自己的目录
州省定位支持仅美国可以只定位到州省;其他国家要选到城市
ASN 定位支持不支持
操作系统支持支持
API 提取支持支持,加 product=premium,可带 os

计费与购买

  • 单位:GB。在控制台「高级住宅」页的「价格」标签购买。
  • 阶梯单价:一次购买的 GB 数落在哪一档,整单都按那一档的单价计价。档位和单价以购买页为准。
  • 单次购买:1–100,000 GB。
  • 余额不过期,按用户累计,所有动态住宅子账号共用。
  • 计费口径和动态住宅相同,只算隧道内成功转发的双向 payload,倍率 1:1。见 流量计费口径。
  • 也可以用 流量 CDK 转出或兑换高级住宅流量。

支持的参数

参数取值说明
typepremium选择高级住宅;可以写在参数里的任意位置
country两位大写字母可用国家以高级住宅的地区目录为准
state 或 region州省名称美国可以单独使用;其他国家必须同时给 city
city城市名称需要同时给国家和州省
oswindows、android、ios、mac出口设备的操作系统
session + time同动态住宅,time 为 1–120 分钟粘性会话

除 type 外,其余参数仍按 country → state/region → city → os → session → time 的顺序拼。完整规则见 用户名参数完整参考。

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

# 美国以外要选到城市
curl -x 'http://USERNAME-type-premium-country-GB-state-England-city-London:PASSWORD@GATEWAY_HOST:58971' \
  https://api.ipify.org

会话与轮换

和动态住宅一致:带 session + time 时,在时长内尽量保持同一个出口 IP;不带 session 时,每个新 TCP 连接重新分配出口。同一个 session 值在高级住宅和动态住宅之间是两个独立会话。见 粘性会话与轮换。

程序化提取

提取接口 加 product=premium 就提取高级住宅端口,还可以带 os:

shell
curl 'https://api.example.com/api/v1/proxy/extract?apikey=YOUR_KEY&num=5&product=premium&country=US&os=windows&session=sticky&time=10'

用的是同一个代理账号的 API Key 和 IP 白名单,端口的流量从高级住宅余额扣。余额为 0 时返回 402 proxy_extract_traffic_exhausted。

访问限制

高级住宅限制访问政府网站、游戏主机网络和邮件端口等,详见 访问限制与使用规则。

这篇解决你的问题了吗?