Residential
住宅代理 · 真实家庭宽带 IP，可指定国家和城市
出口 IP 来自合作伙伴网络的家庭宽带设备，分布在 170 多个国家/地区，在用户名里加参数即可指定国家/地区、州、城市或 ASN。按流量（GB）包月，所有规格支持 HTTP(S) 和 SOCKS5，账号密码与其他产品通用。适合目标网站拒绝机房 IP 的场景；目标网站接受机房 IP 时，动态数据中心代理更省钱。
以下价格均为美元（USD），按月计费。
- 出口来源
- 合作伙伴网络，家庭宽带 IP
- 可指定
- 国家/地区、州、城市、ASN
- 协议
- HTTP(S) 和 SOCKS5
- 计费
- 按流量（GB）包月
住宅代理适合哪些任务
目标网站按 IP 类型打分，或直接拒绝机房 IP 时，才需要住宅代理：店铺后台登录、社交媒体账号运营、零售和票务等风控严格的网站，以及要按城市查看本地结果的任务（本地搜索结果、广告展示、区域价格）。
目标网站接受机房 IP 时（多数 API 和普通网站都接受），用动态数据中心代理或独享数据中心代理更省钱，速度也更稳定：家庭宽带的延迟比机房线路波动大，指定地区不会改变这一点。
住宅出口只改变目标网站看到的网络类型，不是访问或登录一定成功的承诺。拿不准时，先用数据中心产品测一下目标网站是否拒绝机房 IP，再决定要不要换住宅代理。
如何指定国家、州和城市
地区写在用户名里，密码不变，网关地址始终是同一个。网关读取用户名里的参数，只从满足条件的出口里选一个，所以不改控制台、不换账号密码就能逐个请求换地区。各参数用连字符连接，顺序不限，每个参数最多出现一次。
条件取交集：-country-us-city-losangeles 要求出口同时满足两个条件，参数越多可选出口越少。无法满足的组合（国家和城市不匹配、不支持的地区、该城市此刻没有在线设备）会直接报错，网关不会悄悄换到附近地区。城市名须与国家一起使用，因为城市名不是全球唯一的。
城市级定位不是每个国家都有。控制台“我的代理”页面的定位设置只列出当前覆盖快照里有出口的国家、州和城市；手填的城市如果持续失败，先看定位设置里是否有它。住宅出口是真实设备，白天有出口的小城市到了当地凌晨可能没有设备在线，把报错理解为“此刻没有”，任务允许的话在代码里按城市、州、国家逐级放宽。
| 参数 | 格式 | 示例 |
|---|---|---|
| country | ISO 3166-1 两位字母代码（英国是 gb） | -country-de |
| state | 州或省的代码，字母或数字，常用于美国各州 | -country-us-state-wa |
| city | 小写字母和数字，去掉空格、重音和标点，须与 country 同用 | -city-saopaulo |
| asn | 运营商的自治系统号，纯数字，不加 AS 前缀 | -asn-7922 |
| session | 自定义的字母数字串，后续请求尽量沿用同一出口 | -session-task81f3 |
- 网关地址
- gw-residential.node4.io
- HTTP 端口
- 8082
- SOCKS5 端口
- 1082
curl -x "http://USERNAME-country-us-city-losangeles:PASSWORD@gw-residential.node4.io:8082" https://ipinfo.io/json会话保持能保持多久
不加 session 参数时，每次新建连接（HTTPS 的 CONNECT 隧道、SOCKS5 连接）或每个普通 HTTP 请求分配一个出口 IP。需要多个请求走同一个出口时，在用户名里加 -session-<id>，id 由字母和数字组成，自己定即可，控制台的定位设置也能生成。
会话保持属于尽量保持，最长 30 分钟，从首次分配起算，期间的请求不会延长它。出口是家庭设备，设备下线会提前结束会话，而且上限到期前不会自动换到新出口，所以连续失败时换一个新的 session id，不要原地等待。换了地区参数也请换 session id。
同一个 session id 在 HTTP(S) 和 SOCKS5 下指向同一个会话，一种协议上保持的出口在另一种协议上也保持。住宅出口不会长期固定：Node4 没有长期固定住宅 IP 这类产品。需要几天都不变的地址，请用独享数据中心代理，它是机房 IP。
价格和流量有效期
按流量（GB）包月：买的是一个月的流量额度，没有长期合约，规格越大每 GB 单价越低。流量按双向传输的字节计量，被拒绝的连接不传输数据，不计流量。
套餐内流量在当前计费周期内有效，未用完不结转；中途购买的流量包同样随周期到期。流量用完后访问暂停，直到购买流量或进入下一个计费周期，不会自动扣超量费，除非开启了流量自动充值。流量自动充值是账号级设置，取消套餐不会自动关闭它。
银行卡和 PayPal 付款的套餐自动续费，可随时在控制台关闭；比特币付款的套餐不会自动扣款，需在控制台支付续费账单，账户余额足够支付整笔续费时除外。取消后代理可用到当前已付周期结束。各支付方式的续费规则、退款规则和到期保留见中文价格页的计费说明和常见问题。
如何测试接入
免费套餐是共享数据中心 IP，只支持 HTTP(S)，不能连接住宅网关，因此测不了地区指定，也测不了住宅 IP 池。它能测的是前一步：客户端是否正确通过代理认证、代码是否能走代理、目标网站是否接受机房 IP。
测住宅代理请买最小规格：先在控制台的定位设置里生成带地区参数的用户名，请求一次 IP 回显服务（例如上面示例中的 ipinfo），确认返回的国家正确；再对真实目标网站跑一小段任务，看三件事：需要的地区是否可用并返回足够多的不同 IP，目标网站在预期请求频率下是否接受，每单位工作消耗多少流量。整个测试通常只用几 GB。
IP 地理库之间城市级的判断经常不一致，目标网站用的库也未必和您查的是同一个：国家不对值得提交工单，城市判成相邻城区属于正常误差。任务开始时复核一次出口，运行期间再定期复核；需要按地区分析或核验数据时，请把核实到的出口和每批数据一起记录。
适合与不适合的任务
适合
- 店铺后台登录（Amazon、Shopee、TikTok Shop 等）：指定店铺所在的国家和城市，每个店铺单独一个 session id，不与其他店铺混用
- 社交媒体账号运营：每个账号一个 session id，搭配指纹浏览器隔离 cookie 和指纹
- 本地搜索结果、广告展示、区域价格的核查：只有住宅代理能指定到城市
- 零售、票务、旅游等直接拒绝机房 IP 的网站
不适合
- 目标网站接受机房 IP 的采集和 API 调用：动态数据中心代理按 GB 更便宜，不限流量动态代理按并发连接数计费
- 需要几天不变的固定地址，例如合作方 API 白名单：请用独享数据中心代理
- 需要出口长期不变的登录环境：住宅会话最长 30 分钟，之后同一地区内会换出口
- 大流量传输：按 GB 计费时流量就是成本
常见问题
住宅代理和数据中心代理有什么区别？
数据中心代理的 IP 注册在机房网段，速度快、价格低，但检测工具会显示为机房 IP，部分网站整段拒绝。住宅代理走真实家庭宽带，目标网站看到的是普通家庭用户的网络，代价是每 GB 更贵、延迟波动更大。Node4 的独享、共享和动态产品都是数据中心代理，只有住宅代理走合作伙伴网络。
支持城市级定位吗？
支持。可指定国家/地区、州和城市，范围以控制台定位设置里列出的地区为准。可选地区来自覆盖快照，它说明某个地区可以指定，不保证每次请求都有空闲出口，也不保证该城市有多少个不同 IP。城市之间差别很大，请先用自己的任务测一下再依赖它。
会话保持最长多久？会不会提前断？
最长 30 分钟，从首次分配起算，属于尽量保持。出口设备下线会提前结束，并且上限到期前不会自动换到新出口，连续失败时请换一个新的 session id。不加 session 参数时，每次新建连接分配一个出口 IP。
失败的请求也算流量吗？
按双向实际传输的字节计量。被拒绝的连接没有传输数据，不计流量；已经返回了响应体的失败请求会计入，所以请控制重试频率，状态码表明无用的响应及早放弃。
可以用 IP 白名单认证吗？
可以，但有一个取舍：地区、会话和权限参数都写在用户名里，白名单连接不带用户名，所以拿到的是不指定地区、每次连接都换的出口。任何地区都行时用白名单，需要落在指定地区时用账号密码。
免费套餐能测试住宅代理吗？
不能。免费套餐是共享数据中心 IP，仅支持 HTTP(S)，连不上住宅网关。它可以用来确认客户端能通过代理认证，以及目标网站是否接受机房 IP；住宅出口和地区指定请购买最小规格测试。
流量用完了怎么办？
默认情况下访问暂停，不会自动扣超量费；在控制台购买流量即可继续，或等下一个计费周期。开启流量自动充值后，接近用完时系统会按您设置的阈值和每周期次数自动购买。套餐内流量和流量包都在当前周期内有效，未用完不结转。
检测工具会把它识别为住宅 IP 吗？
出口是真实家庭宽带设备上的 IP，但 IP 类型由各检测库各自判断，彼此并不完全一致，目标网站用的库也未必是您查的那个。要查的是住宅网关实际分配的出口，而免费套餐连不上住宅网关，所以请先买最小规格，再用 ping0.cc、ipinfo、Scamalytics、whoer.net 或 ip111.cn 查看出口 IP 的类型和风险值，最终以自己的目标网站的实际反应为准。
用住宅代理登录店铺后台安全吗？
代理只改变 IP，是否触发风控由平台判断，Node4 无法承诺。建议一店一 IP：每个店铺指定店铺所在的国家和城市并固定一个 session id，接受最长 30 分钟后在同一地区内换出口的事实；cookie、浏览器指纹和支付信息请交给指纹浏览器的独立环境隔离。
从最小规格开始测试
注册后在价格页选择住宅代理的规格，付款开通后用控制台的定位设置生成用户名。先测地区和用量，再加量。