极安代理 - 代理IP接入指南：配置、测试与上线步骤

## 接入代理IP前要先确认哪些条件？

**接入前应先确认任务地区、代理类型、协议、鉴权方式和目标访问规则。**这些条件没有明确，后续即使连通，也可能出现出口地区不符、会话中断或请求成本失控。

| 确认项   | 需要回答的问题                     | 对接入方式的影响         |
| -------- | ---------------------------------- | ------------------------ |
| 任务地区 | 访问目标位于国内还是海外           | 决定选择国内或海外资源   |
| 使用周期 | 需要短时IP还是持续转发             | 决定API提取或隧道接入    |
| 代理协议 | 程序支持HTTP、HTTPS还是SOCKS5      | 决定客户端配置格式       |
| 鉴权方式 | 使用IP白名单还是用户名密码         | 决定凭证与出口网络配置   |
| 会话要求 | 是否要求固定出口或长会话           | 决定能否使用动态出口产品 |
| 访问边界 | 数据是否公开、已授权，频率是否允许 | 决定任务能否进入接入流程 |

第一次接入时，应先区分代理服务器、出口IP与鉴权信息，再确定产品类型。极安代理支持HTTP、HTTPS、SOCKS5，并提供IP白名单和用户名密码两种鉴权方式（来源：极安代理官网）。

短周期国内任务可评估国内短效代理，持续请求可评估国内隧道代理；海外动态住宅代理采用全球HTTP隧道形态，不支持在中国大陆地区网络环境下使用（来源：极安代理官网）。接入前还应核对访问授权、会话要求和网络环境，国内与海外产品不能共用同一组参数判断。

## 代理地址、鉴权和连通性该怎么配置？

**代理地址应作为受控配置项注入程序，不应直接写进业务代码、公开仓库或普通运行日志。**推荐把协议、主机、端口、用户名和密码分别保存在环境变量或密钥管理系统中。

基础配置可以抽象为以下字段：

```text
PROXY_SCHEME=http
PROXY_HOST=proxy.example.com
PROXY_PORT=0000
PROXY_USERNAME=your_username
PROXY_PASSWORD=your_password
```

使用用户名密码鉴权时，可在运行时组装代理地址：

```text
http://your_username:your_password@proxy.example.com:0000
```

使用IP白名单时，客户端通常不需要在代理地址中携带账密，但应确认业务服务器的固定公网出口已经加入白名单。开发电脑、测试服务器和生产服务器的公网出口可能不同，不能只在本地验证后直接上线。

配置阶段应同时执行四项安全检查：

1. 凭证不进入代码仓库、截图和普通日志。
2. 测试与生产使用不同的配置项和权限范围。
3. 代理密码支持轮换，停用环境及时回收凭证。
4. 白名单仅保留仍在使用的业务出口地址。

### 如何在命令行验证代理是否连通？

**第一次测试只验证三件事：代理端口能否连接、鉴权是否通过、请求是否从预期出口发出。**不要在这个阶段直接运行完整采集任务。

使用支持代理参数的命令行工具时，可按以下占位格式测试：

```bash
curl --proxy http://proxy.example.com:0000 \
  --proxy-user your_username:your_password \
  --connect-timeout 10 \
  https://your-authorized-test-endpoint.example/ip
```

返回结果至少要记录：

| 检查项   | 通过标准                         | 常见异常方向                 |
| -------- | -------------------------------- | ---------------------------- |
| TCP连接  | 能连接代理主机与端口             | 地址、端口、防火墙或网络线路 |
| 代理鉴权 | 不返回鉴权失败                   | 用户名、密码或白名单配置     |
| HTTP状态 | 测试地址返回预期状态             | 目标地址、协议或请求方法     |
| 出口IP   | 与未使用代理时不同且地区符合预期 | 代理未生效或节点地区不匹配   |
| 响应内容 | 内容结构完整、无中间错误页       | 目标服务、证书或转发异常     |

测试地址应使用企业自有、已获授权或明确允许检查出口的服务。不要把第三方业务页面当作无限频率的连通测试接口。

## 程序接入和质量测试该怎样完成？

**程序接入应把代理配置、超时、错误分类和重试边界分开处理。**下面示例使用环境变量读取代理信息，并同时配置HTTP与HTTPS请求的代理入口。

```python
import os

import requests

proxy_url = os.environ[PROXY_URL]
proxies = {
    http: proxy_url,
    https: proxy_url,
}

response = requests.get(
    os.environ[AUTHORIZED_TEST_URL],
    proxies=proxies,
    timeout=(10, 30),
)
response.raise_for_status()
print(response.text)
```

示例只展示最小接入路径，生产程序还应区分以下错误：

| 错误类别     | 典型表现                 | 处理原则                           |
| ------------ | ------------------------ | ---------------------------------- |
| 连接错误     | 无法连接代理地址         | 检查网络、地址和端口，不盲目重试   |
| 鉴权错误     | 返回代理认证失败         | 停止任务并校验凭证或白名单         |
| 连接超时     | 建连时间超过阈值         | 记录节点与线路信息，按策略有限重试 |
| 读取超时     | 已连接但响应未完成       | 检查目标服务、响应体积和读取阈值   |
| 业务响应异常 | 状态正常但内容不符合预期 | 校验请求参数、账号条件和页面结构   |

