动态住宅

动态住宅代理来自真实家庭宽带网络，更接近普通用户的上网环境。与机房 IP 相比，住宅 IP 的业务权重更高，适合对账号、访问成功率和风控通过率要求更高的场景。

适合场景

• 社媒账号注册、登录、养号、运营
• 电商平台浏览、店铺运营、订单流程测试
• 广告投放、落地页验证、本地化内容检查
• 对目标网站风控较敏感的数据采集

使用特点

• 真实性更强：出口来自住宅网络，更像普通用户访问。
• 地区可控：可以通过 country、state、city 指定目标地区。
• 会话可控：可以通过账号名里的 sessionid 区分独立出口，并用 sessiontime 在 1～120 分钟内保持会话。
• 按请求切换：无状态任务可以追加 -f-1，让每次请求都切换 IP。
• 适合连续流程：登录、浏览、提交表单等动作建议使用同一会话，减少流程中途换 IP 的影响。

配置建议

最基础的连接方式是使用后台生成的主机、端口、用户名、密码。如果要指定地区或会话，按下面的格式组合账号名、地区参数和 sessiontime：

test-country-us
test-country-us-state-ny
test-country-us-state-ny-city-newyork
test_1-country-us-sessiontime-10
test-country-us-f-1

配置流程

1. 打开 动态住宅配置页面。
2. 在配置页面选择要使用的账号，或填写用于本次任务的账号名。
3. 如果只需要普通动态住宅出口，直接使用基础账号名，例如 test。
4. 如果需要固定国家、州或城市，在账号名后追加地区参数，例如 test-country-us-state-ny。
5. 如果需要同时使用多个独立出口，为不同任务使用不同下划线 sessionid，例如 test_1、test_2；如果某个出口需要在 1～120 分钟内保持，再追加 sessiontime，例如 test_1-country-us-sessiontime-10。
6. 如果是采集、批量访问等无状态任务，并希望每次请求切换 IP，可以追加 -f-1，例如 test-country-us-f-1。
7. 复制页面生成的主机、端口、用户名、密码，填写到浏览器、系统代理、指纹浏览器或代码中。
8. 连接后访问 IP 检测网站，确认出口地区和会话效果是否符合预期。

发送请求

拿到后台生成的用户名、密码、代理域名和端口后，可以先用 curl 发送一次请求，验证动态住宅代理是否连通。

SOCKS5 代理：

curl -x socks5h://用户名:密码@代理域名:端口 http://ip123.in/ip.json

HTTP 代理：

curl -x http://用户名:密码@代理域名:端口 http://ip123.in/ip.json

返回结果类似下面格式，具体 IP、地区和运营商信息以实际出口为准：

{
  "ip": "47.239.91.123",
  "city": "hong kong",
  "organization": "Alibaba (US) Technology Co., Ltd.",
  "asn": 45102,
  "network": "47.238.0.0/15",
  "country": "Hong Kong",
  "country_code": "HK",
  "continent": "Asia",
  "continent_code": "AS",
  "postal": "-",
  "latitude": "22.2842",
  "longitude": "114.1759",
  "timezone": "Asia/Hong_Kong",
  "metro_code": null,
  "region_code": null,
  "region_cn": "",
  "region": "Hong Kong"
}

TIP

同一个连续流程使用同一个账号名，例如 test_1；同时跑多个独立出口时，分别使用 test_1、test_2。如果任务需要每次请求都更换 IP，使用 -f-1，不要用于需要登录态连续性的流程。

常见组合

目标	示例
指定美国 IP	test-country-us
指定美国纽约州	test-country-us-state-ny
指定纽约市	test-country-us-state-ny-city-newyork
保持 10 分钟会话	test_1-country-us-sessiontime-10
切换为另一个独立 IP	test_2-country-us-sessiontime-10
每次请求切换 IP	test-country-us-f-1

WARNING

如果指定到城市后无法连接或没有网络，通常是该城市当前可用资源不足。可以先只指定 country，再逐步追加 state、city。