插件应用市场
trace
让路由追踪更智能、更直观
# TraceMap Live
**Real-time Network Path Analyzer** – 实时网络路径分析器，集成设备数据库匹配与地理位置查询，让 traceroute 结果一目了然。
---
## ✨ 功能特性
- **实时追踪**
直接输入目标 IP 或域名，调用系统 `tracert` (Windows) 或 `traceroute` (macOS/Linux) 逐跳显示路径，支持中途停止。
- **智能解析**
自动解析标准 traceroute 输出（Windows / Linux 格式），粘贴已有结果即可分析。
- **设备数据库匹配**
加载 JSON 或 CSV 格式的设备清单，自动根据 IP 匹配设备名称、管理 IP 等字段，在每一跳上显示设备信息。
- **地理信息查询 (IPInfo)**
集成 ipinfo.io，可查看每一跳的地理位置、运营商和 ASN 信息（需可选 token，免费额度足够日常使用）。
- **丰富的结果展示**
- 跳数、匹配设备数、超时次数、平均 RTT 实时统计
- 每一跳显示延迟等级（快速/正常/慢速/超时），颜色区分
- 点击 IP 一键复制到剪贴板
- **数据导出**
将分析结果导出为 CSV，包含跳数、IP、延迟、地理位置、设备字段等，方便存档或进一步处理。
- **多语言 / 暗色主题**
支持中英文界面切换，内置暗色和亮色主题。
- **快捷键**
`Ctrl + Enter` 快速开始分析（粘贴模式）。
---
## 🚀 快速上手
### 1. 实时追踪
- 在 **Target** 输入框中输入目标 IP 或域名（如 `8.8.8.8` 或 `google.com`）。
- 调整 **Max Hops**（最大跳数）和 **Timeout**（超时秒数）。
- 点击 **▶ Trace** 按钮，每一跳将实时显示在下方。
- 追踪过程中可随时点击 **■ Stop** 停止。
### 2. 粘贴分析
- 将其他工具生成的 traceroute 输出粘贴到文本框中。
- 点击 **Analyze Path**（或 `Ctrl+Enter`），立即解析并展示路径。
### 3. 加载设备数据库
- 点击 **Load** 按钮展开拖拽区。
- 拖入或选择 JSON / CSV 文件（第一行为列名，至少包含 `management_ip` 或 `ip` 字段）。
- 成功后会在每一跳自动显示匹配的设备字段。
### 4. 自定义显示字段
- 点击 **Edit** 按钮编辑 **Display Fields**（逗号分隔），保存后匹配的设备标签将使用这些字段。
### 5. 启用地理信息
- 输入 ipinfo.io 的 access token（免费申请：https://ipinfo.io/signup）。
- 保持 **Enable Geo/ASN lookup** 开启。
- 追踪时每一跳会显示国家、城市、运营商等信息。
### 6. 导出结果
- 完成分析后，点击 **Export CSV** 下载完整报告。
---
## 🧩 配置文件格式
### JSON 示例
```json
[
{
"management_ip": "10.0.0.1",
"hostname": "core-router-01",
"other_ip": "172.16.1.1,192.168.1.1"
}
]
```
### CSV 示例
```csv
management_ip,hostname,location
10.0.0.1,core-router-01,机房A
172.16.1.1,edge-switch,楼层B
```
> 插件会自动识别 `management_ip`、`ip`、`ip_address`、`addr` 等列名，也支持 `other_ip` 中的多个逗号分隔 IP。
---
## ❓ 常见问题
**Q: 提示找不到 tracert/traceroute 命令？**
A: Windows 系统自带 tracert，Linux 请安装 `traceroute`（如 `apt install traceroute`）。
**Q: 为什么 CPU 占用很高？**
A: 最新版本已优化实时渲染性能。若仍高，请检查系统 traceroute 本身是否有异常，或尝试降低并发数（修改 preload.js 中 `MAX_CONCURRENT`）。
**Q: IPInfo 查询失败？**
A: 检查 Token 是否有效，或网络是否能访问 `ipinfo.io`。未启用 Token 时每天有少量免费查询次数。
**Q: 粘贴的 traceroute 无法解析？**
A: 请确保格式标准，每行以跳数开头，包含 IP 和延迟（ms）。支持 Windows 和 Linux 常见格式。
**Q: 数据存储在哪里？**
A: 设备和配置保存在浏览器 IndexedDB 中，仅限本地，卸载插件会清除。
---
**TraceMap Live** – 让路由追踪更智能、更直观。
**Real-time Network Path Analyzer** – 实时网络路径分析器，集成设备数据库匹配与地理位置查询，让 traceroute 结果一目了然。
---
## ✨ 功能特性
- **实时追踪**
直接输入目标 IP 或域名，调用系统 `tracert` (Windows) 或 `traceroute` (macOS/Linux) 逐跳显示路径，支持中途停止。
- **智能解析**
自动解析标准 traceroute 输出（Windows / Linux 格式），粘贴已有结果即可分析。
- **设备数据库匹配**
加载 JSON 或 CSV 格式的设备清单，自动根据 IP 匹配设备名称、管理 IP 等字段，在每一跳上显示设备信息。
- **地理信息查询 (IPInfo)**
集成 ipinfo.io，可查看每一跳的地理位置、运营商和 ASN 信息（需可选 token，免费额度足够日常使用）。
- **丰富的结果展示**
- 跳数、匹配设备数、超时次数、平均 RTT 实时统计
- 每一跳显示延迟等级（快速/正常/慢速/超时），颜色区分
- 点击 IP 一键复制到剪贴板
- **数据导出**
将分析结果导出为 CSV，包含跳数、IP、延迟、地理位置、设备字段等，方便存档或进一步处理。
- **多语言 / 暗色主题**
支持中英文界面切换，内置暗色和亮色主题。
- **快捷键**
`Ctrl + Enter` 快速开始分析（粘贴模式）。
---
## 🚀 快速上手
### 1. 实时追踪
- 在 **Target** 输入框中输入目标 IP 或域名（如 `8.8.8.8` 或 `google.com`）。
- 调整 **Max Hops**（最大跳数）和 **Timeout**（超时秒数）。
- 点击 **▶ Trace** 按钮，每一跳将实时显示在下方。
- 追踪过程中可随时点击 **■ Stop** 停止。
### 2. 粘贴分析
- 将其他工具生成的 traceroute 输出粘贴到文本框中。
- 点击 **Analyze Path**（或 `Ctrl+Enter`），立即解析并展示路径。
### 3. 加载设备数据库
- 点击 **Load** 按钮展开拖拽区。
- 拖入或选择 JSON / CSV 文件（第一行为列名，至少包含 `management_ip` 或 `ip` 字段）。
- 成功后会在每一跳自动显示匹配的设备字段。
### 4. 自定义显示字段
- 点击 **Edit** 按钮编辑 **Display Fields**（逗号分隔），保存后匹配的设备标签将使用这些字段。
### 5. 启用地理信息
- 输入 ipinfo.io 的 access token（免费申请：https://ipinfo.io/signup）。
- 保持 **Enable Geo/ASN lookup** 开启。
- 追踪时每一跳会显示国家、城市、运营商等信息。
### 6. 导出结果
- 完成分析后，点击 **Export CSV** 下载完整报告。
---
## 🧩 配置文件格式
### JSON 示例
```json
[
{
"management_ip": "10.0.0.1",
"hostname": "core-router-01",
"other_ip": "172.16.1.1,192.168.1.1"
}
]
```
### CSV 示例
```csv
management_ip,hostname,location
10.0.0.1,core-router-01,机房A
172.16.1.1,edge-switch,楼层B
```
> 插件会自动识别 `management_ip`、`ip`、`ip_address`、`addr` 等列名，也支持 `other_ip` 中的多个逗号分隔 IP。
---
## ❓ 常见问题
**Q: 提示找不到 tracert/traceroute 命令？**
A: Windows 系统自带 tracert，Linux 请安装 `traceroute`（如 `apt install traceroute`）。
**Q: 为什么 CPU 占用很高？**
A: 最新版本已优化实时渲染性能。若仍高，请检查系统 traceroute 本身是否有异常，或尝试降低并发数（修改 preload.js 中 `MAX_CONCURRENT`）。
**Q: IPInfo 查询失败？**
A: 检查 Token 是否有效，或网络是否能访问 `ipinfo.io`。未启用 Token 时每天有少量免费查询次数。
**Q: 粘贴的 traceroute 无法解析？**
A: 请确保格式标准，每行以跳数开头，包含 IP 和延迟（ms）。支持 Windows 和 Linux 常见格式。
**Q: 数据存储在哪里？**
A: 设备和配置保存在浏览器 IndexedDB 中，仅限本地，卸载插件会清除。
---
**TraceMap Live** – 让路由追踪更智能、更直观。