# 代理清单格式

ISP 的每个 IP 都按冒号分隔的四元组交付。这是多数代理管理工具、反检测浏览器和爬虫**可直接消费**的标准格式。

## 标准格式

```
ip:port:user:pass
```

| 字段     | 示例                 | 说明                             |
| ------ | ------------------ | ------------------------------ |
| `ip`   | `198.51.100.42`    | IPv4。IPv6 可申请，见下文。             |
| `port` | `8000`             | HTTP、HTTPS、SOCKS5 共用一个端口，自动识别。 |
| `user` | `helo_s1a2b3c4d5e` | 子账号标识，以 `helo_` 前缀开头。同批次共用。    |
| `pass` | `PASSWORD`         | 子账号密码，同批次共用。                   |

## 清单示例

5 个美国 ISP IP 的批次：

```
198.51.100.42:8000:helo_s1a2b3c4d5e:Mz4yQv8R
198.51.100.43:8000:helo_s1a2b3c4d5e:Mz4yQv8R
198.51.100.44:8000:helo_s1a2b3c4d5e:Mz4yQv8R
198.51.100.45:8000:helo_s1a2b3c4d5e:Mz4yQv8R
198.51.100.46:8000:helo_s1a2b3c4d5e:Mz4yQv8R
```

同批共用用户名与密码——区分靠 `ip:port`。

## URL 形式

接入要求代理 URL 的 HTTP 客户端时：

```
http://helo_s1a2b3c4d5e:PASSWORD@198.51.100.42:8000
```

SOCKS5：

```
socks5h://helo_s1a2b3c4d5e:PASSWORD@198.51.100.42:8000
```

## 可下载格式

`控制台 → ISP → 我的 IP → {批次} → 下载` 提供：

### `ip:port:user:pass`（默认纯文本）

每行一个 IP。可直接被多数反检测浏览器（AdsPower、Multilogin、GoLogin）、代理管理器（Proxifier）和爬虫消费。

### CSV

```csv
ip,port,user,pass,country,city,asn
198.51.100.42,8000,helo_s1a2b3c4d5e,Mz4yQv8R,US,New York,7922
198.51.100.43,8000,helo_s1a2b3c4d5e,Mz4yQv8R,US,New York,7922
```

当你希望凭证之外带上元数据（分析、按区域分片等）时使用。

### JSON

```json
[
  {
    "ip": "198.51.100.42",
    "port": 8000,
    "user": "helo_s1a2b3c4d5e",
    "pass": "Mz4yQv8R",
    "country": "US",
    "city": "New York",
    "asn": 7922,
    "carrier": "Comcast",
    "created_at": "2026-05-01T12:00:00Z",
    "expires_at": "2026-06-01T12:00:00Z"
  }
]
```

最适合程序消费，含每 IP 生命周期日期。

### 工具专用导出

可直接导入的文件：

* **Proxifier** `.ppx`
* **FoxyProxy** `.json`
* **SwitchyOmega** `.bak`
* **Bit Browser / AdsPower** 批量导入 CSV

## API 访问

可通过 API 获取同样的清单，适合自动化批量分发到爬虫集群：

```bash
# 纯文本
curl -H "Authorization: Bearer API_KEY" \
     "https://api.helodata.com/v1/isp/batches/bat_01HX/ips?format=plain"

# JSON
curl -H "Authorization: Bearer API_KEY" \
     "https://api.helodata.com/v1/isp/batches/bat_01HX/ips?format=json"
```

完整 schema 见 [API → 订单](/helodata-zh/api-can-kao/orders.md)。

## IPv6

ISP 的 IPv6 IP 可申请。格式相同，URL 中 `ip` 字段需用方括号：

```
[2001:db8::42]:8000:helo_s1a2b3c4d5e:PASSWORD
```

URL 形式：

```
http://helo_s1a2b3c4d5e:PASSWORD@[2001:db8::42]:8000
```

申请 IPv6：发邮件至 <support@helodata.com>。

## 轮换密码

怀疑密码泄露时，可对**整批**一键轮换：

1. **控制台 → ISP → 我的 IP → {批次} → 轮换密码**。
2. 新密码 60 秒内生效，旧密码立即失效。
3. 重新下载清单——IP 不变，`pass` 字段更新。

请勿手动改密码，网关侧不会接受。


---

# 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-2/proxy-list-format.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.