NextTrace

An open source visual routing tool that pursues light weight, developed using Golang.

HomePage:www.nxtrace.org

IAAS Sponsor

How To Use

Automated Install

Manual Install

Get Started

# IPv4 ICMP Tracenexttrace 1.0.0.1# URLnexttrace http://example.com:8080/index.html?q=1# Form printingnexttrace --table 1.0.0.1# An Output Easy to Parsenexttrace --raw 1.0.0.1nexttrace --json 1.0.0.1# IPv4/IPv6 Resolve Only, and automatically select the first IP when there are multiple IPsnexttrace --ipv4 g.conexttrace --ipv6 g.co# IPv6 ICMP Tracenexttrace 2606:4700:4700::1111# Developer mode: set the ENV variable NEXTTRACE_DEVMODE=1 to make fatal errors panic with a stack trace.export NEXTTRACE_DEVMODE=1# Disable Path Visualization With the -M parameternexttrace koreacentral.blob.core.windows.net# MapTrace URL: https://api.nxtrace.org/tracemap/html/c14e439e-3250-5310-8965-42a1e3545266.html# Disable MPLS display using the --disable-mpls / -e parameter or the NEXTTRACE_DISABLEMPLS environment variablenexttrace --disable-mpls example.comexport NEXTTRACE_DISABLEMPLS=1

Mandatory Configuration Steps forWindows Users

NextTrace now supports quick testing, and friends who have a one-time backhaul routing test requirement can use it

# IPv4 ICMP Fast Test (Beijing + Shanghai + Guangzhou + Hangzhou) in China Telecom / Unicom / Mobile / Education Networknexttrace --fast-trace# You can also use TCP SYN for testingnexttrace --fast-trace --tcp# You can also quickly test through a customized IP/DOMAIN list filenexttrace --file /path/to/your/iplist.txt# CUSTOMIZED IP DOMAIN LIST FILE FORMAT## One IP/DOMAIN per line + space + description information (optional)## forExample:## 106.37.67.1 BEIJING-TELECOM## 240e:928:101:31a::1 BEIJING-TELECOM## bj.10086.cn BEIJING-MOBILE## 2409:8080:0:1::1## 223.5.5.5

NextTrace already supports route tracing for specified Network Devices

# Use eth0 network interfacenexttrace --dev eth0 2606:4700:4700::1111# Use eth0 network interface's IP# When using the network interface's IP for route tracing, note that the IP type to be traced should be the same as network interface's IP type (e.g. both IPv4)nexttrace --source 204.98.134.56 9.9.9.9

NextTrace can also useTCP andUDP protocols to performTraceroute requests

# TCP SYN Tracenexttrace --tcp www.bing.com# You can specify the port by yourself [here is 443], the default port is 80nexttrace --tcp --port 443 2001:4860:4860::8888# UDP Tracenexttrace --udp 1.0.0.1# You can specify the target port yourself [here it is 5353], the default is port 33494nexttrace --udp --port 5353 1.0.0.1# For TCP/UDP Trace, you can specify the source port; by default, a fixed random port is used# (If you need to use a different random source port for each packet, please set the ENV variable NEXTTRACE_RANDOMPORT, or set the source port to -1)nexttrace --tcp --source-port 14514 www.bing.com

NextTrace also supports some advanced functions, such as ttl control, concurrent probe packet count control, mode switching, etc.

# Send 2 probe packets per hopnexttrace --queries 2 www.hkix.net# Set the maximum attempts per TTLnexttrace --max-attempts 10 www.hkix.net# or use the ENV variable NEXTTRACE_MAXATTEMPTS to persist across runsexport NEXTTRACE_MAXATTEMPTS=10# No concurrent probe packets, only one probe packet is sent at a timenexttrace --parallel-requests 1 www.hkix.net# Start Trace with TTL of 5, end at TTL of 10nexttrace --first 5 --max-hops 10 www.decix.net# In addition, an ENV is provided to set whether to mask the destination IP and omit its hostnameexport NEXTTRACE_ENABLEHIDDENDSTIP=1# Turn off the IP reverse parsing functionnexttrace --no-rdns www.bbix.net# Set the payload size to 1024 bytesnexttrace --psize 1024 example.com# Feature: print Route-Path diagram# Route-Path diagram example:# AS6453 Tata Communication「Singapore『Singapore』」#  ╭╯#  ╰AS9299 Philippine Long Distance Telephone Co.「Philippines『Metro Manila』」#  ╭╯#  ╰AS36776 Five9 Inc.「Philippines『Metro Manila』」#  ╭╯#  ╰AS37963 Aliyun「ALIDNS.COM『ALIDNS.COM』」nexttrace --route-path www.time.com.my# Disable color outputnexttrace --no-color 1.1.1.1# or use ENVexport NO_COLOR=1

