住宅代理

住宅代理通过住宅 IP 地址路由请求。当你的应用需要住宅出口，并且需要更换出口 IP 或在配置的会话期间保留出口 IP 时，可以使用住宅代理。

Scrapeless 提供 HTTP、HTTPS 和 SOCKS5 支持、地理定位以及轮换住宅 IP 的相关说明。你的应用通过代理发送请求，并接收目标站点的响应。

何时使用住宅代理

在采集特定区域的网站内容、跨地理位置比较搜索或商品页面，以及将相互独立的请求分散到多个住宅出口时，可以考虑使用住宅代理。

对于相互独立的请求，选择轮换行为。当多个请求需要在有限时间内共享同一个出口 IP 时，选择粘性会话。如需专用的静态地址，请参阅 Static ISP Proxies。

有关通用的设置流程说明，请参阅 Getting Started。

将生成的主机、端口、用户名和密码复制到以下 cURL 请求中：

curl --proxy 'http://YOUR_PROXY_HOST:YOUR_PROXY_PORT' \
  --proxy-user 'YOUR_PROXY_USERNAME:YOUR_PROXY_PASSWORD' \
  'https://api.ipapi.is/'

将这四个占位符替换为此代理类型的连接详情。YOUR_PROXY_USERNAME 指完整生成的用户名，包括其中已有的任何选项。使用该通道的代理密码。

此示例通过 HTTP 代理发起 HTTPS 请求。响应来自 IP 检测服务，描述了它所观察到的出口连接。请检查你的实际响应；出口地址并非固定的示例值。

使用位置选择器选择国家/地区，并在可用时选择州/省或城市。文档中的用户名选项为 country_、state_ 和 city_。

例如，官方选择器将 Australia → New South Wales → Sydney 映射为：

country_AU-state_NSW-city_sydney

请使用选择器提供的精确代码，而不要输入显示名称。完整配置请参阅 Geo-targeting。

网关位置和出口位置是两个独立的选择。为你的应用连接选择就近的网关；使用位置选项来选择出口。可用的区域网关列在 Authentication and Endpoints 中。

通用会话配置使用两个用户名选项：

Option	Purpose
`r_<sessionDuration>`	请求的会话时长，例如 `0m`、`1m`、`5m` 或 `60m`。
`s_<sessionId>`	会话标识符。

当前会话指南对轮换请求使用 r_0m。对于粘性会话，保持相同的会话 ID 并使用非零时长。其示例 -r_5m-s_test-session-123 请求在该会话中最多保持同一 IP 五分钟。

粘性会话有时间限制。当 IP 过期时，会分配一个新的 IP。在设计依赖 IP 连续性的工作流之前，请参阅 Rotation and Sticky Sessions。

在编辑受支持的选项时，保持生成的通道 ID 和代理类型标识符不变。

官方住宅代理计费指南会同时统计上传和下载流量：

Total data consumption = upload data + download data

如果请求停止工作，请同时检查账户余额和通道流量上限。HTTP 407 可能表示代理凭据无效或通道资源已耗尽。如果代理报告 525（未找到出口），请检查位置筛选条件并尝试更宽泛的选择。