极安代理 - 动态住宅代理-使用指南-开发版

## 步骤总览
![image-20250715175839538](https://article.ja.cn/Uploads%2Fimage%2F2025-07-15%2F17583919b60a6.png)

**注：动态住宅代理使用方式与国内隧道代理类似，只需一个隧道地址，即可随机动态出口IP，免去提取和切换动作。**

## 1 获取隧道地址
1.完成产品购买后，页面自动跳转进入控制后台，看到如以下的页面，产品页中就有隧道地址；

![image-20250716143351555](https://article.ja.cn/Uploads%2Fimage%2F2025-07-16%2F1433518108bc4.png)
**隧道地址用于连接代理服务，密钥信息用于验证代理身份**

## 2 授权验证

获取到隧道地址之后，还需要有授权验证才能使用代理。隧道代理支持白名单和帐密两种验证方式，可自主选择使用。

#### 白名单模式
即把要实现代理的服务器IP添加进该代理业务的白名单中，后续就能顺利在该IP环境中连接代理；
![image-20250716142503901](https://article.ja.cn/Uploads%2Fimage%2F2025-07-16%2F1425039d322ae.png)
![image-20250716142830167](https://article.ja.cn/Uploads%2Fimage%2F2025-07-16%2F14283013c6fee.png)

#### 账密模式
即先获取该代理业务的密钥信息（即图中的Authkey与Authpwd），连接代理时填入进行验证就可使用代理。
![image-20250716142736994](https://article.ja.cn/Uploads%2Fimage%2F2025-07-16%2F1427376b71d65.png)

详细操作可查看[代理验证 ＞](https://www.ja.cn/doc/2789.html)

## 3 代理测试

在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。

以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。

`curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}`

![image-20240429171647434](https://article.ja.cn/Uploads%2Fimage%2F2024-04-29%2F171647213d98a.png)

若响应不成功，可对应[错误码表](https://www.ja.cn/doc/2776.html)，排查问题。

## 4 编写采集程序

测试代理可用后，便可开始编写代理采集程序了。

## 5 其他应用

另外，虽然隧道代理不需要API接口就能使用代理，但也提供了白名单验证的接口，以下简单介绍隧道相关的白名单接口使用以及一些指定功能。

### 白名单API列表

隧道不支持API的调用，只有白名单功能的API接口。

| 接口类型   | 接口                    |
| ---------- | --------------------- | ------------------ |
| 白名单相关 |  [添加白名单IP](https://www.ja.cn/doc/2777.html)<br/>[删除白名单IP](https://www.ja.cn/doc/2778.html) <br/>[查询白名单IP](https://www.ja.cn/doc/2779.html) <br/>

### 支持通过账密指定参数

####参数规则

| 参数   | 含义                 | 格式            |示例
| ---------- | --------------------------- | ---------------------- |----------------------- |
| -A-   | 指定地区（单个）  | -A-{国家编码} 或 -A-{国家英文缩写}  |-A-990100 / -A-US  |
| -C- | 指定通道 | -C-{通道名} |-C-tunnel3 |
| -S- | 指定通道（同 -C-） | -S-{通道名} |-S-tunnel1 |
| -T- | 指定存活时长（秒） | -T-{秒数} | -T-60 |

* -A- 格式支持拼在authkey后面，也支持拼在authpwd后面。同时支持国家编码和英文国家/地区缩写（如 US、JP、KR、GB 等）。
兼容旧格式 :A、:C、:T（如 :A990100、:Cchannel-1、:T60），旧格式仅支持拼在密码后面。

####参数拼接说明
所有参数不区分位置，可以拼接在 Authkey（用户名） 后面，也可以拼接在 AuthPwd（密码） 后面，也可以两边同时拼接，顺序不固定。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
```
示例：
```curl
// 参数全部拼在 Authkey 后面
curl -x authkey-C-tunnel1-A-US-T-60:password@overseas-hk.tunnel.ja.cn:12195 ip.sb

// 参数全部拼在 AuthPwd 后面
curl -x authkey:password-C-tunnel1-T-60-A-US@overseas-hk.tunnel.ja.cn:12195 ip.sb

// 参数分散在两边
curl -x authkey-T-60:password-A-US-C-tunnel1@overseas-hk.tunnel.ja.cn:12195 ip.sb
```
优先级： 当两侧同时指定了相同参数时，密码侧优先。

####指定使用某个国家的IP

隧道代理每次请求会随机更换IP，通过 -A- 可将随机范围限定到某个地区。
使用英文缩写
```curl
curl -x authkey-A-US:password@overseas-hk.tunnel.ja.cn:12195 ip.sb
// 或
curl -x authkey:password-A-US@overseas-hk.tunnel.ja.cn:12195 ip.sb
```
使用国家编码
```curl
curl -x authkey-A-990100:password@overseas-hk.tunnel.ja.cn:12195 ip.sb
// 或
curl -x authkey:password-A-990100@overseas-hk.tunnel.ja.cn:12195 ip.sb
```
编码详见 [海外区域编码表](https://www.ja.cn/doc/2793.html)，英文缩写采用 ISO 标准国家/地区代码。

```保持IP不变
如果需要多个请求维持同一个IP（如登录 + 获取数据），可通过 -T- 指定存活时长（单位：秒）。
隧道代理下，-T- 必须与 -S-（或 -C-）同时传或同时不传。 通道名为任意非特殊符号字符串。
```curl
// 参数全在用户名侧
curl -x authkey-T-30-S-tunnel1:password@overseas-hk.tunnel.ja.cn:12195 ip.sb

// 参数全在密码侧
curl -x authkey:password-T-30-S-tunnel1@overseas-hk.tunnel.ja.cn:12195 ip.sb

// 参数分布在两侧
curl -x authkey-T-30:password-S-tunnel1@overseas-hk.tunnel.ja.cn:12195 ip.sb
```
* 注意： 仅指定 -T- 而不指定通道，无法保证IP不变。如果需要保持IP不变一段时间，那么不可以使用通用的overseas.tunnel.ja.cn域名，需要使用特定地区的服务器域名，比如：overseas-us.tunnel.ja.cn/overseas-hk.tunnel.ja.cn等!!!否则服务器无法保证是否可以保持IP不变。

####组合使用
多个参数可以自由组合，顺序不限。
// 英文缩写指定美国 + 通道 + 存活时长
```curl
curl -x authkey-A-US-S-tunnel1-T-30:password@overseas-hk.tunnel.ja.cn:12195 ip.sb

// 编码方式指定美国 + 通道 + 存活时长（参数在密码侧）
curl -x authkey:password-A-990100-C-tunnel3-T-30@overseas-hk.tunnel.ja.cn:12195 ip.sb

// 参数分布在两侧
curl -x authkey-A-JP-T-30:password-S-tunnel1@overseas-hk.tunnel.ja.cn:12195 ip.sb
```

####指定隧道服务器

为了降低使用隧道服务的延迟，青果网络为隧道代理（全球HTTP）提供了多个隧道服务器，用户可根据自身的使用情况就近选择隧道服务器。隧道服务器的地址可在控制台中查看。
```curl
curl -x {Authkey}{参数}:{AuthPwd}{参数}@{隧道服务器} {目标url}
// 例子，更换隧道服务器为美国的隧道服务器
curl -x authkey-A-US-S-tunnel1-T-30:password@overseas-hk.tunnel.ja.cn:12195 ip.sb
```