Files
NTrace-core/README.md
zhshch2002 0d9b8c8861 fix: typo
2022-05-24 18:27:22 +08:00

138 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div align="center">
<img src="asset/logo.png" height="200px"/>
</div>
# NextTrace
一款开源的可视化路由跟踪工具使用Golang开发。
## How To Use
### Install
```bash
bash -c "$(curl -Ls https://raw.githubusercontent.com/xgadget-lab/nexttrace/main/nt_install.sh)"
```
### Get Started
`NextTrace`默认使用`icmp`协议发起`TraceRoute`请求,该协议同时支持`IPv4``IPv6`
```bash
# IPv4 ICMP Trace
nexttrace 1.0.0.1
# 获得 route-path
nexttrace -report 1.0.0.1
# 打开IP反向解析 rdns
nexttrace -rdns 1.0.0.1
# 表格打印一次性输出全部跳数需等待20-40秒
nexttrace -table 1.0.0.1
# IPv6 ICMP Trace
nexttrace 2606:4700:4700::1111
```
`NextTrace`也可以使用`TCP``UDP`协议发起`Traceroute`请求,不过目前只支持`IPv4`
```bash
# TCP SYN Trace
nexttrace -T www.bing.com
# 可以自行指定端口[此处为443]默认80端口
nexttrace -T -p 443 1.0.0.1
# UDP Trace
nexttrace -U 1.0.0.1
nexttrace -U -p 53 1.0.0.1
```
### IP数据库
目前使用的IP数据库默认为我们自己搭建的API服务如果后期遇到滥用我们可能会选择关闭。
我们也会在后期开放服务端源代码您也可以根据该项目的源码自行搭建属于您的API服务器。
NextTrace所有的的IP地理位置`API DEMO`可以参考[这里](https://github.com/xgadget-lab/nexttrace/blob/main/ipgeo/)
### 全部用法详见Usage菜单
```shell
Usage of nexttrace:
-T Use TCP SYN for tracerouting (default port is 80)
-U Use UDP Package for tracerouting (default port is 53 in UDP)
-d string
Choose IP Geograph Data Provider [LeoMoeAPI, IP.SB, IPInfo, IPInsight] (default "LeoMoeAPI")
-displayMode string
Choose The Display Mode [table, classic] (default "table")
-m int
Set the max number of hops (max TTL to be reached). (default 30)
-p int
Set SYN Traceroute Port (default 80)
-q int
Set the number of probes per each hop. (default 3)
-r int
Set ParallelRequests number. It should be 1 when there is a multi-routing. (default 18)
-rdns
Set whether rDNS will be display
-report
Route Path
```
## 项目截图
![](asset/screenshot_special.png)
![](asset/screenshot.png)
## History
- v0.0.6.alpha - Now
- https://github.com/xgadget-lab/nexttrace
- 因为项目计划调整更名并转移到当前仓库。重构了部分代码提高了效率增加了ICMP(IPv4 & IPv6)支持,并规划了更多功能。
- 最初版本 - v0.0.5.alpha
- https://github.com/OwO-Network/traceroute
- 感谢 Leo (leo.moe) & Vincent (vincent.moe) 发起了这个项目,并完成了最初的工作。
## Thanks
[Sam Sam](https://github.com/samleong123) (samsam123@samsam123.name.my)
[Vincent Young](https://github.com/missuo) (i@yyt.moe)
[waiting4new](https://github.com/waiting4new)
FFEE_CO
nsnnns
## IP Database Copyright
### IPv4 Database
#### China MainLand
* 项目组自行维护 ~ 御三家骨干网数据 ~ 5%
* 埃文科技 Paid Database ~ 95%
#### WorldWide
* 埃文科技 Paid Database ~ 15%
* IpInfo Free ~ 15%
* IPInSight Free ~ 70%
### IPv6 Database
This product includes IP2Location LITE data available from <a href="https://lite.ip2location.com">https://lite.ip2location.com</a>.
### Others
其他第三方API尽管集成在本项目内但是具体的TOS以及AUP请详见第三方API官网。如遇到IP数据错误也请直接联系他们纠错。