网络诊断 · NextTrace

NextTrace 路由追踪教程:探测与结果解读

某个网站只在一条线路上超时,可以用 NextTrace 看逐跳探测的回复。它提供路线和往返时间线索,适合与实际请求放在一起比较,而不是代替下载测速。

官方下载 ↗官方资料开始路由追踪
WindowsmacOSLinux

用路由追踪观察连接路径

连接频繁超时或两条网络表现不同,可以用 NextTrace 比较逐跳回复。输出的地址、RTT 与 ASN 有助于找路线线索,再与实际请求一起判断。

它适合回答“探测走了哪些回复路径”“异常从哪里开始出现”。它不是下载测速,也不会自动判断代理服务质量。域名解析问题先用 doggo;要确认具体应用握手,则可以继续用 Wireshark。

下载与命令检查

进入 NextTrace 官方发行页,选择与你的系统和处理器匹配的可执行文件。Linux 与 macOS 是不同系统;amd64 与 arm64 也不能互换。v1.7.4 的 macOS 发布包要求 macOS 13.0 及以上,下载前先核对系统版本。普通用户先选稳定发行,开发分支的说明可能包含尚未发布参数。

  1. macOS 已有 Homebrew 时可以执行 brew install nexttrace;软件包版本可能晚于官方发行。
  2. 直接下载 Linux/macOS 文件时,按发行说明保存为 nexttrace,在所在目录执行 chmod +x ./nexttrace。
  3. Windows 下载匹配架构的 exe,在 PowerShell 中用 .\nexttrace.exe --help 查看用法。

下文假设 nexttrace 已在 PATH;若只放在当前目录,Linux/macOS 把命令开头改为 ./nexttrace,Windows 改为 .\nexttrace.exe。先执行 nexttrace --version 与 nexttrace --help,核对本机实际支持的参数。

当前已核对的稳定版是 v1.7.6(2026 年 11 月 6 日 UTC 发布)。自检与 MTR 保存步骤保留 v1.7.5 的引入背景,新增修复按 v1.7.6 发布说明整理,未声称在各平台实测。完整版与 tiny 默认仍是传统 traceroute;不要把单独的 --json 当成 MTR 输出。

先检查本机执行条件

示例代码
nexttrace --doctor example.com

v1.7.5 的 --doctor 会列出目标解析、源地址选择、路由预测和探测后端初始化结果,然后退出。它不发送探测包,但 DNS/DoT 解析可能联网;自检成功不代表目标可达。Windows 自检不会替你安装 WinDivert。目标填域名或 IP,不填完整网址。

如果提示参数不存在,先确认 PATH 中实际调用的文件和 --version;旧版本可继续原来的短追踪,不要把未知参数错误理解为网络故障。自检报初始化失败时先处理对应本机条件,不应将它计为线路丢包。

v1.7.6 的 macOS 最低要求仍为 13.0;自行编译需要 Go 1.27.3 及以上,按官方发布方式使用默认 JSON 后端,无需沿用旧的 GOEXPERIMENT=nojsonv2 设置。下载现成可执行文件的用户不需要因此安装 Go。

权限和 Windows 支持限制

官方将 Windows 支持标为实验阶段。不同探测模式依赖不同系统能力;不要看到有 exe 就推断所有模式与 Linux 完全一致。Windows 的 TCP/UDP 模式涉及 WinDivert 与管理员权限,ICMP 也可能受防火墙设置影响,应按所用版本的官方说明操作。

Linux 的原始套接字探测通常需要相应权限;macOS 的 TCP/UDP 模式也可能需要提升权限。遇到明确权限错误时,先检查可信下载来源与当前模式,再针对这一次命令使用所需权限。不要为了跑追踪关闭整个防火墙。

容器、虚拟机和受管理网络可能没有相关能力。权限错误与探测目标不回应不同:前者应先修复本机执行条件,后者才进入路径与网络分析。

若 Windows ARM64 上的 IPv6 探测报 set IPv6 Traffic Class 0: not implemented on windows/arm64,v1.7.6 已修复默认零值设置:ICMP、TCP、UDP 都跳过这一不受支持的设置。更新后先核 --version,再用原目标和原模式复核;这不代表非零 --tos 已获支持,也不取消其他模式的权限要求。

开始一次 ICMP 追踪

以下使用文档示例域名,限制为 IPv4、每跳三个样本、最多二十跳。本例使用 ICMP 探测,并显式选择传统 traceroute 模式:

示例代码
nexttrace --traceroute -4 -q 3 -m 20 example.com

-4 固定 IPv4,方便比较同一地址族;-q 设置逐跳样本数;-m 限制最大跳数。目标未在二十跳内出现时,先检查最终停止原因,不要立即认定目标不可达。

域名可能解析到多个地址,线路也会随负载均衡改变。比较两次结果时记录最终选中的目标 IP、运行时间和使用网络。示例不承诺出现固定跳数、运营商或响应时间,输出应以你当时的测量为准。

v1.7.6 的完整版与 tiny 已支持 --traceroute。这里显式固定传统追踪行为,不是修复当前故障:官方计划最早在 2027 年才将默认模式迁移到 MTR,切换版本会另行公告,本次发行默认模式未变。旧版本若不识别该参数,先核对 --version 与 --help,不要直接套用新参数;ntr 仅支持 MTR,不适用这些传统示例。

--traceroute 不能与 --mtr、-r(报告)或 -w(宽报告)混用。下文的 MTR 报告与录制命令保留原模式,不添加此参数。

用 TCP、UDP 对照

ICMP 无回复时,可对同一目标做少量其他协议对照。TCP 例子使用网页常见端口 443;UDP 使用路由追踪端口 33494。一次执行一条命令:

