此示例Python使用Selenium调用Chrome浏览器并通过代理进行自动化测试。 - 代码示例 ```python import time import string import zipfile from selenium import webdriver from selenium.webdriver.chrome.service import Service targetURL = "http://myip.ipip.net" # 访问的目标站点 proxyHost = "61.171.76.145" # 代理IP地址 proxyPort = "50353" # 代理IP端口号 authKey = "x" # 代理IP的AuthKey password = "x" # 代理IP的AuthPwd def create_proxy_auth_extension(proxy_host, proxy_port, proxy_username, proxy_password, scheme='http', plugin_path=None): if plugin_path is None: plugin_path = r'./{}_{}_qgnet_proxyauth_plugin.zip'.format(proxy_username, proxy_password) manifest_json = """ { "version": "1.0.0", "manifest_version": 2, "name": "Chrome Proxy", "permissions": [ "proxy", "tabs", "unlimitedStorage", "storage", "<all_urls>", "webRequest", "webRequestBlocking" ], "background": { "scripts": ["background.js"] }, "minimum_chrome_version":"22.0.0" } """ background_js = string.Template( """ var config = { mode: "fixed_servers", rules: { singleProxy: { scheme: "${scheme}", host: "${host}", port: parseInt(${port}) }, bypassList: ["localhost"] } }; chrome.proxy.settings.set({value: config, scope: "regular"}, function() {}); function callbackFn(details) { return { authCredentials: { username: "${username}", password: "${password}" } }; } chrome.webRequest.onAuthRequired.addListener( callbackFn, {urls: ["<all_urls>"]}, ['blocking'] ); """ ).substitute( host=proxy_host, port=proxy_port, username=proxy_username, password=proxy_password, scheme=scheme, ) with zipfile.ZipFile(plugin_path, 'w') as zp: zp.writestr("manifest.json", manifest_json) zp.writestr("background.js", background_js) return plugin_path if __name__ == '__main__': # 此处指定您的webdriver路径，版本需要跟您所使用的Chrome版本一致， # 下载地址https://registry.npmmirror.com/binary.html?path=chromedriver/ driver_location = "./chromedriver/chromedriver_v106_win.exe" proxy_auth_plugin_path = create_proxy_auth_extension( proxy_host=proxyHost, proxy_port=proxyPort, proxy_username=authKey, proxy_password=password) option = webdriver.ChromeOptions() option.add_argument("--start-maximized") # 窗口最大化运行 option.add_extension(proxy_auth_plugin_path) # 添加proxy插件 # 此处selenium版本为4.8.0 driver = webdriver.Chrome(service=Service(driver_location), options=option) driver.get(targetURL) time.sleep(100) driver.quit() ``` - 运行结果 [](https://cos.qg.net/uploads/image/20220916/d1a8b394a7d64cdd99b120803390ac56.png)
ECS之类的按时计费产品购买后5天内可无理由退款，按量付费类产品不支持退款
## 1 概述 为了保证您购买的代理业务只有您的服务器才能使用，我们采用了IP白名单验证方式，通过设置IP白名单IP，除了您指定的服务器IP外，其他IP不能使用。 白名单可以免密钥验证，免费IP白名单鉴权数量高达256个，也就是说购买后您有256台独立外网IP的机器可以使用。不限制同时使用的终端设备数量，满足多业务需求。 需要注意的是，要在未提取IP之前添加白名单；短效代理产品不同key不能添加相同的白名单IP。 ## 2 步骤说明 ### 2.1 先查到您要使用的机器的外网IP。 如果是办公室电脑，可以访问https://ip.cn/api/index?ip=&type=0 查询您的外网IP； 如果是Linux服务器，可以通过如下命令查看机器外网IP：`curl https://d.qg.net/ip` ### 2.2 绑定您机器的IP作为白名单 根据您购买的代理业务，您可以在【会员中心-列表操作-白名单】或调试工具添加IP白名单，完成设置后，这些IP对应的机器就可以正常使用了。 **2.2.1 白名单管理** 进入会员中心，找到您所在的业务，点击右侧【更多】下的【业务设置】-【白名单管理】，进入设置；  你可以在该页面添加、删除白名单，详情如下图：  ** 2.2.2 调试工具** 在调试工具上勾选要使用的业务key，选择【IP白名单】模块相关操作接口，包括添加、删除和查询，输入您的机器外网IP，点击测试即可完成设置。详情如下图：   ### 2.3 API调用 白名单的设置也支持编程API对接与调用。 - [添加白名单IP＞ ](https://www.qg.net/doc/178.html "添加白名单IP＞ ") - [删除白名单IP＞](https://www.qg.net/doc/179.html "删除白名单IP＞") - [查询白名单IP＞](https://www.qg.net/doc/180.html "查询白名单IP＞")
青果隧道代理与其他形式的代理IP不同，不需要API接口即可连接使用代理IP，因此省去了获取IP和管理IP池等动作。以下介绍如何用代码方式，快速使用隧道代理。 ## 步骤总览  ## 一、获取隧道地址 1.在青果完成产品购买后，就会自动进入控制后台，看到如以下的页面，产品列中就有隧道地址；  **请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。 ## 二、授权验证 获取到隧道地址之后，还需要有授权验证才能使用代理。隧道代理支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。  详细步骤可查看[代理验证 ＞](https://www.qg.net/doc/use/8_244/1574.html) ## 三、代理测试 在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 `curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`  若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。 ## 四、编写采集程序 测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例以及SDK下载包供开发者参考， 详情查看 - [SDK下载](https://www.qg.net/doc/sdk/9_230/1745.html) - [隧道代理 Go 语言接入指南](https://www.qg.net/doc/1872.html) - [隧道代理 Python 语言接入指南](https://www.qg.net/doc/1879.html) **注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。
## 计费概述 青果代理IP产品购买方式：按时购买、按量购买，分别适用于不同场景下的用户需求。 ## 1 计费项及计费方式  *为保证获取到的价格的准确性，请您登录后查看。 ## 2 计费示例 产品：隧道代理（动态请求），10请求数/秒，时长6个月； 基础配置费用：360，隧道共享（动态请求），默认1个月，5请求/秒； 10请求数费用：（请求数-默认请求数）*请求数单价，60元/请求数，（10-5）×60=300； 总配置费用：基础价格*时长+请求数费用，360×6+300=3960元。 ## 3.续费说明 按时计费业务到期后将不可使用。如果您想继续使用代理IP资源，需要在指定时间内为业务续费，否则IP资源将不可用； 按量计费业务到期或用完之后无法续费，选择【复购】，会生成相同配置的业务； ## 4.支付与退款 购买代理IP产品，您可以选择以下支付方式： - 青果账户余额； - 在线支付，支持微信支付、支付宝，不能使用信用卡支付。
## PHP curl ```php /** * 请求 * * @param [type] $targetUrl 目标站点 * @param [type] $proxyIp 代理ip * @param [type] $proxyPort 代理端口 * @param [type] $proxyUser AuthKey * @param [type] $proxyPassword AuthPwd * @return void */ function sendRequest($targetUrl, $proxyIp, $proxyPort, $proxyUser, $proxyPassword){ $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $targetUrl); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_PROXYPORT, $proxyPort); curl_setopt($ch, CURLOPT_PROXYTYPE, 'HTTP'); curl_setopt($ch, CURLOPT_PROXY, $proxyIp); curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyUser . ':' . $proxyPassword); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); $data = curl_exec($ch); curl_close($ch); return $data; } $data = sendRequest('https://api.ipify.org', '请改成您的代理IP', 端口号, '请改成您的Key', '请改成您的AuthPwd'); var_dump($data); ``` ## PHP stream ```php /** * 请求 * * @param [type] $targetUrl 目标站点 * @param [type] $proxyIp 代理ip * @param [type] $proxyPort 代理端口 * @param [type] $proxyUser AuthKey * @param [type] $proxyPassword AuthPwd * @return void */ function sendRequest($targetUrl, $proxyIp, $proxyPort, $proxyUser, $proxyPassword){ $proxyAuth = base64_encode($proxyUser . ":" . $proxyPassword); $headers = implode("\r\n", [ "Proxy-Authorization: Basic {$proxyAuth}" ]); // 目标站为https时需要 // $sniServer = parse_url($targetUrl, PHP_URL_HOST); $options = [ "http" => [ "proxy" => $proxyIp . ':' . $proxyPort, "header" => $headers, "method" => "GET", "request_fulluri" => true, ], // 目标站为https时需要 // 'ssl' => array( // 'SNI_enabled' => true, // 'SNI_server_name' => $sniServer // ) ]; $context = stream_context_create($options); $result = file_get_contents($targetUrl, false, $context); return $result; } $data = sendRequest('https://api.ipify.org', '请改成您的代理IP', 端口号, '请改成您的Key', '请改成您的AuthPwd'); var_dump($data); ``` ## PHP GuzzleHttp ```PHP /** * 请求 * * @param [type] $targetUrl 目标站点 * @param [type] $proxyIp 代理ip * @param [type] $proxyPort 代理端口 * @param [type] $proxyUser AuthKey * @param [type] $proxyPassword AuthPwd * @return void */ function sendRequest($targetUrl, $proxyIp, $proxyPort, $proxyUser, $proxyPassword){ $client = new \GuzzleHttp\Client(); $proxyAuth = base64_encode($proxyUser . ":" . $proxyPassword); $options = [ "proxy" => $proxyIp . ':' . $proxyPort, "headers" => [ "Proxy-Authorization" => "Basic " . $proxyAuth ] ]; $result = $client->request('GET', $targetUrl, $options); return $result->getBody()->getContents(); } $data = sendRequest('https://api.ipify.org', '请改成您的代理IP', 端口号, '请改成您的Key', '请改成您的AuthPwd'); var_dump($data); ```
## 1说明
通过编码使用静态独享代理主要有以下三步骤：
（1）先在[会员中心](https://www.qg.net/user/ "会员中心")上查看购买的静态独享代理，进行本地调试和验证；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤＞＞")
（2）参考[代码样例](https://www.qg.net/list/192.html)请求静态独享代理；
（3）在程序中通过调用API接口获取代理，然后请求目标网站。
## 2 API接口
静态独享代理API接口一览
| 接口类型 | API | 描述 |
| ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [allocate](https://www.qg.net/doc/174.html "资源申请")
- [query](https://www.qg.net/doc/1504.html "获取IP资源池")
- [release](https://www.qg.net/doc/176.html "释放资源")
| - 调用 allocate申请代理IP资源
- 调用query查询IP资源池全部可用的IP信息
- 调用release释放申请到的IP，以便于再次进行IP申请。 |
| 白名单相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "删除白名单")
| - 调用 whitelist/query用于查询IP的白名单
- 调用whitelist/add用于添加IP的白名单
- 调用whitelist/del用于删除IP的白名单 |
| 资源信息查询 | - [info/quota](https://www.qg.net/doc/181.html "info/quota")
- [resources](https://www.qg.net/doc/177.html "查询区域资源") | - 调用 info/quota查询IP提取余量
- 调用extract查询平台可用的代理IP资源列表 |
定义：违反国家政策法规及《青果网络服务协议》相关协议、规则，涉及黄、赌、毒、低俗、色情、暴力、侵权等违规内容，如下：
（1）违反宪法确定的基本原则的。
（2）危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的。
（3）损害国家荣誉和利益的。
（4）煽动民族仇恨、民族歧视，破坏民族团结的。
（5）破坏国家宗教政策，宣扬邪教和封建迷信的。
（6）散布谣言，扰乱社会秩序，破坏社会稳定的。
（7）散布淫秽、色情、赌博、暴力、恐怖或者教唆犯罪的。
（8）侮辱或者诽谤他人，侵害他人合法权益的。
（9）煽动非法集会、结社、游行、示威、聚众扰乱社会秩序。
（10）以非法民间组织名义活动的。
（11）含有侵害他人名誉权、肖像权、知识产权、商业秘密等合法权利的内容。
（12）涉及他人隐私、个人信息或资料的内容。
（13）发表、传送、传播骚扰信息、广告信息及垃圾信息或含有任何性或性暗示的内容。
（14）含有法律、行政法规禁止的其他内容的。
定义：违反国家政策法规及《青果网络服务协议》相关协议、规则，使用青果网络产品进行网络恶意行为的，如下：
（1）实施网络拒绝服务攻击、黑客攻击、网络扫描、恶意爬虫等。
（2）实施网络欺诈，网络钓鱼等。
（3）发送垃圾邮件，钓鱼邮件。
（4）传播病毒木马，非法控制其他计算机。
（5）违规部署境内获取境外非法信息的工具等。
（6）因应用遭受大规模 DDoS 攻击影响平台其他开发者正常服务。
根据《互联网信息服务管理办法》第十五条，互联网信息服务提供者不得制作、复制、发布、传播含有下列内容的信息：
（一）反对宪法所确定的基本原则的。
（二）危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的。
（三）损害国家荣誉和利益的。
（四）煽动民族仇恨、民族歧视，破坏民族团结的。
（五）破坏国家宗教政策，宣扬邪教和封建迷信的。
（六）散布谣言，扰乱社会秩序，破坏社会稳定的。
（七）散布淫秽、色情、赌博、暴力、凶杀、恐怖或者教唆犯罪的。
（八）侮辱或者诽谤他人，侵害他人合法权益的。
（九）含有法律、行政法规禁止的其他内容的。
部分违规类型说明如下：
包括但不限于以下违规内容的信息：
《全国整治互联网低俗之风专项行动方案》中明确的低俗内容：
（1）表现或隐晦表现性行为、令人产生性联想、具有挑逗性或者污辱性的内容。
（2）对人体性部位的直接暴露和描写。
（3）对性行为、性过程、性方式的描述或者带有性暗示、性挑逗的语言。
（4）对性部位描述、暴露，或者只用很小遮盖物的内容。
（5）全身或者隐私部位未着衣物，仅用肢体掩盖隐私部位的内容。
（6）带有侵犯个人隐私性质的走光、偷拍、漏点等内容。
（7）以挑逗性标题吸引点击的。
（8）相关部门禁止传播的色情、低俗小说，音视频内容，包括一些电影的删节片段。
（9）一夜情、换妻、SM 等不正当交友信息。
（10）情色动漫。
（11）宣扬血腥暴力、恶意谩骂、侮辱他人等内容。
（12）非法“性药品”广告和性病治疗广告。
（13）未经他人允许或利用“人肉搜索”恶意传播他人隐私信息。
相关法律法规参考：《中华人民共和国治安管理处罚法》、《中华人民共和国刑法》、《全国人民代表大会常务委员会关于维护互联网安全的决定》。
包括但不限于以下违规内容的信息：
相关法律法规参考： 《中华人民共和国治安管理处罚法》、《中华人民共和国刑法》。
包括但不限于以下违规内容的信息：
相关法律法规参考： 《中华人民共和国治安管理处罚法》、《中华人民共和国刑法》、《全国人民代表大会常务委员会关于维护互联网安全的决定》。
包括但不限于以下违规内容的信息：
相关法律法规参考： 《中华人民共和国网络安全法》、《计算机信息网络国际互联网安全保护管理办法》、《中国公用计算机互联网国际联网管理办法》、
、《国际通信出入口局管理办法》、《中华人民共和国刑法》 、《关于办理扰乱无线电通讯管理秩序等刑事案件适用法律若干问题的解释》、《中华人民共和国治安管理处罚法》 、《关于依法办理非法生产销售使用“伪基站”设备案件的意见》。
包括但不限于以下违规内容的信息：
相关法律法规参考： 《中华人民共和国刑法》 、《中华人民共和国刑法》、《电信条例》、
《中华人民共和国反不正当竞争法》、
《中华人民共和国烟草专卖法》、《中华人民共和国烟草专卖法实施条例》。
包括但不限于以下违规内容的信息：
相关法律法规参考： 《最高人民法院、最高人民检察院关于办理诈骗刑事案件具体应用法律若干问题的解释》 、《中华人民共和国刑法》、《中华人民共和国著作权法》、《全国人民代表大会常务委员会关于维护互联网安全的决定》。
包括但不限于以下违规内容的信息：
相关法律法规参考：《中华人民共和国刑法》、《中华人民共和国著作权法》、《全国人民代表大会常务委员会关于维护互联网安全的决定》。
```c++
#include
##### 1.IP的申请 第一步，进入【调试工具】后，选择接口方法为【获取IP资源】； 第二步，在Key的输入框输入已购买的代理IP业务AuthKey值； IP数量、地区、运营商等都可选择，填写完成后,点击测试按钮即可进行申请,申请成功返回结果为如下图所示；  同时也可使用【提取工具】，选择已购买可用的AuthKey值,根据实际需求提取对应的IP，IP最终以文本形式或API形式输出，如下图所示；  ##### 2.资源释放 第一步，进入【调试工具】后，选择接口方法为【资源释放】； 第二步，在Key的输入框选择已购买的代理IP业务AuthKey； 如需要释放一个或多个IP，可在IP的输入框中指定IP地址（不加端口号）；也可以填写TaskID，可以释放某次申请任务的多个IP。 填写完成后,点击测试按钮即可进行释放,释放成功返回结果为如下图所示。  注意： IP和TaskID 必须填写其中一项才能进行释放，如果不指定IP，在其中一个输入框中填*，即释放所有已申请的IP。
