NextTrace

一款追求轻量化的开源可视化路由跟踪工具。

---

主页：www.nxtrace.org

IAAS Sponsor

         

我们非常感谢 DMIT、 Misaka 和 SnapStack 提供了支持本项目所需的网络基础设施。

How To Use

Document Language: English

简体中文

⚠️ 请注意：我们欢迎来自社区的PR提交，但是请将您的PR提交至 NTrace-V1 仓库，而不是 NTrace-core 仓库。
关于NTrace-V1和NTrace-core两个仓库的说明：
二者将大体上保持一致。所有的开发工作均在NTrace-V1仓库中进行。NTrace-V1仓库首先发布新版本，在稳定运行一段时间后（时长不定），我们会把版本同步至NTrace-core。这意味着NTrace-V1仓库充当了一个“测试版”的角色。
请注意，版本同步也存在例外。如果NTrace-V1的某个版本出现了严重的bug，NTrace-core会跳过这一有缺陷的版本，直接同步到下一个修复了该问题的版本。

Before Using

使用 NextTrace 之前，我们建议您先阅读 #IP 数据以及精准度说明，在了解您自己的对数据精准度需求以后再进行抉择。

Automated Install

• Linux
  • 一键安装脚本

    curl -sL nxtrace.org/nt | bash
    

  • 从 nxtrace的APT源安装
    • 支持 AMD64/ARM64 架构

      curl -fsSL https://github.com/nxtrace/nexttrace-debs/releases/latest/download/nexttrace-archive-keyring.gpg | sudo tee /etc/apt/keyrings/nexttrace.gpg >/dev/null
      echo "Types: deb
      URIs: https://github.com/nxtrace/nexttrace-debs/releases/latest/download/
      Suites: ./
      Signed-By: /etc/apt/keyrings/nexttrace.gpg" | sudo tee /etc/apt/sources.list.d/nexttrace.sources >/dev/null
      sudo apt update
      sudo apt install nexttrace
      

    • APT源由 wcbing, nxtrace 维护
  • Arch Linux AUR 安装命令
    • 直接下载bin包(仅支持amd64)

      yay -S nexttrace-bin
      

    • 从源码构建(仅支持amd64)

      yay -S nexttrace
      

    • AUR 的构建分别由 ouuan, huyz 维护

  • Linuxbrew 安装命令

    同macOS Homebrew安装方法(homebrew-core版仅支持amd64)

  • deepin 安装命令

    apt install nexttrace
    

  • x-cmd 安装命令

    x env use nexttrace
    

  • Termux 安装命令

    pkg install root-repo
    pkg install nexttrace
    

  • ImmortalWrt 安装命令

    opkg install nexttrace
    

• macOS
  • macOS Homebrew 安装命令
    • homebrew-core版

      brew install nexttrace
      

    • 本仓库ACTIONS自动构建版(更新更快)

      brew tap nxtrace/nexttrace && brew install nxtrace/nexttrace/nexttrace
      

    • homebrew-core 构建由 chenrui333 维护，请注意该版本更新可能会落后仓库Action自动构建版本
• Windows
  • Windows WinGet 安装命令
    • WinGet 版

      winget install nexttrace
      

    • WinGet 构建由 Dragon1573 维护
  • Windows Scoop 安装命令
    • scoop-extras 版

      scoop bucket add extras && scoop install extras/nexttrace
      

    • scoop-extra 由 soenggam 维护

请注意，以上多种安装方式的仓库均由开源爱好者自行维护，不保证可用性和及时更新，如遇到问题请联系仓库维护者解决，或使用本项目官方编译提供的二进制包。

Manual Install

• 下载预编译的可执行程序

  对于以上方法没有涵盖的用户，请直接前往 Release 下载编译后的二进制可执行文件。

  • Release里面为很多系统以及不同架构提供了编译好的二进制可执行文件，如果没有可以自行编译。
  • 一些本项目的必要依赖在Windows上Golang底层实现不完全，所以目前NextTrace在Windows平台出于实验性支持阶段。

Get Started

NextTrace 默认使用ICMP协议发起TraceRoute请求，该协议同时支持IPv4和IPv6

# IPv4 ICMP Trace
nexttrace 1.0.0.1
# URL
nexttrace http://example.com:8080/index.html?q=1

