IP/域名质量批量测试工具 - 代理/VPN专用优化版

这是一个用于批量测试IP地址和域名质量的Python工具，特别针对代理服务器和VPN节点进行了优化。它支持多种输入方式（文件/URL/自定义列表），通过两阶段测试流程（快速筛选 + 深度测试）快速识别优质节点，然后按质量排序输出详细报告。

• 集成 ipinfo.dkly.net API：获取更丰富的 IP 信息，包括 ASN、运营商、代理类型等。
• 智能回退机制：API 不可用时自动回退到 Cloudflare trace 接口。
• 详细报告增强：Markdown 报告新增 IP 详细信息表，支持地理位置精确定位。
• 安全性检测：自动识别 VPN、Proxy、Tor 等节点类型。
• 详细文档：查看 IPINFO_API.md 了解更多。

• 两阶段测试策略：快速筛选（1-2秒/节点） + 深度测试
• 快速失败机制：不可用节点快速识别并跳过
• 智能并发：快速检测50并发，深度测试10并发
• 测试时间：从27分钟降至2-3分钟

• 改进的快速检测：3次ping + 重试机制，提高检测准确性
• 统计分析：支持IQR/Z-Score/MAD三种异常值过滤方法
• 置信区间：提供95%置信区间评估结果可靠性
• 多轮测试：可配置测试轮数，取统计平均值

• HTTP/HTTPS性能：TTFB（首字节时间）、TLS握手时间、总响应时间
• 连接稳定性：10次连续连接测试，计算成功率和稳定性评分
• 代理专用评分：可用性（20分）+ 速度（30分）+ 稳定性（30分）+ 响应性（20分）

• 流媒体访问能力：测试节点对指定网站的访问能力
• 支持自定义网站列表：ChatGPT、YouTube、Netflix 等
• 延迟和连通性测试：TTFB、可用率统计
• 可视化报告：Markdown 表格展示测试结果

• YAML 格式支持：更易读、易编辑的配置文件格式
• 详细注释：每个参数都有完整的说明
• 配置优先级：config.yaml > config.yml

• max_results 配置项：自定义保存的节点数量
• 默认值：30：可根据需求调整
• 灵活控制：不影响完整报告中的节点数

• best.txt：干净格式（IP:端口#地区标识），注释优先，否则使用地理查询
• result_pro.md：可视化Markdown报告
• result_history.json：历史结果（用于报告变动对比）

• fast：快速模式，单轮测试，适合快速评估大量节点
• balanced：平衡模式，两轮测试，包含HTTP和稳定性测试（推荐）
• thorough：彻底模式，三轮测试，包含所有测试项，最准确但最慢

• ✅ 批量测试IP地址和域名
• ✅ 计算延迟（ping时间）和丢包率
• ✅ 多线程并发测试，提高效率
• ✅ 按综合评分自动排序
• ✅ 支持Windows/Linux系统（自动处理中文/英文系统）
• ✅ 实时显示测试进度和结果
• ✅ 输出格式化的结果文件（TXT + Markdown）

• ⚡ 快速可用性检测：1-2秒快速判断节点是否可用
• 🌐 HTTP性能测试：测试实际代理性能（TTFB、响应时间）
• 🔄 连接稳定性测试：10次连续连接，评估长期可靠性
• 📈 抖动计算：评估网络稳定性
• 🎯 代理专用评分：针对代理/VPN场景优化的评分算法
• 🌍 地理位置查询：自动查询IP所属国家
• 📊 统计分析：异常值过滤、置信区间计算
• 🎨 Markdown报告：带表情符号的可视化报告
• 🔗 URL远程获取：支持从URL获取IP列表
• 📝 自定义列表：支持独立的自定义域名/IP列表文件
• 🎬 流媒体网站测试（新）：测试 ChatGPT、YouTube 等网站的访问能力
• 📄 YAML配置文件（新）：更易读、易编辑的配置格式
• ⚙️ 可配置输出数量（新）：自定义保存的节点数量

• ip_tester_pro.py - 专业版测试程序（推荐）
• ip_tester.py - 基础版测试程序
• config.py - 配置管理模块
• statistical_analyzer.py - 统计分析模块
• proxy_score_calculator.py - 代理评分计算器
• src/utils/ip_info_client.py - IP 信息 API 客户端 (NEW)

