> For the complete documentation index, see [llms.txt](https://docs.helodata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helodata.com/helodata-zh/chan-pin/overview.md).

# 住宅代理

住宅代理通过全球真实消费者的家用 ISP 设备转发请求。目标站点看到的是普通家庭流量，是对抗反爬防御最稳健的选择。

## 一览

|            |                         |
| ---------- | ----------------------- |
| **类型代码**   | `res`                   |
| **交付方式**   | 网关，定位编码在用户名中            |
| **接入端点**   | `gate.helodata.io:7777` |
| **计费**     | 按 GB 付费                 |
| **IP 池规模** | 1 亿+                    |
| **地理定位**   | 国 / 州 / 城市 / ASN        |
| **会话时长**   | 轮换（按连接）或粘性（最长 30 分钟）    |
| **协议**     | HTTP、HTTPS、SOCKS5       |
| **认证方式**   | 用户名+密码 或 IP 白名单         |

## 适用场景

* 反爬强的站点（电商、票务、社交）
* 需要特定国家真实消费者 IP 的地域受限内容
* 必须与真实用户流量融合的广告校验与 SERP 追踪
* 需要新鲜、不被屏蔽网页的大模型数据管道

如果目标站点无防护，[数据中心代理](/helodata-zh/chan-pin/overview-3.md)（即将上线）更便宜；如果需要数小时甚至数天保持同一 IP，[ISP 代理](/helodata-zh/chan-pin/overview-2.md)更合适。

## 用户名语法

```
helo_{username}-type-res-region-{region}[-state-{state}][-city-{city}][-asn-{asn}][-session-{session_id}-sesstime-{ttl}]
```

完整说明见[用户名格式](/helodata-zh/kuai-su-ru-men/username-format.md)。

## 五秒示例

```bash
curl -x http://helo_s1a2b3c4d5e-type-res-region-us:PASSWORD@gate.helodata.io:7777 \
     https://ipv4.icanhazip.com
```

## 本节内容

* [快速开始](/helodata-zh/chan-pin/overview/quick-start.md) — 5 分钟跑通第一个请求
* [身份认证](/helodata-zh/chan-pin/overview/authentication.md) — 密码 vs IP 白名单
* [接入点与端口](/helodata-zh/chan-pin/overview/endpoints-and-ports.md) — 主机、端口、TLS
* [国家与城市](/helodata-zh/chan-pin/overview/locations.md) — 完整地理参数
* [协议](/helodata-zh/chan-pin/overview/protocols.md) — HTTP / HTTPS / SOCKS5
* [会话与轮换](/helodata-zh/chan-pin/overview/sessions-and-rotation.md) — 粘性 vs 轮换
* [ASN 定位](/helodata-zh/chan-pin/overview/asn-targeting.md) — 绑定特定 ISP
* [受限站点](/helodata-zh/chan-pin/overview/restricted-targets.md) — 不可路由的目标
* [错误说明](/helodata-zh/chan-pin/overview/error-definitions.md) — 各状态码含义
* [使用统计](/helodata-zh/chan-pin/overview/statistics.md) — 仪表盘与流量 API