# 表格打印，使用 --table / -t 参数，将实时显示结果
nexttrace --table 1.0.0.1

# 一个方便供机器读取转化的模式
nexttrace --raw 1.0.0.1
nexttrace --json 1.0.0.1

# 只进行IPv4/IPv6解析，且当多个IP时自动选择第一个IP
nexttrace --ipv4 g.co
nexttrace --ipv6 g.co

# IPv6 ICMP Trace
nexttrace 2606:4700:4700::1111

# 禁用路径可视化 使用 --map / -M 参数
nexttrace koreacentral.blob.core.windows.net
# MapTrace URL: https://api.nxtrace.org/tracemap/html/c14e439e-3250-5310-8965-42a1e3545266.html

# 禁用MPLS显示 使用 --disable-mpls / -e 参数 或 NEXTTRACE_DISABLEMPLS 环境变量
nexttrace --disable-mpls example.com
export NEXTTRACE_DISABLEMPLS=1

PS: 路由可视化的绘制模块为独立模块，具体代码可在 nxtrace/traceMap 查看
路由可视化功能因为需要每个 Hop 的地理位置坐标，而第三方 API 通常不提供此类信息，所以此功能目前只支持搭配 LeoMoeAPI 使用。

Windows 用户必须完成的配置步骤

• 对于普通用户模式：
  只能使用 ICMP mode，且需防火墙配置允许ICMP/ICMPv6。

    netsh advfirewall firewall add rule name="All ICMP v4" dir=in action=allow protocol=icmpv4:any,any
    netsh advfirewall firewall add rule name="All ICMP v6" dir=in action=allow protocol=icmpv6:any,any
  

• 对于管理员模式：
  TCP/UDP mode 需要额外安装 npcap 及 WinDivert，
  ICMP mode 若未安装 npcap 及 WinDivert，则需防火墙配置允许ICMP/ICMPv6。
  其中 npcap 请到官网下载并安装（https://npcap.com/#download），WinDivert 可使用 --init 参数自动配置环境。

NextTrace 现已经支持快速测试，有一次性测试回程路由需求的朋友可以使用

# 北上广（电信+联通+移动+教育网）IPv4 / IPv6 ICMP 快速测试
nexttrace --fast-trace

# 也可以使用 TCP SYN 而非 ICMP 进行测试
nexttrace --fast-trace --tcp

# 也可以通过自定义的IP/DOMAIN列表文件进行快速测试
nexttrace --file /path/to/your/iplist.txt
# 自定义的IP/DOMAIN列表文件格式
## 一行一个IP/DOMAIN + 空格 + 描述信息（可选）
## 例如：
## 106.37.67.1 北京电信
## 240e:928:101:31a::1 北京电信
## bj.10086.cn 北京移动
## 2409:8080:0:1::1
## 223.5.5.5

NextTrace 已支持指定网卡进行路由跟踪

# 请注意 Lite 版本此参数不能和快速测试联用，如有需要请使用 enhanced 版本
# 使用 eth0 网卡
nexttrace --dev eth0 2606:4700:4700::1111

# 使用 eth0 网卡IP
# 网卡 IP 可以使用 ip a 或者 ifconfig 获取
# 使用网卡IP进行路由跟踪时需要注意跟踪的IP类型应该和网卡IP类型一致（如都为 IPv4）
nexttrace --source 204.98.134.56 9.9.9.9

NextTrace 也可以使用TCP和UDP协议发起Traceroute请求

# TCP SYN Trace
nexttrace --tcp www.bing.com

# 可以自行指定目标端口[此处为443]，默认80端口
nexttrace --tcp --port 443 2001:4860:4860::8888

# UDP Trace
nexttrace --udp 1.0.0.1

# 可以自行指定目标端口[此处为5353]，默认33494端口
nexttrace --udp --port 5353 1.0.0.1

# TCP/UDP Trace 可以自行指定源端口，默认使用随机一个固定的端口(如需每次发包随机使用不同的源端口，请设置`ENV` `NEXTTRACE_RANDOMPORT`)
nexttrace --tcp --source-port 14514 www.bing.com

NextTrace也同样支持一些进阶功能，如 TTL 控制、并发数控制、模式切换等

