🖥️ 代理IP测试工具 使用说明书

面向普通用户的完整操作指南

适用版本：2023.4.17.1639

📋 目录导航

1. 功能导航总览

2. 连通率测试

• 导入代理IP

• 设置验证目标

• 选择协议类型

• 配置测试参数

• 开始测试与查看结果

3. IP时长测试

4. 白名单管理

5. 去重查转（IP转换工具）

6. 常见问题速查表

7. 使用小技巧

一、功能导航总览

软件顶部是一排功能按钮，点击即可切换到对应功能界面：

🔗

连通率测试

测试代理IP质量
检测是否可用

⏱️

IP时长测试

测试持续可用时间
判断短效/长效

📋

白名单管理

管理代理商白名单
增删查改

🔄

去重查转

IP格式转换
批量去重对比

界面右上角会显示当前外网IP，方便您确认自己的网络出口地址。

二、连通率测试

2.1 这个功能是做什么的？

连通率测试是软件最核心的功能，用于批量检测代理IP的质量。它会通过每个IP去访问指定的网站，如果返回了正确的内容，就说明该IP可用；否则判定为失效。

2.2 操作步骤

第一步：导入代理IP

在软件左侧有一个大的数据表格，您需要先把要测试的代理IP导入进来。

📥 三种导入方式

📋 支持的格式（每行一个）

软件支持多种IP格式，自动识别并转换为标准格式：

🔗 API链接直接导入（重要！）

这是一个非常实用的功能——您可以直接粘贴代理商的API链接，软件会自动请求API接口，获取返回的代理IP列表并导入测试。

操作方法：

1. 获取您的代理商API链接（通常在代理商后台可以找到）

2. 复制完整的API链接，例如：

   http://api.huolongip.cn:7772/Tools/proxyIP.ashx?action=GetIP&OrderNumber=70fe33c6...&qty=100

3. 将API链接粘贴到导入框中（右键导入或直接粘贴均可）

4. 软件会自动识别这是一个URL，然后：

• 判断是否为石头IP等特定代理商API

• 如果是，使用专用解析器处理

• 如果不是，使用通用API解析器处理

• 自动发送HTTP请求获取IP数据

• 解析返回的JSON格式数据

• 将所有返回的代理IP添加到测试列表

支持的API类型：

• ✅ 石头IP（ShiTouIP）API — 自动识别并使用专用解析器

• ✅ 通用API — 任何返回标准JSON格式的代理IP API

• ✅ 支持带参数的复杂API链接

• ✅ 支持批量导入多个API链接（每行一个）

示例：如何使用API导入

1. 假设您从代理商后台获取了这个API链接：

   http://api.example.com:8080/Tools/proxyIP.ashx?action=GetIP&OrderNumber=abc123&qty=50

2. 右键点击表格区域 → 选择"批量导入"

3. 将API链接粘贴到弹出框中

4. 点击"确定"

5. 软件会自动请求该API，获取50个代理IP

6. 几秒钟后，表格中会显示从API获取的所有IP，状态为"等待测试"

7. 设置好验证目标后，点击"开始"即可批量测试这些IP

使用API导入的注意事项：

• API链接必须是完整的URL，以 http:// 或 https:// 开头

• 确保API链接有效，且您的订单/账号有足够的提取额度

• 如果API返回空数据，软件会提示"请求IP返回空字符"，请检查API参数或额度

• 如果API返回"无法连接到远程服务器"，请检查API地址是否正确，网络是否通畅

• 建议单次提取数量不要太大（建议 ≤ 200个），避免API超时

• 部分代理商需要先添加白名单IP才能正常提取，请确认已添加

💡 混合导入技巧

您可以同时导入多个API链接和手动IP列表，例如：

http://api1.example.com/GetIP?order=xxx&qty=50
http://api2.example.com/GetIP?order=yyy&qty=30
192.168.1.1:8080
192.168.1.2:8080,user,pwd

软件会自动识别每行内容的类型，分别处理后合并到测试列表中。

