# 住宅代理

住宅代理通过全球真实消费者的家用 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/helodata-zh/chan-pin/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.