说明

蜻蜓代理 是一家企业级HTTP代理IP提供商，专注于爬虫数据采集业务。

我们提供两个服务：

1. 私密代理：用户需通过 API 接口获取代理 IP 列表，使用 IP 白名单进行身份验证，适合需要自主管理 IP 池、灵活度要求高的开发者。
2. 隧道代理：平台提供统一的入口，云端动态转发请求，每次请求自动切换新 IP。使用账号密码验证，极简接入。

这个仓库是各种编程语言、多框架使用我们服务的示例代码。其中，secret_proxy 代表私密代理，tunnel_proxy 代表隧道代理。

编程语言示例

• Python — 标准库 / 第三方库（requests） / HTTPX（异步 HTTP 客户端）
• Java — 标准库 / 第三方库（OkHttp + Gson）
• Node.js — 标准库 / 第三方库（axios）
• C# — 标准库 / 第三方库（RestSharp）
• PHP — 标准库 / 第三方库（GuzzleHttp）
• C++ — 第三方库（libcurl + nlohmann/json）
• C — 第三方库（libcurl）
• Go — 标准库 / 第三方库（go-resty/resty）
• Ruby — 标准库 / 第三方库（httparty）
• Swift — 标准库 / 第三方库（Alamofire）
• Rust — 第三方库（reqwest + tokio + serde）
• Perl — 标准库 / 第三方库（LWP::UserAgent）
• Delphi — 标准库 / 第三方库（Indy）
• VB.NET — 标准库 / 第三方库（RestSharp）
• 易语言 — 标准库

浏览器自动化

工具	语言	目录	备注
Selenium	Python	查看
Playwright	Node.js	查看
Puppeteer	Node.js	查看
PhantomJS	Python	查看	⚠️ 已停止维护
Splash	Python	查看
Requests-HTML	Python	查看	内置 Pyppeteer 渲染
ChromeDP	Go	查看
Rod	Go	查看
Crawlee	Node.js	查看
Camoufox	Python	查看
Botright	Python	查看
Rebrowser	Node.js	查看
Rendertron	Python	查看
Ferret	Go	查看

爬虫框架

框架	语言	目录	备注
Scrapy	Python	查看
Crawlee	Python	查看
Crawl4AI	Python	查看	AI/LLM 友好
Firecrawl	Python	查看
PySpider	Python	查看	维护频率较低
EasySpider	Python	查看

错误码定义

私密代理 API 错误码

调用提取接口（API）时返回的错误信息。

错误码	说明
10001	接口调用频率过快
10003	参数有误：请检查请求参数是否完整或格式正确
20002	服务不可用：可能原因包括订单过期、未支付、剩余可提取数不足等
20009	订单号不存在：请确认输入的订单号是否正确

---

私密代理 IP / 隧道代理错误码

用于在使用代理进行网络请求时返回的状态码。

错误码	说明
407	需要身份验证：代理鉴权失败，请检查用户名密码或白名单配置
429	超过并发限制：请降低并发频率，或调整/升级隧道代理套餐
500	内部服务器错误：通常由请求超时或连接被拒绝引起，请务必做好代码层面的异常处理
502	Bad Gateway，连接目标失败
504	Gateway Timeout，连接超时

注意事项

Java 环境配置

Java 8 以上版本，请在运行的时候加上以下参数：-Djdk.http.auth.tunneling.disabledSchemes="" 具体原因请参考Unable to tunnel through proxy since Java 8 Update 111 (StackOverflow)

Python requests 库

使用 requests 第三方 HTTP 网络库的过程中，如果出现 407 身份验证错误，请使用 2.27.1 以上版本。官方已针对此问题进行了修复。 参考链接：GitHub PR #6028: Fix auth parsing for proxies

获取帮助

如果您在接入过程中遇到任何问题，点击下面的按钮，联系我们。

联系在线客服

开源协议

本项目采用 MIT License 开源。