# 每一跳发送2个探测包
nexttrace --queries 2 www.hkix.net

# 无并发，每次只发送一个探测包
nexttrace --parallel-requests 1 www.hkix.net

# 从TTL为5开始发送探测包，直到TTL为10结束
nexttrace --first 5 --max-hops 10 www.decix.net
# 此外还提供了一个ENV，可以设置是否隐匿目的IP
export NEXTTRACE_ENABLEHIDDENDSTIP=1

# 关闭IP反向解析功能
nexttrace --no-rdns www.bbix.net

# 设置载荷大小为1024字节
nexttrace --psize 1024 example.com

# 特色功能：打印Route-Path图
# Route-Path图示例：
# AS6453 塔塔通信「Singapore『Singapore』」
#  ╭╯
#  ╰AS9299 Philippine Long Distance Telephone Co.「Philippines『Metro Manila』」
#  ╭╯
#  ╰AS36776 Five9 Inc.「Philippines『Metro Manila』」
#  ╭╯
#  ╰AS37963 阿里云「ALIDNS.COM『ALIDNS.COM』」
nexttrace --route-path www.time.com.my
# 禁止色彩输出
nexttrace --no-color 1.1.1.1
# 或者使用环境变量
export NO_COLOR=1

NextTrace支持用户自主选择 IP 数据库（目前支持：LeoMoeAPI, IP.SB, IPInfo, IPInsight, IPAPI.com, IPInfoLocal, CHUNZHEN)

# 可以自行指定IP数据库[此处为IP-API.com]，不指定则默认为LeoMoeAPI
nexttrace --data-provider ip-api.com
## 特别的: 其中 ipinfo 和 IPInsight API 对于免费版查询有频率限制，可从这些服务商自行购买服务以解除限制，如有需要可以 clone 本项目添加其提供的 token 自行编译
##        TOKEN填写路径：ipgeo/tokens.go

## 特别的: 对于离线库 IPInfoLocal，请自行下载并命名为 ipinfoLocal.mmdb
##        (可以从这里下载：https://ipinfo.io/signup?ref=free-database-downloads)，
##        默认搜索用户当前路径、程序所在路径、和 FHS 路径（Unix-like）
##        如果需要自定义路径，请设置环境变量
export NEXTTRACE_IPINFOLOCALPATH=/xxx/yyy.mmdb
## 另外：由于IP.SB被滥用比较严重，会经常出现无法查询的问题，请知悉。
##      IP-API.com限制调用较为严格，如有查询不到的情况，请几分钟后再试。
# 纯真IP数据库默认使用 http://127.0.0.1:2060 作为查询接口，如需自定义请使用环境变量
export NEXTTRACE_CHUNZHENURL=http://127.0.0.1:2060
## 可使用 https://github.com/freshcn/qqwry 自行搭建纯真IP数据库服务

# 也可以通过设置环境变量来指定默认IP数据库
export NEXTTRACE_DATAPROVIDER=ipinfo

NextTrace支持使用混合参数和简略参数

Example:
nexttrace --data-provider ip-api.com --max-hops 20 --tcp --port 443 --queries 5 --no-rdns 1.1.1.1
nexttrace -tcp --queries 2 --parallel-requests 1 --table --route-path 2001:4860:4860::8888

Equivalent to:
nexttrace -d ip-api.com -m 20 -T -p 443 -q 5 -n 1.1.1.1
nexttrace -T -q 2 --parallel-requests 1 -t -P 2001:4860:4860::8888

Globalping

Globalping 提供了对成千上万由社区托管的探针的访问能力，可用于运行网络测试和测量。

通过 --from 参数可以选择使用指定位置的探针来执行 traceroute。位置字段支持洲、国家、地区、城市、ASN、ISP 或云厂商区域等多种类型。

nexttrace google.com --from Germany
nexttrace google.com --from comcast+california

匿名用户默认每小时限额为 250 次测试。将 GLOBALPING_TOKEN 环境变量设置为你的令牌后，可将限额提升至每小时 500 次。

export GLOBALPING_TOKEN=your_token_here

全部用法详见 Usage 菜单