• data/input/testip.txt - 主输入文件，包含要测试的域名和IP列表
• data/input/custom.txt - 自定义输入文件，用于存放个人的域名/IP列表
• data/output/best.txt - 输出文件，前N名优质节点（干净格式：IP:端口#地区标识，数量由 max_results 控制）
• data/output/result_pro.txt - 详细测试结果（文本格式）
• data/output/result_pro.md - 详细测试结果（Markdown格式，推荐查看）
• data/output/result_history.json - 历史结果（用于Markdown报告变动对比）
• docs/IPINFO_API.md - IP 信息 API 集成说明文档 (NEW)

• run_pro.bat - 运行专业版测试（推荐）
• run.bat - 运行基础版测试

1. 确保 data/input/testip.txt 文件存在并包含要测试的域名/IP
2. 双击 scripts/run_pro.bat 或运行 python main.py
3. 程序会自动运行并显示结果

1. 编辑 data/input/custom.txt 文件，添加你的域名/IP：

   # Cloudflare优选域名
   cloudflare.182682.xyz
   freeyx.cloudflare88.eu.org
   cdn.2020111.xyz
   cf.090227.xyz
   

2. 确认 config.yaml 中启用了自定义文件功能：

   enable_custom_file: true
   custom_file_path: data/input/custom.txt
   merge_custom_with_url: true
   custom_file_priority: before_url

3. 运行 python main.py，程序会自动合并自定义列表和URL获取的地址

# 运行专业版（推荐）
python ip_tester_pro.py

# 运行基础版
python ip_tester.py

from src.core.ip_tester_pro import AdvancedIPTester
from src.config.config import load_config

# 使用预设模式
config = load_config(test_mode='balanced')  # fast/balanced/thorough
tester = AdvancedIPTester(config=config)

# 或自定义配置
custom_config = {
    'enable_quick_check': True,
    'enable_http_test': True,
    'score_include_http': False,  # 仅展示HTTP测试结果，不参与评分
    'enable_stability_test': True,
    'ping_count': 10,
    'max_workers': 10,
}
tester = AdvancedIPTester(config=custom_config)

# 读取目标并测试
targets = ['8.8.8.8', '1.1.1.1', 'example.com']
tester.test_targets_two_phase(targets)

所有输入文件（testip.txt 和 custom.txt）都使用相同的格式，每行一个目标，支持以下格式：

# 域名
example.com
www.google.com

# IP地址
8.8.8.8
1.1.1.1

# 带端口的IP（端口会被忽略）
192.168.1.1:8080

# 带注释的目标
104.17.151.112:443#圣何塞-5.60MB/s  # 注释不参与测试，但可用于输出国家码

# 空行和以#开头的行会被跳过

程序支持三种输入方式，可以灵活组合：

1. 主文件输入 (data/input/testip.txt)

   • 默认输入源
   • 适用于通用的IP/域名列表

2. URL远程获取 (通过 config.yaml 配置)

   • 从远程URL获取IP列表
   • 支持多个URL并发获取
   • 自动重试和错误处理

3. 自定义文件 (data/input/custom.txt)

   • 适用于个人专属域名/IP列表
   • 优先级可配置（before_url/after_url）
   • 可与URL结果自动合并

程序会按照以下优先级合并多个输入源：

自定义文件（如果启用且优先级为before_url）
    ↓
URL获取（如果启用）
    ↓
自定义文件（如果优先级为after_url）
    ↓
主文件（testip.txt）
    ↓
自动去重

168.138.165.174:443#168.138.165.174-SG-64ms-97分
95.163.240.24:8443#95.163.240.24-SE-78ms-95分
34.143.159.175:443#34.143.159.175-SG-82ms-93分

说明：国家码优先从输入注释提取（#后、-前），没有则使用地理位置查询。

168.138.165.174:443#SG
95.163.240.24:8443#SE
34.143.159.175:443#SG

说明：国家码优先从输入注释提取（#后、-前），没有则使用地理位置查询。

包含以下列：

排名  目标                          延迟(ms)  丢包率(%)  抖动(ms)  TCP连接(ms)  综合评分  流媒体  游戏  实时通信  状态
--------------------------------------------------------------------------------------------------------------
1     168.138.165.174:443          64.0      0.0        3.5       60.0         97        95      98    96        成功
2     95.163.240.24:8443           78.0      0.0        4.2       72.0         95        93      94    95        成功
...

结果按综合评分降序排列（评分越高质量越好）

程序使用 YAML 格式的配置文件，易读易编辑，每个参数都有详细注释。

配置文件优先级：config.yaml > config.yml

