简介
欢迎使用蜻蜓代理服务！我们提供私密代理和隧道代理两种产品，帮助您高效、稳定地完成数据采集。
- 预计接入时长：15 分钟
- 前置条件：已注册账号并完成实名认证
1. 哪种代理适合您？（产品选型）
| 特性对比 | 私密代理 | 隧道代理 |
|---|---|---|
| 适用场景 | 高并发、高定制、需自行管理 IP 池 | 无需维护 IP 池，接入更便捷 |
| IP 切换方式 | 开发者通过 API 提取，自己在代码中切换 | 平台云端自动切换 |
| 鉴权方式 | IP 白名单认证 | 账号密码认证 |
| 详细接入文档 | 查看私密代理文档 | 查看隧道代理文档 |
计费说明：我们目前只有按时长计费的套餐，包括：包天、包月、包季、包年。
2. 接入流程
接入整体流程概览： 注册账号 → 完成实名认证 → 选择代理类型 → 阅读对应文档 → 开发与调试
如果是私密代理服务，需要：
- 生成私密代理 API 链接：私密代理 API 链接生成
- 添加白名单 IP：白名单 IP 添加
- 完成私密代理测试：编写 demo 代码，从 API 链接中提取 IP，并通过该 IP 发起请求
- 编写采集程序并开始抓取
如果是隧道代理服务，则需要：
- 从后台获取隧道代理的用户名和密码：隧道代理订单列表 (订单号即为用户名)
- 完成隧道代理测试：编写 demo 代码
- 编写采集程序并开始抓取
3. 快速开始（Quick Start）
4. 通用 API
- 配置私密代理的 IP 白名单（私密代理用户必看）： 白名单配置与 API 文档
- 接口 token 管理： 如何重置您的 Token
5. 常见错误码与排查
| 错误码 | 含义 | 排查建议 |
|---|---|---|
| 403 | 目标网站拒绝访问 | ① 目标站可能封禁了该 IP，重新提取代理重试 ② 检查请求头是否缺少必要字段（如 User-Agent） |
| 407 | 代理鉴权失败 | ① 隧道代理：检查账号密码是否正确、订单是否过期 ② 私密代理：检查服务器 IP 是否已加入白名单 |
| 429 | 并发/频率超限 | 降低请求频率或升级套餐 |
| 502 | 代理网关错误 | 代理节点异常，稍后重试或更换代理 IP |
| 503 | 服务暂时不可用 | 目标站或代理节点过载，代码中增加重试机制 |
| 5xx | 其他服务端异常 | 代码中增加重试机制，连续失败时更换代理 IP |
| 连接超时 | 代理连接超时 | ① 检查代理 IP 是否已过期（私密代理 IP 有存活时长限制） ② 检查网络连通性 ③ 适当增大 timeout 值 |
| 读取超时 | 目标站响应超时 | ① 目标站响应慢，适当增大 timeout ② 目标站可能限制了该 IP，更换代理重试 |
提示：建议在采集程序中统一封装重试逻辑，遇到上述错误时自动切换代理 IP 并重试，可显著提高采集成功率。
6. 获取帮助
如果您在接入过程中遇到任何问题，点击下面的按钮，联系我们。
⚠️ 安全提醒：请妥善保管您的 API Token 和隧道代理密码，不要将其泄露给他人或提交到公开代码仓库（如GitHub）。如果怀疑凭证已泄露，请立即重置 Token并修改隧道代理密码。