第二步：设置验证目标（核心配置）

验证目标设置是整个测试过程中最关键的配置环节。软件通过代理IP去访问您指定的"验证网址"，然后检查返回的网页内容中是否包含"验证内容"中的特征文字。如果包含，则判定该IP可用；否则判定为失败。

📋 界面控件说明

🔧 验证内容的两种填写方式

方式一：自动获取（推荐，最简单）

1. 在"验证网址"框中输入目标网址（如 https://www.baidu.com/）

2. 验证内容留空（不要填写任何内容）

3. 点击 添加 按钮

4. 软件会自动请求该网址，提取网页 HTML 中 <title> 标签的内容作为验证内容

5. 提取成功后，验证内容会自动填入，并自动添加到列表中

自动获取的原理：软件请求网址 → 获取HTML源码 → 截取 <title>...</title> 标签中的文字 → 作为验证内容。例如百度的 title 是"百度一下，你就知道"。

方式二：手动填写

1. 在"验证网址"框中输入目标网址

2. 在"验证内容"框中手动输入该网页中一定会出现的特征文字

3. 点击 添加 按钮完成添加

如果网址没有 <title> 标签（如纯API接口页面），自动获取会失败，此时必须手动填写验证内容。可填写网页中任意一段稳定的文字作为判断依据。

🎯 如何用业务目标网址进行验证测试

这是本功能最实用的场景——用您实际业务中要访问的网站来测试代理IP，确保选出的IP真正适合您的业务。

操作步骤：

1. 确定业务网址：想清楚您实际要用代理IP访问哪个网站。例如：

• 做电商采集 → 用淘宝、京东的商品页网址

• 做搜索引擎采集 → 用百度、搜狗的搜索页网址

• 做社交媒体 → 用微博、知乎等网址

• 调用某个API → 直接用API的URL地址

2. 获取验证内容：

• 用浏览器打开您的业务网址

• 查看网页标题（浏览器标签页上显示的文字），这就是 <title> 内容

• 或者查看网页源码（Ctrl+U），搜索 <title> 标签

• 也可以选择网页中任意一段稳定不变的文字作为验证内容

3. 添加验证目标：

• 在"验证网址"框输入业务网址（必须带 http:// 或 https://）

• 验证内容可留空让软件自动获取，或手动填写

• 点击 添加 按钮

4. 勾选启用：确保刚添加的验证目标前面的复选框已勾选

5. 开始测试：软件会通过每个代理IP去访问您的业务网址，验证是否可用

💡 验证内容选择技巧

📝 多验证目标的使用场景

您可以添加多个验证目标并同时勾选，软件会对每个IP依次测试所有勾选的验证目标。适用场景：

• 多业务场景：您的业务需要访问多个网站，可同时添加多个网址一起测试

• 交叉验证：一个IP能访问百度但不能访问淘宝，说明该IP被淘宝封了，可据此筛选

• 质量分级：通过的目标越多，说明IP质量越高

重要提醒：

• 验证网址必须以 http:// 或 https:// 开头，否则会被判定为无效网址

• 验证内容必须是该网址真实返回的内容，不能随意填写

• 验证内容不要太短（如单个字），容易误判；也不要太长，可能因网页内容变动而失效

• 测试前请确保至少勾选了一个验证目标，否则无法开始测试

第三步：选择测试协议类型

在"验证代理ip协议类型"区域勾选要测试的协议：

如果不确定，保持默认只勾选 HTTP 即可。

第四步：配置测试参数

第五步：开始测试

配置完成后，点击 开始 按钮启动测试。

第六步：查看与筛选结果

测试完成后，表格中每行显示一个IP的测试结果：

• 绿色行 = 测试通过 ✅

• 红色行 = 测试失败 ❌

使用表格上方的按钮筛选结果：

第七步：导出结果

在表格区域点右键 → 选择导出格式：

• 导出通用IP格式 — 标准 IP:端口 格式

• 导出万安格式 — 带账号密码的格式

三、IP时长测试

3.1 这个功能是做什么的？

