# 3T测速

> 多节点网络诊断工具：从中国大陆多地探测节点发起 Ping / Tcping / HTTP / Traceroute / DNS 测试，返回各节点的延迟、丢包与解析结果。
> 无需登录、无验证码。所有结果以高熵任务 UID 寻址，可直接通过 URL 引用，便于在报告与工单中复用同一份测试数据。

## 工具

- [Ping 检测](https://www.3t.com/tool/ping.html): ICMP 延迟与丢包测试，API `POST https://www.3t.com/api/tool/ping`
- [Tcping 检测](https://www.3t.com/tool/tcping.html): TCP 端口连通性与延迟测试，API `POST https://www.3t.com/api/tool/tcping`
- [HTTP(S) 测速](https://www.3t.com/tool/http.html): 状态码、响应时间与下载测速，API `POST https://www.3t.com/api/tool/http`
- [路由追踪](https://www.3t.com/tool/traceroute.html): 逐跳路径探测，API `POST https://www.3t.com/api/tool/traceroute`
- [DNS 查询](https://www.3t.com/tool/dns.html): A/AAAA/CNAME/MX/TXT/NS/PTR/SRV 记录查询，API `POST https://www.3t.com/api/tool/dns`
- [ECH 检测](https://www.3t.com/tool/ech.html): 批量查询域名的 HTTPS RR 与其中的 ech 参数，判断 ECHConfigList 是否发布、结构是否合法，API `POST https://www.3t.com/api/tool/ech`
- [本机网络检测](https://www.3t.com/tool/local.html): 基于访问者出口 IP 的归属地与本机诊断

## 参数表

所有工具 API 均为 `POST`，`application/x-www-form-urlencoded`。

公共参数（五个端点都支持）：

| 参数 | 必填 | 默认 | 说明 |
|------|------|------|------|
| `node_groups[]` | 否 | 全部线路 | 可选多个，如 `telecom`/`unicom`/`mobile`/`domestic_other`/`overseas`；取值必须来自线路枚举，传错值该线路节点直接为空 |
| `nodes[]` | 否 | 组内全部 | 指定具体节点 ID（整数），优先于 `node_groups[]` |
| `timeout` | 否 | 10 | 单节点超时，单位秒 |
| `dns_server` | 否 | 运营商默认 | 自定义 DNS 服务器 IP（用于目标域名解析） |

各端点专有参数：

| 端点 | 目标参数 | 其他参数 |
|------|----------|----------|
| `POST /api/tool/ping` | `target`（必填） | `protocol` = `ipv4`/`ipv6`/`auto`（默认 ipv4）、`port` |
| `POST /api/tool/tcping` | `target`（必填） | `port`（必填）、`protocol` = `ipv4`/`ipv6` |
| `POST /api/tool/http` | `target`（必填） | `protocol`、`port` |
| `POST /api/tool/traceroute` | `target`（必填） | `max_hops`（默认依节点而定） |
| `POST /api/tool/dns` | `target`（必填，旧名 `domain` 仍兼容） | `type` = `A`/`AAAA`/`CNAME`/`MX`/`TXT`/`NS`/`PTR`/`SRV`（默认 A） |
| `POST /api/tool/ech` | `targets`（必填，可换行分隔多个域名，单次最多 20 个；旧名 `target`/`domain` 兼容） | 每个域名由 2 个节点随机参与，响应为批量结构 `{"succeeded":[...],"failed":[...]}` |

批量端点：`POST /api/tool/batch-ping`、`batch-tcping`、`batch-http`、`batch-dns`。
目标改用 `targets[]`（可重复，推荐）或 `targets`（兼容写法，换行分隔）。

成功响应：`{"task_uid":"...","task_id":123,"target":"...","nodes":N,"timing_ms":N}`。
失败响应：`{"error":"..."}`，缺参数为 400，超频为 429。

## 结果引用（推荐 AI 使用）

创建任务后响应中的 `task_uid` 是结果的唯一标识，可直接拼成 URL 引用，**不需要鉴权、不需要浏览器**：

- 结构化 JSON（含 schema_version 契约版本）：`https://www.3t.com/result/{task_uid}?format=json`
- 纯文本（便于直接读入上下文，token 开销最小）：`https://www.3t.com/result/{task_uid}?format=txt`
- CSV（表格工具/Excel）：`https://www.3t.com/result/{task_uid}?format=csv`
- 人类可读页面：`https://www.3t.com/result/{task_uid}`

结果 URL 本身即访问凭证，`task_uid` 是随机值：请勿把不属于自己的 `task_uid` 结果链接公开转贴；这些 URL 全部带 `X-Robots-Tag: noindex`，不会被搜索引擎收录。

## 异步轮询

工具 API 为异步模型，创建后需等待节点回传：

1. `POST https://www.3t.com/api/tool/ping`，表单参数 `target=example.com`，返回 `task_uid`
2. 轮询 `GET https://www.3t.com/api/task/status?task_uid={uid}` 直到 `status` 为完成态
3. `GET https://www.3t.com/result/{uid}?format=json` 取回全部节点结果

页面侧另有 WebSocket 通道 `https://www.3t.com/ws/task` 用于实时增量推送；AI 集成请优先用上面的轮询方式。

## 批量对比

- [批量 Ping](https://www.3t.com/tool/batch-ping.html) / [批量 Tcping](https://www.3t.com/tool/batch-tcping.html) / [批量 HTTP](https://www.3t.com/tool/batch-http.html) / [批量 DNS](https://www.3t.com/tool/batch-dns.html)
- 支持多目标 × 多节点矩阵式对比，参数 `targets[]`（或换行分隔的 `targets`）

## 限制

- 每个 IP 每分钟最多 300 次请求，超出返回 429
- 归属地查询接口（`/api/tool/ip/geo`）每个 IP 每分钟 60 次
- 探测节点数量与线路以页面提交时可选为准，部分线路（尤其移动）对 ICMP 有速率限制
- 结果链接是访问凭证，但导出内容为裸数据，不保证节点侧长期保留历史任务

## MCP 服务（推荐 AI 客户端使用）

如果你支持 MCP（Model Context Protocol），可直接接入 `https://www.3t.com/mcp`，
无需自己实现「创建任务 → 轮询 → 取结果」三步，调用一次工具即返回汇总结果：

- 传输：`POST https://www.3t.com/mcp`，JSON-RPC 2.0，单次请求单次响应（无 SSE）
- 方法：`initialize` / `tools/list` / `tools/call`
- 工具：`ping` / `tcping` / `http` / `traceroute` / `dns`，参数与本文档参数表一致
- 返回值同时含 `content`（文本摘要，省 token）与 `structuredContent`（等价于 `?format=json`）
- 不支持 MCP 时，请按上面的 HTTP 三步流程自行轮询

## 其他

- [帮助中心](https://www.3t.com/help.html)
- [站点地图](https://www.3t.com/sitemap.xml)