Usage: nexttrace [-h|--help] [--init] [-4|--ipv4] [-6|--ipv6] [-T|--tcp]
                 [-U|--udp] [-F|--fast-trace] [-p|--port <integer>]
                 [--icmp-mode <integer>] [-q|--queries <integer>]
                 [--parallel-requests <integer>] [-m|--max-hops <integer>]
                 [--max-attempts <integer>] [-d|--data-provider
                 (IP.SB|ip.sb|IPInfo|ipinfo|IPInsight|ipinsight|IPAPI.com|ip-api.com|IPInfoLocal|ipinfolocal|chunzhen|LeoMoeAPI|leomoeapi|ipdb.one|disable-geoip)]
                 [--pow-provider (api.nxtrace.org|sakura)] [-n|--no-rdns]
                 [-a|--always-rdns] [-P|--route-path] [-r|--report] [--dn42]
                 [-o|--output] [-t|--table] [--raw] [-j|--json] [-c|--classic]
                 [-f|--first <integer>] [-M|--map] [-e|--disable-mpls]
                 [-V|--version] [-s|--source "<value>"] [--source-port
                 <integer>] [-D|--dev "<value>"] [--listen "<value>"]
                 [--deploy] [-z|--send-time <integer>] [-i|--ttl-time
                 <integer>] [--timeout <integer>] [--psize <integer>]
                 [_positionalArg_nexttrace_38 "<value>"] [--dot-server
                 (dnssb|aliyun|dnspod|google|cloudflare)] [-g|--language
                 (en|cn)] [--file "<value>"] [-C|--no-color] [--from "<value>"]