NextTrace supports users to select their own IP API (currently supports:LeoMoeAPI,IP.SB,IPInfo,IPInsight,IPAPI.com,IPInfoLocal,CHUNZHEN)

# You can specify the IP database by yourself [IP-API.com here], if not specified, LeoMoeAPI will be usednexttrace --data-provider ip-api.com## Note There are frequency limits for free queries of the ipinfo and IPInsight APIs. You can purchase services from these providers to remove the limits##      If necessary, you can clone this project, add the token provided by ipinfo or IPInsight and compile it yourself##      Fill the token to: ipgeo/tokens.go## Note For the offline database IPInfoLocal, please download it manually and rename it to ipinfoLocal.mmdb. (You can download it from here: https://ipinfo.io/signup?ref=free-database-downloads)##      Current directory, nexttrace binary directory and FHS directories (Unix-like) will be searched.##      To customize it, please use environment variables,export NEXTTRACE_IPINFOLOCALPATH=/xxx/yyy.mmdb## Please be aware: Due to the serious abuse of IP.SB, you will often be not able to query IP data from this source## IP-API.com has a stricter restiction on API calls, if you can't query IP data from this source, please try again in a few minutes# The Pure-FTPd IP database defaults to using http://127.0.0.1:2060 as the query interface. To customize it, please use environment variablesexport NEXTTRACE_CHUNZHENURL=http://127.0.0.1:2060## You can use https://github.com/freshcn/qqwry to build your own Pure-FTPd IP database service# You can also specify the default IP database by setting an environment variableexport NEXTTRACE_DATAPROVIDER=ipinfo

NextTrace supports mixed parameters and shortened parameters

Example:nexttrace --data-provider IPAPI.com --max-hops 20 --tcp --port 443 --queries 5 --no-rdns 1.1.1.1nexttrace -tcp --queries 2 --parallel-requests 1 --table --route-path 2001:4860:4860::8888Equivalent to:nexttrace -d ip-api.com -m 20 -T -p 443 -q 5 -n 1.1.1.1nexttrace -T -q 2 --parallel-requests 1 -t -P 2001:4860:4860::8888

Globalping

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

export GLOBALPING_TOKEN=your_token_here

IP Database

For full usage list, please refer to the usage menu

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                         Printhelp information      --init                         Windows ONLY: Extract WinDivert runtime to                                     current directory  -4  --ipv4                         Use IPv4 only  -6  --ipv6                         Use IPv6 only  -T  --tcp                          Use TCP SYNfor tracerouting (default                                     dest-port is 80)  -U  --udp                          Use UDP SYNfor 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 80for"tcp", 33494for"udp"      --icmp-mode                    Windows ONLY: Choose the method to listenfor 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 andexit  -s  --source                       Usesource address src_addrfor outgoing                                     packets      --source-port                  Usesource port src_portfor outgoing                                     packets  -D  --dev                          Use the following Network Devices as thesource addressin outgoing packets      --listen                       Set listen addressfor 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-limitfor ICMP messages.                                     Default: 50  -i  --ttl-time                     Set how many [milliseconds] between                                     sending packets groups by TTL. Useful when                                     some routers use rate-limitfor 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 Serverfor DNS Parse [dnssb,                                     aliyun, dnspod, google, cloudflare]  -g  --language                     Choose the languagefor 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.

Project screenshot

OpenTrace

NEXTTRACE WEB API

NextTraceroute

LeoMoeAPI Credits

Cloudflare Support

AIWEN TECH Support

JetBrain Support

Credits

Others

Star History