示例代码
nexttrace --traceroute -4 -T -p 443 -q 3 -m 20 example.com
nexttrace --traceroute -4 -U -p 33494 -q 3 -m 20 example.com

-T 选择 TCP,-U 选择 UDP,-p 指定目标端口。端口与协议可能影响防火墙响应和负载均衡,因此结果有差异不必然是工具错误。UDP 目标不提供该端口服务,也可能影响终点反馈。

TCP 443 探测不能替代 TLS 与网页请求验证;追踪有回复也不代表页面加载成功。对业务连接仍应另外做实际请求,首页的 验证命令工具可辅助检查。

星号、延迟与 ASN 标注

NextTrace 输出应如何判断
现象解释与下一步
中间某跳显示星号,后续仍有回复该跳没有在期限内回应探测,可能限速或过滤控制消息;不代表它不能转发业务包。
中间跳延迟高,后续又降低可能是该路由器回复探测较慢,不应把单跳响应时间直接当作线路转发延迟。
从某跳起后续都异常,终点也异常值得继续核查,结合重复测量、实际请求与另一网络对照,仍不能单次归责。
显示意外城市或 ASN查看 IP 与路由关系;地理与归属数据库可能不准确,不等于设备真实位置。

显示的延迟是探测到相应回复者的往返时间,不是单向耗时,也不是相邻两跳之间的纯链路延迟。若使用连续探测统计丢包,同样要关注终点与后续是否延续异常:中间跳丢包比例不能直接当作终点业务丢包比例。

示意追踪中间一跳未回应,但后续跳和终点有回复;星号反映探测未收到回复,不能单凭它认定业务转发失败。
示意:中间跳没有回应,后续仍有回复。判断转发故障还需要终点和业务请求的结果。

保存结果并比较路线

  1. 固定同一目标 IP、协议与端口,先做一次短追踪。
  2. 异常时稍后再测,记录是否可重复;不要只挑一张最差截图。
  3. 再用另一网络做相同参数对照,确认目标与地址族没有变化。
  4. 同时记录一次真实应用请求是否成功,把路径线索与用户体验对应起来。

开启本机系统代理通常不会自动让原始 ICMP/TCP/UDP 探测走代理;TUN、系统路由与远端测量也有各自的路径。要分析代理链路,必须先确认探测从哪里发出、实际路由指向哪里,不能把本机直连追踪当作远端服务器回程。

分享结果时提供版本、时间、目标、参数与现象,遮盖自己的公网或内网信息。带地理标注的输出依赖外部数据服务,标注失败与核心探测失败要分开记录。更多思路可见 网络故障排查。

升级后核对参数

保留原输出、目标 IP 和版本。沿官方发行页或原包管理器更新后,先运行 nexttrace --help,再做一次相同参数的短追踪;路线变化要结合当时网络判断。

v1.7.6:区分画面问题与探测结果

新版修复 iTerm2 选字时旧画面堆叠,并改善窗口缩放和字符显示;探测错误改在 TUI 标题区显示,避免打乱交互画面。窗口较小时先放大终端查看,别把当前可见行数当成完整路径;保存报告与会话录制仍保留完整统计。验证时分别检查画面是否正常、错误提示是否消失和实际探测结果,画面修复本身不能证明线路恢复。

v1.7.5 引入:保存 MTR 汇总或完整会话

只需一次有限样本的机器可读汇总,可以用报告模式。下面每跳最多探测 10 次,最多 20 跳;目标仍应换成你有权诊断的地址。

示例代码
nexttrace -4 -r --json -q 10 -m 20 example.com

-r --json 最终输出一个汇总对象;--mtr --json 则持续输出 NDJSON 事件,自动化使用时要显式限制 -q。诊断信息写到 stderr,不能把它混进 JSON 数据;正常结束也不等于终点可达,要结合报告中的路径结束原因和实际请求。

需要回看逐次探测时,录制到一个尚不存在的文件,再离线回放:

示例代码
nexttrace -4 --mtr -q 10 -m 20 --mtr-record session-01.jsonl example.com
nexttrace --mtr-replay session-01.jsonl

录制不会自动开启 MTR,因此第一条命令保留 --mtr。已有文件不会被覆盖:若重名,换一个文件名,不要先删掉上一次结果。录制写入失败会停止探测并保留已写部分;截断文件的有效前缀可能仍能回放,但应标注会话不完整。

TUI 中按 s 保存的 TXT、JSON 或 HTML 是当时的统计快照,不是完整会话;需要逐次回放应使用录制。分享前检查目标、IP 和网络信息。若升级后遇到回归,保留新旧版本号、参数和结果,恢复你原先保存的官方可执行文件后先核版本;旧版不一定识别新增参数或录制格式。

常见问题

中间一跳不回应,是不是网络断了?

不一定。若后续跳与终点仍有回复,中间设备可能只是不回应或限速探测消息。需要结合后续表现与真实请求判断。

为什么 Windows 某些模式不能用?

Windows 仍为实验支持,模式可能依赖管理员权限、WinDivert 或特定防火墙设置。先核对当前发行说明与本机帮助,不应关闭全部防护来排查。

显示的城市能证明发生了路由绕行吗?

不能仅靠城市标签证明。地理数据库可能有误,应结合 IP、ASN、相邻跳变化与重复追踪分析,并保留原始地址供复核。

参考资料

下载、系统要求和配置字段以对应版本的官方说明为准。文中的流程图由 AFQKit 绘制。

v1.7.6 正式发布说明与修复边界

v1.7.6 模式选择与未来默认迁移说明

doggo →DNS 查询与解析对照Wireshark →抓包与网络协议分析Clash Verge Rev →桌面配置与规则管理

先弄清这些概念

返回工具目录 · 按症状排查问题