Arguments:

  -h  --help                         Print help information
      --init                         Windows ONLY: Extract WinDivert runtime to
                                     current directory
  -4  --ipv4                         Use IPv4 only
  -6  --ipv6                         Use IPv6 only
  -T  --tcp                          Use TCP SYN for tracerouting (default
                                     dest-port is 80)
  -U  --udp                          Use UDP SYN for tracerouting (default
                                     dest-port is 33494)
  -F  --fast-trace                   One-Key Fast Trace to China ISPs
  -p  --port                         Set the destination port to use. With
                                     default of 80 for "tcp", 33494 for "udp"
      --icmp-mode                    Windows ONLY: Choose the method to listen
                                     for ICMP packets (1=Socket, 2=PCAP;
                                     0=Auto)
  -q  --queries                      Set the number of probes per each hop.
                                     Default: 3
      --parallel-requests            Set ParallelRequests number. It should be
                                     1 when there is a multi-routing. Default:
                                     18
  -m  --max-hops                     Set the max number of hops (max TTL to be
                                     reached). Default: 30
      --max-attempts                 Set the max number of attempts per TTL
                                     (instead of a fixed auto value)
  -d  --data-provider                Choose IP Geograph Data Provider [IP.SB,
                                     IPInfo, IPInsight, IP-API.com,
                                     IPInfoLocal, CHUNZHEN, disable-geoip].
                                     Default: LeoMoeAPI
      --pow-provider                 Choose PoW Provider [api.nxtrace.org,
                                     sakura] For China mainland users, please
                                     use sakura. Default: api.nxtrace.org
  -n  --no-rdns                      Do not resolve IP addresses to their
                                     domain names
  -a  --always-rdns                  Always resolve IP addresses to their
                                     domain names
  -P  --route-path                   Print traceroute hop path by ASN and
                                     location
  -r  --report                       output using report mode
      --dn42                         DN42 Mode
  -o  --output                       Write trace result to file
                                     (RealTimePrinter ONLY)
  -t  --table                        Output trace results as table
      --raw                          An Output Easy to Parse
  -j  --json                         Output trace results as JSON
  -c  --classic                      Classic Output trace results like
                                     BestTrace
  -f  --first                        Start from the first_ttl hop (instead of
                                     1). Default: 1
  -M  --map                          Disable Print Trace Map
  -e  --disable-mpls                 Disable MPLS
  -V  --version                      Print version info and exit
  -s  --source                       Use source address src_addr for outgoing
                                     packets
      --source-port                  Use source port src_port for outgoing
                                     packets
  -D  --dev                          Use the following Network Devices as the
                                     source address in outgoing packets
      --listen                       Set listen address for web console (e.g.
                                     127.0.0.1:30080)
      --deploy                       Start the Gin powered web console
  -z  --send-time                    Set how many [milliseconds] between
                                     sending each packet. Useful when some
                                     routers use rate-limit for ICMP messages.
                                     Default: 50
  -i  --ttl-time                     Set how many [milliseconds] between
                                     sending packets groups by TTL. Useful when
                                     some routers use rate-limit for ICMP
                                     messages. Default: 50
      --timeout                      The number of [milliseconds] to keep probe
                                     sockets open before giving up on the
                                     connection. Default: 1000
      --psize                        Set the payload size. Default: 52
      --_positionalArg_nexttrace_38  IP Address or domain name
      --dot-server                   Use DoT Server for DNS Parse [dnssb,
                                     aliyun, dnspod, google, cloudflare]
  -g  --language                     Choose the language for displaying [en,
                                     cn]. Default: cn
      --file                         Read IP Address or domain name from file
  -C  --no-color                     Disable Colorful Output
      --from                         Run traceroute via Globalping
                                     (https://globalping.io/network) from a
                                     specified location. The location field
                                     accepts continents, countries, regions,
                                     cities, ASNs, ISPs, or cloud regions.

项目截图

第三方 IP 数据库 API 开发接口

NextTrace 所有的的 IP 地理位置 API DEMO 可以参考这里

你可以在这里添加你自己的 API 接口，为了 NextTrace 能够正确显示你接口中的内容，请参考 leo.go 中所需要的信息

✨NextTrace LeoMoeAPI 的后端 Demo

GitHub - sjlleo/nexttrace-backend: NextTrace BackEnd

NextTrace LeoMoeAPI现已使用Proof of Work(POW)机制来防止滥用，其中NextTrace作为客户端引入了powclient库，POW CLIENT/SERVER均已开源，欢迎大家使用。(POW模块相关问题请发到对应的仓库)

• GitHub - tsosunchia/powclient: Proof of Work CLIENT for NextTrace
• GitHub - tsosunchia/powserver: Proof of Work SERVER for NextTrace

对于中国大陆用户，可以使用 Nya Labs 提供的位于大陆的POW服务器优化访问速度

#使用方法任选其一
#1. 在环境变量中设置
export NEXTTRACE_POWPROVIDER=sakura
#2. 在命令行中设置
nexttrace --pow-provider sakura

OpenTrace

OpenTrace是 @Archeb 开发的NextTrace的跨平台GUI版本，带来您熟悉但更强大的用户体验。
该软件仍然处于早期开发阶段，可能存在许多缺陷和错误，需要您宝贵的使用反馈。

https://github.com/Archeb/opentrace

NEXTTRACE WEB API

NextTraceWebApi是一个MTR风格的NextTrace网页版服务端实现，提供了包括Docker在内多种部署方式。

https://github.com/nxtrace/nexttracewebapi

NextTraceroute

NextTraceroute，一款默认使用NextTrace API的免root安卓版路由跟踪应用，由 @surfaceocean 开发。
感谢所有测试用户的热情支持，本应用已经通过封闭测试，正式进入 Google Play 商店。

https://github.com/nxtrace/NextTraceroute

Cloudflare Support

本项目受 Alexandria 计划赞助。

AIWEN TECH Support

本项目受 埃文科技 赞助。 很高兴使用埃文科技城市级IP库增强本项目 GEOIP 查询的准确性与完整性，并免费提供给公众。

JetBrain Support

本项目受 JetBrain Open-Source Project License 支持。 很高兴使用Goland作为我们的开发工具。

Credits

Gubo 靠谱主机推荐

IPInfo 无偿提供了本项目大部分数据支持

BGP.TOOLS 无偿提供了本项目的一些数据支持

PeeringDB 无偿提供了本项目的一些数据支持

Globalping 一个开源且免费的项目，提供全球范围内运行 traceroute 等网络测试的访问服务

sjlleo 项目永远的领导者、创始人及核心贡献者

tsosunchia 项目现任管理、基础设施运维及核心贡献者

Yunlq 活跃的社区贡献者

Vincent Young

zhshch2002

Sam Sam

waiting4new

FFEE_CO

bobo liu

YekongTAT

Others

• 其他第三方 API 尽管集成在本项目内，但是具体的 TOS 以及 AUP，请详见第三方 API 官网。如遇到 IP 数据错误，也请直接联系他们纠错。

• 如何获取最新commit的新鲜出炉的二进制可执行文件？

  请前往GitHub Actions中最新一次 Build & Release workflow.

• 常见疑问
  • Windows 平台下，ICMP 模式须手动放行ICMP/ICMPv6防火墙
  • macOS 平台下，仅 ICMP 模式不需要提权运行
  • 在一些情况下，同时运行多个 NextTrace 实例可能会导致互相干扰结果(目前仅在 TCP 模式下有观察到)

IP 数据以及精准度说明

对于IP相关信息的纠错反馈，我们目前开放了两个渠道：

• 本项目的GITHUB ISSUES区中的IP 错误报告汇总帖
• 本项目的纠错专用邮箱: correct#nxtrace.org （请注意此邮箱仅供IP相关信息纠错专用，其他反馈请发送ISSUE）

NextTrace 有多个数据源可以选择，目前默认使用的 LeoMoeAPI 为我们项目维护的数据源。

该项目由 OwO Network 的 Missuo && Leo 发起，由 Zhshch 完成最早期架构的编写和指导，后由 Leo 完成了大部分开发工作，现主要交由 tsosunchia 完成后续的二开和维护工作。

LeoMoeAPI 是 Leo 的作品，归属于 Leo Network，由 Leo 完成整套后端 API 编写，该接口未经允许不可用于任何第三方用途。

LeoMoeAPI 早期数据主要来自 IPInsight、IPInfo，随着项目发展，越来越多的志愿者参与进了这个项目。目前 LeoMoeAPI 有近一半的数据是社区提供的，而另外一半主要来自于包含 IPInfo、IPData、BigDataCloud、IPGeoLocation 在内的多个第三方数据。

LeoMoeAPI 的骨干网数据有近 70% 是社区自发反馈又或者是项目组成员校准的，这给本项目的路由跟踪基础功能带来了一定的保证，但是全球骨干网的体量庞大，我们并无能力如 IPIP 等商业公司拥有海量监测节点，这使得 LeoMoeAPI 的数据精准度无法和形如 BestTrace（IPIP）相提并论。

LeoMoeAPI 已经尽力校准了比较常见的骨干网路由，这部分在测试的时候经常会命中，但是如果遇到封闭型 ISP 的路由，大概率可以遇到错误，此类数据不仅是我们，哪怕 IPInsight、IPInfo 也无法正确定位，目前只有 IPIP 能够标记正确，如对此类数据的精确性有着非常高的要求，请务必使用 BestTrace 作为首选。

我们不保证我们的数据一定会及时更新，也不保证数据的精确性，我们希望您在发现数据错误的时候可以前往 issue 页面提交错误报告，谢谢。

当您使用 LeoMoeAPI 即视为您已经完全了解 NextTrace LeoMoeAPI 的数据精确性，并且同意如果您引用 LeoMoeAPI 其中的数据从而引发的一切问题，均由您自己承担。

DN42 模式使用说明

使用这个模式需要您配置 2 个文件，分别是 geofeed.csv 以及 ptr.csv

当您初次运行 DN42 模式，NT 会为您生成 nt_config.yaml 文件，您可以自定义 2 个文件的存放位置，默认应该存放在 NT 的运行目录下

GeoFeed

对于 geofeed.csv 来说，格式如下：

IP_CDIR,LtdCode,ISO3166-2,CityName,ASN,IPWhois

比如，您可以这么写：

58.215.96.0/20,CN,CN-JS,Wuxi,23650,CHINANET-JS

如果您有一个大段作为骨干网使用，您也可以不写地理位置信息，如下：

202.97.0.0/16,,,4134,CHINANET-BACKBONE

PTR

对于 ptr.csv 来说，格式如下：

IATA_CODE,LtdCode,RegionName,CityName

比如对于美国洛杉矶，您可以这么写

LAX,US,California,Los Anegles

需要注意的是，NextTrace 支持自动匹配 CSV 中的城市名，如果您的 PTR 记录中有 losangeles，您可以只添加上面一条记录就可以正常识别并读取。

Star History