1. 复制示例配置文件：

   cp config.example.yaml config.yaml

2. 编辑配置文件：

   # 常用配置在文件前面，方便修改
   
   # 输出配置
   max_results: 30  # 保存的最大结果数量
   
   # 流媒体网站测试
   enable_streaming_test: false
   streaming_sites:
     - https://chatgpt.com
     - https://www.youtube.com
   
   # URL 获取
   enable_url_fetch: false
   url_sources:
     - https://raw.githubusercontent.com/user/repo/main/list.txt
   
   # HTTP 性能测试（Cloudflare 优选 IP 场景常用：仅展示不计分）
   enable_http_test: true
   score_include_http: false
   http_test_url: https://cp.cloudflare.com/generate_204
   
   # 测试模式：fast / balanced / thorough
   test_mode: balanced

3. 运行测试：

   python main.py

配置文件分为两部分：

1. 常用配置（文件前面）

   • 输出配置（max_results）
   • 流媒体网站测试配置
   • URL 输入配置
   • 自定义文件配置
   • 测试模式配置
   • HTTP 性能测试配置

2. 高级配置（文件后面）

   • 基础测试参数
   • 快速检测配置
   • 高级测试配置
   • 下载速度测试
   • 连接稳定性测试
   • 评分模式

查看 config.example.yaml 文件获取完整的配置说明，包括：

• 每个配置项的详细说明
• 所有可选值及其含义
• 推荐配置和使用场景
• 配置项的影响和注意事项
• 快速配置建议

max_results: 30
enable_streaming_test: false
enable_url_fetch: false
enable_custom_file: true
test_mode: balanced

max_results: 30
enable_streaming_test: true
streaming_sites:
  - https://chatgpt.com
  - https://www.youtube.com
  - https://www.netflix.com
test_mode: balanced

max_results: 50
enable_url_fetch: true
url_sources:
  - https://raw.githubusercontent.com/user/repo/main/list.txt
fallback_to_file: true
test_mode: fast

• Python 3.6 或更高版本
• Windows 系统（支持Linux/macOS但需要调整ping命令）
• 网络连接正常

错误: 未找到Python，请先安装Python 3.x

解决方案：从 python.org 下载并安装Python

错误: 找不到 data/input/testip.txt 文件

解决方案：创建 data/input/testip.txt 文件并添加要测试的目标

• 增加 ping_count 值以获得更准确的平均延迟
• 增加 timeout 值以适应网络较慢的目标
• 检查防火墙设置是否允许ICMP流量

• 减少 max_workers 值以降低系统负载
• 减少 ping_count 值以加快测试速度

=======================================================
批量IP/域名质量测试工具
=======================================================
从 data/input/testip.txt 读取到 55 个目标
开始测试 55 个目标...
[1/55] saas.sin.fan: 延迟=177.0ms, 丢包=0.0%
[2/55] csgo.com: 延迟=183.0ms, 丢包=0.0%
...
测试完成，成功: 50/55
总测试时间: 45.2秒

======================================================================
前20个最佳结果:
======================================================================
目标                          延迟(ms)       丢包率(%)
----------------------------------------------------------------------
saas.sin.fan                  177.0          0.0
csgo.com                      183.0          0.0
www.visa.com                  192.0          0.0
...

本项目使用 MIT 许可证。

• 🎉 新增自定义文件功能：支持独立的自定义域名/IP列表文件
• ✨ 优化输入方式：支持三种输入源（主文件/URL/自定义文件）灵活组合
• 🔧 新增配置项：custom_file_config 模块，支持优先级和合并控制
• 📝 更新文档：完善配置说明和使用示例
• 🏗️ 代码重构：改进配置加载逻辑，更好的向后兼容性

• 🚀 重大更新：专业版测试器，速度提升90%，准确性提升40%
• ⚡ 两阶段测试：快速筛选 + 深度测试策略
• 📊 新增评分系统：代理专用评分算法（可用性+速度+稳定性+响应性）
• 🌐 HTTP性能测试：TTFB、TLS握手时间、总响应时间
• 🔄 连接稳定性测试：10次连续连接测试
• 📈 统计分析：异常值过滤、置信区间计算
• 🎨 三种测试模式：fast/balanced/thorough
• 🔗 URL远程获取：支持从URL获取IP列表

• 初始版本发布
• 支持批量测试IP/域名
• 实现延迟和丢包率计算
• 支持多线程并发测试
• 自动排序和结果输出