独享代理开发手册

1. 接入准备

获取示例代码

请前往 代码示例&SDK下载，选择适合的语言库及版本。示例代码中附有详细注释，可直接复制并运行测试。

[!NOTE] 如果你还没确认连接信息或还没做首次验证，请先查看 快速入门 或 独享代理连接信息。

获取代理参数

登录后台后，可以查看账户中的代理数量、连通状态等信息。将以下 4 个认证参数配置到示例代码中，即可开始调用独享代理接口。

[!NOTE] 获取路径

登录后台后即可查看独享代理的认证信息。如无订单，请 开通测试订单。

2. 接口动作速查

这一部分只保留独享代理最常用的三个动作：查看当前 IP、手动切换 IP、查看当前统计信息。由于接口地址和 curl 示例都较长，这里统一改为 Tab 速查，避免并列卡片造成横向拉条。

3. 故障排查

独享代理最常见的问题集中在“认证失败”“链路不通”“代理未生效”三类。先用一个最短判断图定位现象，再执行对应动作。

Loading diagram...

第一步：用 curl 验证代理链路

先确认独享代理链路本身是否通畅，再继续排查业务代码。

#!/bin/bash
curl -x http://username:password@ip:port http://httpbin.org/ip

排查动作

返回 407，说明认证失败

• 核对独享代理的域名、端口、用户名和密码是否正确。
• 确认代码是否真的把代理认证信息配置到了请求里。

代理已配置，但 IP 没变化

• 使用 IP 查询类网站验证请求出口 IP 是否和本地不同。
• 如果返回 IP 与本地相同，通常说明请求未真正经过代理。

程序运行中断

• 网络请求、数据处理和存储过程中都可能出现瞬时错误。
• 建议补充异常保护机制、日志记录和必要的重试策略，提高程序稳定性。

HTTPS 请求异常

• 独享代理支持 HTTP 协议。
• 访问 HTTPS 目标时，仅需将目标 URL 设置为 HTTPS，无需额外配置证书。

4. 常见问题

浏览器可以访问接口，但程序请求失败

• 建议先直接使用示例代码，配置代理参数后测试最小链路。
• 若仍失败，优先排查运行环境、网络与防火墙，以及程序里是否真的写入了代理认证信息。

已配置独享代理，但出口 IP 没变化

• 通过代理访问 IP 查询类网站。
• 若返回 IP 与本地不同，则代理配置成功；若相同，则说明代理未生效。

已定位到状态码，但仍无法判断原因

• 如果已经定位到具体状态码，但仍无法确定原因，请继续查看 HTTP 错误码表。

5. 核心错误码