GlobalTrace

在网络诊断领域，传统的 traceroute 工具往往只能提供冰冷的 IP 列表和延迟数据，缺乏直观的地理位置展示和详细的网络归属信息。GlobalTrace 是一个开源项目，它巧妙结合了 Globalping 的全球分布式探测节点和 NextTrace 强大的骨干网 IP 数据库，为用户提供了一款兼具广度、深度与美观度的网络路由追踪可视化工具。

核心架构：去中心化与隐私优先

GlobalTrace 的技术架构设计体现了现代 Web 应用的轻量化与隐私保护理念。它由前端 React SPA 和后端 Cloudflare Worker API 组成，整体运行在 Cloudflare 的边缘网络上。

• 测量源（Globalping）：利用 Globalping 遍布全球的探针发起 mtr（My Traceroute）测量。用户无需自行部署节点，即可从世界各地发起追踪，观察不同区域到目标主机的网络路径差异。
• 数据增强（NextTrace）：Worker 在获取 Globalping 的原始 MTR 结果后，会调用 NextTrace API v4 的批量 GeoIP/ASN/Whois 接口，为每一个跳点（Hop）补充详细的地理位置、运营商归属及自治系统信息。
• 隐私边界：项目严格遵循“最小化服务端存储”原则。
  • 无持久化存储：不使用 KV、D1、R2 或 Durable Objects 存储用户报告。
  • Token 安全：用户提供的 NextTrace API Token 仅保存在浏览器会话或本地存储（localStorage）中，绝不发送给 Globalping 或 GlobalTrace Worker。Worker 端仅使用环境变量存储服务端的 NXTRACE_API_V4_TOKEN。
  • 缓存机制：已完成的路由追踪结果通过 Worker Cache API 缓存 7 天，分享链接依赖 measurement ID 和缓存结果，而非数据库记录。

技术栈亮点

• 前端：React + Vite + TypeScript，配合 MapLibre 实现高性能的地图渲染。UI 组件库采用 Radix UI 和 lucide-react，并引入了 liquid-glass-react 打造现代化的玻璃拟态视觉效果。
• 后端：Hono 框架运行在 Cloudflare Workers 上，处理 /api/* 请求，包括配置获取、探针列表查询、结果 enrichment 及缓存管理。其他路径则由 Cloudflare Workers Static Assets 直接返回构建好的静态资源，实现了极致的响应速度。

核心功能与工作流

1. 发起诊断：用户在浏览器界面输入目标域名或 IP，选择起始探测点（或自动选择）。浏览器直接调用 Globalping API 创建 measurement，Worker 不代理此步骤，确保测量的真实性。
2. 数据增强：Worker 监听 measurement 状态，完成后拉取 MTR 结果，提取唯一公网 Hop IP，批量调用 NextTrace API 进行地理位置和 ASN enrichments。
3. 可视化展示：前端接收 enriched trace 数据，在地图上绘制路由路径，并以卡片形式展示每一跳的详细信息（IP、城市、运营商、AS 号、延迟等）。
4. 分享与缓存：生成的分享链接包含 measurement ID。当他人访问时，Worker 首先检查缓存，若命中则直接返回 JSON 数据，否则触发后台 enrichment 流程。

部署与开发

GlobalTrace 提供了便捷的本地开发和生产部署流程：

• 本地运行：

  npm install
  npm run dev # 构建 Vite assets 并启动 wrangler dev
  

• 生产部署：推荐通过 Cloudflare Builds 自动化部署。GitHub Actions 仅负责验证，实际部署由 Cloudflare 执行。敏感配置（如 NXTRACE_API_V4_TOKEN）需通过 wrangler secret put 注入，严禁写入代码库。

为什么选择 GlobalTrace？

• 全球视角：借助 Globalping，你可以轻松对比从纽约、东京、法兰克福等地访问同一服务器的路径差异，精准定位跨国网络瓶颈。
• 信息丰富：NextTrace 的加持让每一跳 IP 都“有迹可循”，不再是枯燥的数字，而是具体的城市和运营商。
• 轻量透明：纯开源代码，无黑盒操作，无用户数据收集，适合对隐私和安全有高要求的网络工程师、开发者及运维人员使用。

GlobalTrace 不仅是一个工具，更是一次对网络可观测性体验的重塑。它将复杂的路由追踪转化为直观、易懂且富有美感的视觉叙事，让每一次网络诊断都成为一次清晰的探索之旅。