本文将针对傲游浏览器如何使用代理IP进行详细说明，具体步骤如下： ## 1 查看IP密钥 在【代理ip】-【按时业务/按量业务】里查看自己购买的代理ip，然后点击【查看详情】查看自己的代理IP业务信息（AuthKey和AuthPwd），具体如下图;   ## 2 提取代理IP 使用自己购买的AuthKey去【调试工具】里面选择【提取IP资源】获取ip，如下图：   ## 3 浏览器设置代理 ### 3.1 遨游浏览器设置代理 步骤如下： 打开傲游浏览器，点击右上角的菜单，再点击【设置】并在搜索栏里面输入【代理】进行搜索，如下图：   打开的设置页面中选择【使用自定义代理设置】然后点击【添加】；  在弹出的窗口输入【名称】，然后需要选择代理的类型，类型包括（http、https、socks模式），然后输入代理的【地址】跟【端口】，然后输入【用户名】和【密码】（用户名就是AuthKey，密码就是AuthPwd），输入完成后点击【确定】即可。  添加完成后选择刚刚添加的代理，点击【启用】即完成遨游浏览器的代理设置；  ### 3.2 设置成功验证 使用傲游浏览器打开浏览器打开https://www.baidu.com/s?word=ip ，查看ip是否和设置的代理ip相同，相同则为设置成功；  ### 3.3 取消代理设置 取消代理的话，直接在设置里面点击【不使用代理】即可取消掉。 
青果隧道代理与其他形式的代理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会失效。
**简要描述：** - 获取按量产品列表信息 **输入示例：** - https://qg.net/api/Proxyip/resourceSpecList **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "1":{ "Id": 62, "Spec_name": "短效代理1-5分钟", "Spec_no": "dtgx001", "Ip_nums": 10000, "Price": "30.00", "Months": 24, "Show_status": 1, "Buy_status": 1, "Group_type_id": 2, "Desc": "IP数量 : 同时可使用的IP数等于购买的通道数 \r\nIP存活时长 : IP长久有效\r\nIP可用率 : 99.9%\r\nIP重复率 : <1%\r\nIP分布地区 : 全国主要省份\r\n终端数限制 : 不限制\r\n带宽峰值限制 : 2Mbps\r\n地区筛选 : 支持指定获取某个城市IP或全国随机\r\n代理类型 : HTTP、HTTPS、SOCKS5\r\n", "Brand_name": "青果云", "Create_time": 1615887813, "Update_time": null, "Connect" : "33" } }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Id |integer |ID | |Spec_name |string |产品名称 | |Ip_nums |integer |IP数量 单位万个| |Price |float |价格 | |Months |integer |有效期 | |Show_status |integer |状态 1:显示 0：不显示 | |Buy_status |integer |状态 1:禁用 0：禁用 | |Desc |string |基本介绍| |Group_type_id |integer |规格ID| |Brand_name |string |品牌名称| |Connect |string |连接数| |Connect_limit |string |连接数限制| **备注** - 更多返回错误代码请看首页的错误代码描述
## 步骤总览
**注：若使用白名单验证模式，请先添加白名单再进行API接口获取。**
## 一、获取隧道地址
1.在开通隧道代理（全球HTTP）后，就会进入后台管理面板，会看到如以下画面。在业务列表中，可以看到对应的隧道地址。
隧道代理特殊的地方就在于不需要提取和管理大量IP，只需要拿到1个隧道地址便可直接在使用过程中获得所需动态IP，获取隧道地址就近似于获取其他代理产品的IP地址与端口。
**请注意，**目前国内代理IP和全球HTTP的产品，除了按量提取对应的套餐是按量业务之外，其他产品都属于按时业务。
#### 二、授权验证
获取隧道地址之后，还需要有授权验证才能使用代理。青果代理支持白名单和帐密两种验证方式，可自主选择使用。
白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功；
账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。
详细步骤可查看[代理验证](https://www.qg.net/doc/use/8_244/1574.html)
##三、代理测试
在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。
以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。
`curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`
若使用白名单模式，不需要添加authkey和authpwd。
`curl -x {隧道服务器} {目标url}`
例子 curl -x overseas.tunnel.qg.net:15561 www.baidu.com
## 四、编写采集程序
测试代理可用后，便可开始编写代理采集程序了。
青果提供了以下的编程语言的代码示例以及SDK下载包供开发者进行隧道代理参考，
＞＞[SDK下载](https://www.qg.net/doc/sdk/9_230/1745.html)
＞＞[隧道代理 Go 语言接入指南](https://www.qg.net/doc/sdk/9_230/1872.html)
＞＞[隧道代理 Python 语言接入指南](https://www.qg.net/doc/sdk/9_230/1879.html)
## 其他应用
另外，虽然隧道代理不需要API接口就能使用代理，但也提供了白名单验证的接口，以下简单介绍隧道相关的白名单接口使用以及一些指定功能。
### API列表
隧道不支持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
因为隧道代理每次请求都会随机更换IP，如果你希望随机范围限定在某个国家，可以通过添加国家编码参数来指定使用某个国家的IP。具体编码请查看 [区域编码表](https://www.qg.net/doc/1975.html)
```curl
curl -x {authkey}:{authpwd}:A{国家编码}@{隧道服务器} {目标url}
// 例子，指定使用美国IP
curl -x HBRMO154:4799868CE54:A990100@overseas.tunnel.qg.net:15561 www.baidu.com
```
### 保持IP不变
如果用户需要多个请求在维持一个IP，比如：需要登录,获取数据两个请求在一个IP下,则可对IP进行打标记，通过标记请求在代理有效期内使用相同的代理IP，并且可以支持设定该通道的存活时间。
```curl
curl -x {authkey}:{authpwd}:C{自定义通道名}:T{存活时间}:A{国家编码}@{隧道服务器} {目标url}
// 例子，通道名自定义为100，存活时间设为60秒
curl -x HBRMO154:4799868CE54:Cchannel-1:T60:A990100@overseas-us.tunnel.qg.net:15561 www.baidu.com
```
**注意：如果需要保持IP不变一段时间，那么不可以使用通用的overseas.tunnel.qg.net域名，需要使用特定地区的服务器域名，比如：overseas-us.tunnel.qg.net/overseas-hk.tunnel.qg.net等!!!否则服务器无法保证是否可以保持IP不变。**
### 指定隧道服务器
为了降低使用隧道服务的延迟，青果网络为隧道代理（全球HTTP）提供了多个隧道服务器，用户可根据自身的使用情况就近选择隧道服务器。隧道服务器的地址可在控制台中查看。
```curl
curl -x {authkey}:{authpwd}:C{自定义通道名}:T{存活时间}:A{国家编码}@{隧道服务器} {目标url}
// 例子，更换隧道服务器为美国的隧道服务器
curl -x HBRMO154:4799868CE54:Cchannel-1:T60:A990100@overseas-us.tunnel.qg.net:15561 www.baidu.com
```
## 概述 本文档将指引你进行隧道代理的接入，在此文档中使用到的术语将会在下方进行列出。 | 术语 | 解释 | | :------- | :----------------------------------------- | | 隧道 | 自动更换代理 IP 的代理服务 | | 固定时长 | 服务器将在固定时长后自动切换IP，例如1分钟 | | 通道 | 使用多个通道同时发起请求，每个通道的IP不同 | 隧道代理有多种使用方式，具体行为取决于套餐及模式。 - 普通模式 每次请求都自动切换IP - 普通模式打标记 普通模式下，希望多个HTTP请求保证代理IP相同，可以给多个请求的代理协议打上相同的标记，并标记这个代理IP的存活时间（不主动设置存活时间则默认为10秒） - 固定时长多通道模式 服务器定时切换IP，可同时使用多个通道发起请求，即可以同时使用多个IP ## 前置知识 在 go 语言中，通常使用 http.Client 进行 http/s 代理的设定与请求的发送，使用 http.NewRequest 进行请求的构建。 ### Proxy Url Scheme 由协议、用户名、密码、域名、端口几部分组成 例如 http 协议的代理 url ``` http://[user:password@]hostname:port ``` ## 使用 GO 接入 **以下内容假设读者具备基本的 Go 语言编程能力和对网络协议具有一定的了解。** ### 生成 url 普通模式 ```go link := fmt.Sprintf("http://%s:%s@%s", authKey, password, proxyServer) proxyURL, _ := url.Parse(link) ``` 普通模式打标记 ```go link := fmt.Sprintf("http://%s:%s:%s:%d@%s", authKey, password, "channel-1", 20, proxyServer) proxyURL, _ := url.Parse(link) ``` 固定时长多通道模式 ```go link := fmt.Sprintf("http://%s:%s:%s@%s", authKey, password, "channel-1", proxyServer) proxyURL, _ := url.Parse(link) ``` ### 构建 Client 后续将使用该 client 发起 request ```go client := http.Client{ Transport: &http.Transport{ Proxy: http.ProxyURL(proxyURL), }, } ``` ### 构建 HTTP/s GET 请求 以 https://api.ipify.org 为例。 因为已确认参数合法，因此构建不会发生错误，无需处理错误。 ``` request, _ := http.NewRequest("GET", "https://api.ipify.org", nil) ``` ### 执行已构建的 HTTP/s 请求 ```go response, err := client.Do(request) if err != nil { panic(err) } defer response.Body.Close() ``` ### 读取响应实体 response.Body 是 io.Reader 类型，需要手动进行读取 ```go body, err := io.ReadAll(response.Body) if err != nil { panic(err) } fmt.Println(string(body)) ``` ## 示例代码 ```go package main import ( "fmt" "io" "log" "net/http" "net/url" ) const ( authKey = "" password = "" server = "" channel = "channel-1" ) func main() { var link string if channel == "" { link = fmt.Sprintf("http://%s:%s@%s", authKey, password, server) } else { link = fmt.Sprintf("http://%s:%s:%s@%s", authKey, password, channel, server) } proxyURL, _ := url.Parse(link) client := http.Client{ Transport: &http.Transport{ Proxy: http.ProxyURL(proxyURL), }, } request, _ := http.NewRequest("GET", "https://api.ipify.org", nil) response, err := client.Do(request) if err != nil { panic(err) } defer response.Body.Close() body, err := io.ReadAll(response.Body) if err != nil { panic(err) } log.Println("response body", string(body)) } ```
1.点击如图位置图标，选择“Settings”  2.点击“Proxy”，勾选“Add a custom proxy configuration”，在Proxy Server处填入对应的代理IP和端口，设置Proxy Auth为“ON”即可在下方输入Username和Password。设置完成后关闭SETTINGS框即可 
**简要描述：** - 业务升级询价 **输入参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |suid |是 |string |业务标识 | |number |否 |integer | 升级后通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 | |connect |否 |integer | 升级后连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 | **输入示例：** - https://qg.net/api/Proxyip/getUpgradePrice?suid=xxx&number=1 **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 0, "Data": { "OriginalPrice": "160", "TotalPrice": "120", }, "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |OriginalPrice |float |原价 | |TotalPrice |float |应付价格 | **备注：** 更多返回错误代码请看首页的错误代码描述。
**简要描述：** 获取按时业务详细信息。 **参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |suid |是 |string |业务标识 | **输入示例：** - https://qg.net/api/proxyip/view?suid=ebt2c7qr **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "Authkey": "2BE0556E", "Number": 3, "Buy_time": "2021-03-25 14:46:50", "End_time": "2022-03-28 14:46:50", "Order_status": 1, "Type": 1, "Ip_type": 2, "Tunnel_url": "tunnel.qg.net:3434" }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Authkey |string |Authkey | |Number |integer |通道数| |Connect |integer |连接数| |Buy_time |string |购买时间| |End_time |string |到期时间| |Order_status |string |状态 1：正常, 3：过期,-4：开通失败; -5：续费失败, -6：升级失败, -7：锁定| |Type |integer |资源类型 1：独享,2：共享；3：独占| |Ip_type |integer |IP类型 1：静态,2：动态，3：隧道| |Tunnel_url |string |隧道地址| **备注：** 更多返回错误代码请看首页的错误代码描述。
**简要描述：** 按量产品购买。 **输入参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |spec_id |是 |integer| 按量产品ID | |resource_number |是 |integer | 购买数量 | |Authkey |否 |string |Authkey | **输入示例：** - https://qg.net/api/Proxyip/resourcePay?spec_id=888&resource_number=1 **返回示例** JSON格式 ``` { "RequestId": "28A6D3E5-2369-B23C-8020-C2DC58AB7474" "Code": 200, "Message": "购买成功", "Data": { "Resource_no": "FYdqRLDsS", "Authkey": "ZYJLHVK1", "Authpwd": "0DBF3A35A953", "Tunnel_url" : "tunnel.qg.net:3434" }, } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Resource_no |string |按量业务标识 | |Authkey |string |Authkey | |Authpwd |string |Authpwd | |Tunnel_url |string |隧道地址 | **备注：** 更多返回错误代码请看首页的错误代码描述。
Mac系统如何使用代理IP，本文将为你讲解，详细步骤如下： 在【系统偏好设置】里选择【网络】；  选择【高级】；  设置HTTP代理时如图进行设置，填写获取到的代理IP和端口号，填写密钥信息，用户名和密码对应的是青果代理业务中的【Authkey】和【AuthPw】，设置完成后点击【好】即可；  设置SOCKS代理时如图进行设置、填写获取到的代理IP和端口号，填写密钥信息，用户名和密码对应的是青果代理业务中的【Authkey】和【AuthPw】，设置完成后点击【好】即可；  点击【应用】；  使用浏览器查看IP与代理一致则说明设置成功。 
