| name | itdog |
| description | itdog.cn 网络测速工具 API 客户端。支持 Batch Ping 批量测速和 HTTP 网站测速。
使用场景: (1) 从全国/海外节点 Ping 测试 IP/域名延迟 (2) HTTP 网站响应测速
(3) Cloudflare CDN 节点优选 (4) 网络质量诊断
触发词: itdog, 网络测速, ping测试, 批量ping, http测速, cloudflare优选, 延迟测试
|
itdog.cn 网络测速工具
纯 Python 实现，无需浏览器。
快速开始
from scripts.itdog_client import batch_ping, http_test
batch_ping("1.0.0.1", "1274,1226", lambda r: print(r))
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',
'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 命令包装或直接运行脚本文件：
timeout 30 python3 scripts/itdog_client.py
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', '')
})
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']})")
