ramses1984/itdog

itdog.cn 网络测速工具

纯 Python 实现，无需浏览器。

快速开始

from scripts.itdog_client import batch_ping, http_test

# Batch Ping
batch_ping("1.0.0.1", "1274,1226", lambda r: print(r))

# HTTP 测速
http_test("https://www.baidu.com", lambda r: print(r))

依赖

pip install requests websockets

API

batch_ping(host, node_id, callback, ...)

| 参数 | 类型 | 说明 | |------|------|------| | host | str/list | IP/域名，支持 CIDR | | node_id | str | 节点 ID，逗号分隔 | | callback | callable | 回调函数 | | cidr_filter | bool | 过滤网络/广播地址 (默认 True) | | gateway | str | "last"/"first" | | timeout | int | 超时秒数 (默认 10) |

回调数据:

{'ip': '1.0.0.1', 'result': '171', 'node_id': '1274', 'address': 'cloudflare.com'}

http_test(url, callback, ...)

| 参数 | 类型 | 说明 | |------|------|------| | url | str | 测试 URL | | callback | callable | 回调函数 | | check_mode | str | "fast"/"detail" | | method | str | HTTP 方法 |

回调数据:

{
    'name': '北京电信',
    'ip': '220.181.111.1',
    'all_time': '0.050',      # 总耗时(秒)
    'dns_time': '0.005',      # DNS解析时间
    'connect_time': '0.005',  # 连接时间
    'download_time': '0.023', # 下载时间
    'http_code': 200,
    'head': 'HTTP/1.1 200 OK...',
    'address': '中国/北京/电信'
}

常用节点

• 三网北上广深: 1310,1273,1250,1227,1254,1249,1169,1278,1290
• 北京三网: 1310,1273,1250 (电信/联通/移动)
• 海外: 1315,1316,1213,1219,1317 ⚠️ 海外节点可能临时不可用
• Cloudflare 优选: 1315,1316,1213,1150,1192

完整节点列表见 references/nodes.md

⚠️ 注意: 节点可用性会变化，如遇"节点ID不存在"错误，请使用国内节点或检查 itdog.cn 网站获取最新节点列表。

技术细节

见 references/api.md

已知问题

asyncio 环境兼容性

在某些运行环境中（如已有事件循环的上下文），直接调用 batch_ping() 或 http_test() 可能导致超时或阻塞。

推荐方案: 使用 timeout 命令包装或直接运行脚本文件：

# 方式1: 直接运行内置示例
timeout 30 python3 scripts/itdog_client.py

# 方式2: 命令行调用
timeout 25 python3 -c "
from scripts.itdog_client import batch_ping
batch_ping('1.1.1.1', '1310,1273,1250', lambda r: print(r), timeout=15)
"

示例: Cloudflare 优选

from scripts.itdog_client import ItdogClient

client = ItdogClient()
results = []

def collect(r):
    if r.get('result') and r['result'].isdigit():
        results.append({
            'ip': r['ip'],
            'latency': int(r['result']),
            'location': r.get('address', '')
        })

# 测试 Cloudflare IP
client.batch_ping(
    ["104.16.0.1", "104.17.0.1", "172.67.0.1"],
    "1315,1316,1213",  # 香港、新加坡、日本
    collect
)

# 按延迟排序
for r in sorted(results, key=lambda x: x['latency'])[:5]:
    print(f"{r['ip']}: {r['latency']}ms ({r['location']})")