测试代理IP的可用时长。有些代理IP是短效的（几分钟就失效），有些能用很久。这个功能可以帮您测出每个IP从开始使用到失效能持续多长时间。

3.2 操作步骤

操作流程

1. 导入代理IP：同连通率测试的导入方式一致

2. 设置参数

• 期望IP速度(ms)：设置响应时间阈值，超过则判定为慢

• 允许重试：勾选后，失败的IP会自动重试最多3次

3. 开始测试：点击 添加 按钮将IP加入测试队列，然后点击 开始 启动

4. 查看结果：结果表格中"备注"列显示测试状态

5. 停止测试：测试过程中可以随时点击 停止 按钮终止

3.3 结果说明

四、白名单管理

4.1 这个功能是做什么的？

代理IP服务商通常采用白名单机制：只有在白名单中的IP地址才能提取代理IP。白名单管理功能可以让您方便地管理代理商API的白名单。

4.2 前置条件

在使用本功能前，您需要获得代理商的API地址。典型格式如下：

http://服务器地址/Tools/proxyIP.ashx?action=xxx&OrderNumber=订单号&参数=值

4.3 API操作说明

4.4 操作步骤

第一步：输入API

将您的代理商API地址粘贴到顶部的输入框中。

第二步：执行白名单操作

添加白名单IP（最常用）：

1. 点击操作区域的 添加 按钮

2. 在弹出框中输入要添加的IP地址

3. 多个IP用换行分隔

4. 点击确认即可

通常需要添加的是您的本机外网IP（软件右上角会显示）

读取当前白名单：
 点击 读取 按钮，查看服务器上已有的白名单IP列表。

删除白名单：
 点击 删除 按钮，输入要移除的IP地址，确认后执行。

清空白名单：
 点击 清空 按钮可一键清除所有白名单IP。

清空白名单为不可逆操作，请谨慎使用！

查询订单详情：
 点击 详情 按钮查看订单的剩余时间、剩余额度等信息。

第三步：自动化功能

4.5 常见问题

五、去重查转（IP转换工具）

5.1 这个功能是做什么的？

提供三个实用的IP处理工具：

1. 整数与IP互转 — IP地址 ↔ 整数 相互转换

2. 去重 — 批量去除重复IP

3. 双列表对比 — 找出两个IP列表的相同/差异部分

5.2 整数与IP互转

用途：将IP地址转换为纯整数形式（便于数据库存储和计算），或将整数还原为IP地址。

操作：

1. 在左侧表格导入IP列表

2. 点击 整数与IP互转 按钮

3. 结果显示在原表格中

示例：

IP: 192.168.1.1  →  整数: 3232235777
整数: 3232235777  →  IP: 192.168.1.1

5.3 批量去重

用途：移除列表中重复的IP地址。

操作：

1. 在表格中导入IP列表（可能包含重复项）

2. 点击 去重 按钮

3. 重复的IP会被自动移除

勾选 忽略端口 选项后，仅按IP地址去重（端口号不同也视为相同IP）

5.4 双列表对比

用途：对比两个IP列表，找出它们的交集或差集。

操作：

1. 在左侧表格导入第一个IP列表

2. 在右侧表格导入第二个IP列表

3. 选择对比方式

勾选 忽略端口 可在对比时忽略端口号差异

5.5 其他按钮说明

六、常见问题速查表

七、使用小技巧

🎯 批量导入API链接：连通率测试中，右键表格 → 批量导入 → 粘贴API地址即可自动导入服务器返回的所有IP

⌨️ 快捷键：在表格中直接 Ctrl+V 可以快速粘贴IP列表

💾 保存常用API：白名单管理中的API地址会自动记录，下次使用直接选择即可

🔍 日志排查：勾选"日志"选项可以看到详细的测试过程，便于排查问题

🎉 感谢使用代理IP测试工具

如有更多问题，欢迎加入官方QQ交流群：61270477

联系邮箱：shen_zhi_ping@126.com

© 2023 代理IP测试工具 版权所有