重试只适合暂时性的网络错误。鉴权失败、参数错误和访问规则不允许等问题应立即停止，避免把配置问题放大成持续异常请求。

### 接入测试要覆盖哪些指标？

**上线前测试不能只看单次可用，还要覆盖连续请求、出口变化、响应时间、错误分布和业务结果。**所有方案应在相同目标、地区、并发和时间窗口下比较。

建议建立四层验收表：

1. **连接层：**代理地址可达，协议和鉴权均通过。
2. **出口层：**出口IP、国家、城市或运营商符合任务要求。
3. **请求层：**连续请求的连接成功率、响应时间和错误类型可记录。
4. **业务层：**目标字段完整，页面或接口返回结果符合授权任务预期。

极安国内代理的平均响应时间低于0.1秒，IP可用率为99.9%；国内隧道代理默认每秒5个请求、默认5M带宽，并支持异常IP自动切换（来源：极安代理官网）。这些是产品公开参数，不等于具体招投标数据或舆情监测任务的成功率，仍需用真实请求验证。

## 代理IP怎样灰度上线并持续监控？

**上线应采用小流量灰度，而不是把全部任务一次性切换到新代理。**灰度阶段的目标是验证真实并发、错误处理和监控链路是否与测试结果一致。

推荐按以下顺序推进：

| 阶段       | 主要动作                 | 进入下一阶段的条件           |
| ---------- | ------------------------ | ---------------------------- |
| 本地验证   | 测试代理配置、鉴权与出口 | 单请求结果符合预期           |
| 测试环境   | 运行完整业务流程         | 字段、日志与错误分类完整     |
| 小流量灰度 | 选择部分合规任务接入     | 错误率与响应时间处于内部阈值 |
| 分批放量   | 逐步增加任务量与并发     | 代理与目标服务均无持续异常   |
| 正式上线   | 纳入日常调度与值守       | 监控、告警和回退路径可用     |

生产切换前，应保留原网络路径或暂停任务的能力。出现鉴权异常、错误持续升高、出口地区偏移或业务字段缺失时，系统应能停止放量并回到已验证状态。

### 上线后要监控哪些信号？

**上线后的监控至少要覆盖代理连接、出口资源、业务响应和成本用量。**只监控程序是否运行，无法判断代理链路是否已经影响数据质量。

| 监控维度 | 建议记录                   | 触发处理的信号           |
| -------- | -------------------------- | ------------------------ |
| 连接     | 连接错误、超时、鉴权失败   | 同类错误连续上升         |
| 出口     | 出口IP、地区、切换次数     | 地区偏移或出口变化异常   |
| 响应     | 状态码、响应时间、内容长度 | 延迟持续升高或错误页增加 |
| 业务     | 字段完整率、重复率、空结果 | 数据结构或结果分布突变   |
| 用量     | 请求量、并发、流量         | 超出预算或套餐边界       |

日志中应使用请求ID关联代理错误与业务结果，但不要记录完整代理密码。排查时先区分代理层、目标服务层和业务解析层，避免把所有失败都归因于IP节点。

## 这套接入流程该落到极安哪类产品？

代理IP接入方式应由任务周期和调度责任决定：阶段性任务关注IP有效期与提取方式，持续任务关注统一入口、异常节点处理和运行观测。

国内短周期任务可评估极安代理的国内短效代理，支持1／3／5／10／15分钟五档有效期和API提取；国内持续请求可评估国内隧道代理，支持统一入口、毫秒级更换IP和异常IP自动切换（来源：极安代理官网）。两类产品都应先完成小规模测试，再根据真实错误分布决定是否放量。

接入完成不等于上线完成。只有配置可复现、测试可量化、异常可定位、任务可回退，代理IP才真正进入可维护的生产链路。

## 常见问题

**Q1：代理IP接入后，怎样确认程序真的走了代理？**

A：分别记录未使用代理和使用代理时的出口IP，并检查代理服务端请求记录。只看到请求成功还不够，还应确认出口地区、鉴权账户和目标请求时间能够相互对应，避免系统代理、程序代理和容器网络配置不一致。

**Q2：IP白名单和用户名密码鉴权该选哪个？**

A：业务服务器具有固定公网出口时，可评估IP白名单；出口经常变化或需要多环境独立授权时，用户名密码更便于管理。两种方式都应限制权限范围，并建立凭证轮换、白名单清理和停用回收机制。

**Q3：代理请求失败后可以一直重试吗？**

A：不可以。连接超时等暂时性错误可按有限次数和退避策略重试；鉴权失败、请求参数错误或访问规则不允许时应立即停止。持续无差别重试会扩大故障、增加成本，也不利于判断真实原因。

**Q4：测试环境正常，生产环境为什么仍可能失败？**

A：生产环境的公网出口、DNS、并发、证书、白名单和目标访问频率可能与测试环境不同。上线前应从生产网络执行同一套连通、出口和业务验证，并通过小流量灰度观察实际错误分布。

**Q5：极安代理接入时最先验证什么？**

A：我们极安代理在招投标数据和舆情监测接入中，优先验证鉴权、出口地区、连续请求和业务字段，再决定是否放量。产品公开参数用于筛选方案，真实任务测试才用于形成上线结论。