github.com/nxtrace/NTrace-core@v1.3.1-0.20240513132635-39169291e8c9/README_zh_CN.md (about)

     1  <div align="center">
     2  
     3  <img src="asset/logo.png" height="200px" alt="NextTrace Logo"/>
     4  
     5  </div>
     6  
     7  <h1 align="center">
     8    <br>NextTrace<br>
     9  </h1>
    10  
    11  
    12  <h4 align="center">一款追求轻量化的开源可视化路由跟踪工具。</h4>
    13  
    14  ---------------------------------------
    15  
    16  <h6 align="center">主页:www.nxtrace.org</h6>
    17  
    18  <p align="center">
    19    <a href="https://github.com/nxtrace/Ntrace-V1/actions">
    20      <img src="https://img.shields.io/github/actions/workflow/status/nxtrace/Ntrace-V1/build.yml?branch=main&style=flat-square" alt="Github Actions">
    21    </a>
    22    <a href="https://goreportcard.com/report/github.com/nxtrace/Ntrace-V1">
    23      <img src="https://goreportcard.com/badge/github.com/nxtrace/Ntrace-V1?style=flat-square">
    24    </a>
    25    <a href="https://www.nxtrace.org/downloads">
    26      <img src="https://img.shields.io/github/release/nxtrace/Ntrace-V1/all.svg?style=flat-square">
    27    </a>
    28  </p>
    29  
    30  ## IAAS Sponsor
    31  
    32  <div style="text-align: center;">
    33      <a href="https://dmit.io">
    34          <img src="https://assets.nxtrace.org/dmit.svg" width="170.7" height="62.9">
    35      </a>
    36      &nbsp;&nbsp;&nbsp;&nbsp;
    37      <a href="https://misaka.io" >
    38          <img src="https://assets.nxtrace.org/misaka.svg" width="170.7" height="62.9">
    39      </a>
    40      &nbsp;&nbsp;&nbsp;&nbsp;
    41      <a href="https://portal.saltyfish.io" >
    42          <img src="https://assets.nxtrace.org/snapstack.svg" width="170.7" height="62.9">
    43      </a>
    44  </div>
    45  
    46  
    47  
    48  我们非常感谢 [DMIT](https://dmit.io)、 [Misaka](https://misaka.io) 和 [SnapStack](https://portal.saltyfish.io) 提供了支持本项目所需的网络基础设施。
    49  
    50  ## How To Use
    51  
    52  Document Language: [English](README.md) | 简体中文
    53  
    54  ⚠️ 请注意:我们欢迎来自社区的PR提交,但是请将您的PR提交至 [NTrace-V1](https://github.com/nxtrace/NTrace-V1) 仓库,而不是 [NTrace-core](https://github.com/nxtrace/NTrace-core) 仓库。<br>
    55  关于NTrace-V1和NTrace-core两个仓库的说明:<br>
    56  二者将大体上保持一致。所有的开发工作均在NTrace-V1仓库中进行。NTrace-V1仓库首先发布新版本,在稳定运行一段时间后(时长不定),我们会把版本同步至NTrace-core。这意味着NTrace-V1仓库充当了一个“测试版”的角色。<br>
    57  请注意,版本同步也存在例外。如果NTrace-V1的某个版本出现了严重的bug,NTrace-core会跳过这一有缺陷的版本,直接同步到下一个修复了该问题的版本。
    58  
    59  ### Before Using
    60  
    61  使用 NextTrace 之前,我们建议您先阅读 [#IP 数据以及精准度说明](https://github.com/nxtrace/NTrace-core/blob/main/README_zh_CN.md#ip-%E6%95%B0%E6%8D%AE%E4%BB%A5%E5%8F%8A%E7%B2%BE%E5%87%86%E5%BA%A6%E8%AF%B4%E6%98%8E),在了解您自己的对数据精准度需求以后再进行抉择。
    62  
    63  [NextTrace 的Telegram频道](https://t.me/nexttrace)由项目成员负责,会传递一部分通知,也会发布一些成员自己分享的小工具。项目成员的意见可作为未来项目发展的可能方向,随着开发进度变化可能会有所改动,不代表未来一定会实装,正式定稿公告会发布于 Issue 中。
    64  
    65  ### Automated Install
    66  
    67  * Linux 
    68    * 一键安装脚本
    69  
    70      ```shell
    71      curl nxtrace.org/nt | bash
    72      ```
    73      
    74    * Arch Linux AUR 安装命令
    75       * 直接下载bin包(仅支持amd64)
    76  
    77            ```shell
    78            yay -S nexttrace-bin`
    79            ```
    80       * AUR 的构建分别由 ouuan 维护
    81    * Linuxbrew 安装命令
    82  
    83       同macOS Homebrew安装方法(homebrew-core版仅支持amd64)
    84    * Deepin 安装命令
    85  
    86       ```shell
    87       apt install nexttrace
    88       ```
    89    * Termux 安装命令
    90      
    91       ```shell
    92       pkg install nexttrace-enhanced
    93       ```
    94        
    95       
    96  * macOS
    97    * macOS Homebrew 安装命令
    98       * homebrew-core版
    99  
   100            ```shell
   101            brew install nexttrace
   102            ```
   103       * 本仓库ACTIONS自动构建版(更新更快)
   104  
   105            ```shell
   106            brew tap nxtrace/nexttrace && brew install nxtrace/nexttrace/nexttrace
   107            ```
   108       * homebrew-core 构建由 chenrui333 维护,请注意该版本更新可能会落后仓库Action自动构建版本
   109  
   110  * Windows
   111    * Windows Scoop 安装命令
   112       * scoop-extras版
   113  
   114            ```powershell
   115            scoop bucket add extras && scoop install extras/nexttrace
   116            ```
   117  
   118       * scoop-extra 由 soenggam 维护
   119  
   120    请注意,以上多种安装方式的仓库均由开源爱好者自行维护,不保证可用性和及时更新,如遇到问题请联系仓库维护者解决,或使用本项目官方编译提供的二进制包。
   121  
   122  ### Manual Install
   123  * 下载预编译的可执行程序
   124      
   125      对于以上方法没有涵盖的用户,请直接前往 [Release](https://www.nxtrace.org/downloads) 下载编译后的二进制可执行文件。
   126  
   127      * `Release`里面为很多系统以及不同架构提供了编译好的二进制可执行文件,如果没有可以自行编译。
   128      * 一些本项目的必要依赖在`Windows`上`Golang`底层实现不完全,所以目前`NextTrace`在`Windows`平台出于实验性支持阶段。
   129  
   130  * 从源码安装
   131  
   132      您可在自行安装Go >= 1.20后,使用以下命令安装
   133  
   134      ```shell
   135      go install github.com/nxtrace/NTrace-core@latest
   136      ```
   137      *由于go.mod文件声明和文件目录冲突的问题,你不能用go install命令安装  `NTrace-V1` 版本*
   138      安装后可执行文件在`$GOPATH/bin`目录下,如果您没有设置`GOPATH`,则在`$HOME/go/bin`目录下。 
   139      安装后二进制文件名称与项目名称保持一致,你需要将下文中的 `nexttrace` 命令替换为 `NTrace-core` 使用
   140      如果你希望与下文命令保持一致,可以在执行 `go install` 命令后重命名二进制文件
   141  
   142      ```shell
   143      mv  $GOPATH/bin/NTrace-core $GOPATH/bin/nexttrace
   144      ``` 
   145  
   146  
   147  ### Get Started
   148  
   149  `NextTrace` 默认使用`ICMP`协议发起`TraceRoute`请求,该协议同时支持`IPv4`和`IPv6`
   150  
   151  ```bash
   152  # IPv4 ICMP Trace
   153  nexttrace 1.0.0.1
   154  # URL
   155  nexttrace http://example.com:8080/index.html?q=1
   156  
   157  # 表格打印,使用 --table / -t 参数,将实时显示结果
   158  nexttrace --table 1.0.0.1
   159  
   160  # 一个方便供机器读取转化的模式
   161  nexttrace --raw 1.0.0.1
   162  nexttrace --json 1.0.0.1
   163  
   164  # 只进行IPv4/IPv6解析,且当多个IP时自动选择第一个IP
   165  nexttrace --ipv4 g.co
   166  nexttrace --ipv6 g.co
   167  
   168  # IPv6 ICMP Trace
   169  nexttrace 2606:4700:4700::1111
   170  
   171  # 禁用路径可视化 使用 --map / -M 参数
   172  nexttrace koreacentral.blob.core.windows.net
   173  # MapTrace URL: https://api.nxtrace.org/tracemap/html/c14e439e-3250-5310-8965-42a1e3545266.html
   174  
   175  # 禁用MPLS显示 使用 --disable-mpls / -e 参数 或 NEXTTRACE_DISABLEMPLS 环境变量
   176  nexttrace --disable-mpls example.com
   177  export NEXTTRACE_DISABLEMPLS=1
   178  ```
   179  
   180  PS: 路由可视化的绘制模块由 [@tsosunchia](https://github.com/tsosunchia) 同学编写,具体代码可在 [tsosunchia/traceMap](https://github.com/tsosunchia/traceMap) 查看
   181  
   182  需要注意的是,在 LeoMoeAPI 2.0 中,由于新增了了地理位置数据,**我们已经弃用 traceMap 插件中 OpenStreetMap API 的在线查询的部分,并且使用自己数据库内的位置信息**。
   183  
   184  路由可视化功能因为需要每个 Hop 的地理位置坐标,而第三方 API 通常不提供此类信息,所以此功能目前只支持搭配 LeoMoeAPI 使用。
   185  
   186  `NextTrace` 现已经支持快速测试,有一次性测试回程路由需求的朋友可以使用
   187  
   188  ```bash
   189  # 北上广(电信+联通+移动+教育网)IPv4 / IPv6 ICMP 快速测试
   190  nexttrace --fast-trace
   191  
   192  # 也可以使用 TCP SYN 而非 ICMP 进行测试
   193  nexttrace --fast-trace --tcp
   194  
   195  # 也可以通过自定义的IP/DOMAIN列表文件进行快速测试
   196  nexttrace --file /path/to/your/iplist.txt
   197  # 自定义的IP/DOMAIN列表文件格式
   198  ## 一行一个IP/DOMAIN + 空格 + 描述信息(可选)
   199  ## 例如:
   200  ## 106.37.67.1 北京电信
   201  ## 240e:928:101:31a::1 北京电信
   202  ## bj.10086.cn 北京移动
   203  ## 2409:8080:0:1::1
   204  ## 223.5.5.5
   205  ```
   206  
   207  `NextTrace` 已支持指定网卡进行路由跟踪
   208  
   209  ```bash
   210  # 请注意 Lite 版本此参数不能和快速测试联用,如有需要请使用 enhanced 版本
   211  # 使用 eth0 网卡
   212  nexttrace --dev eth0 2606:4700:4700::1111
   213  
   214  # 使用 eth0 网卡IP
   215  # 网卡 IP 可以使用 ip a 或者 ifconfig 获取
   216  # 使用网卡IP进行路由跟踪时需要注意跟踪的IP类型应该和网卡IP类型一致(如都为 IPv4)
   217  nexttrace --source 204.98.134.56 9.9.9.9
   218  ```
   219  
   220  `NextTrace` 也可以使用`TCP`和`UDP`协议发起`Traceroute`请求,不过目前`UDP`只支持`IPv4`
   221  
   222  ```bash
   223  # TCP SYN Trace
   224  nexttrace --tcp www.bing.com
   225  
   226  # 可以自行指定端口[此处为443],默认80端口
   227  nexttrace --tcp --port 443 2001:4860:4860::8888
   228  
   229  # UDP Trace
   230  nexttrace --udp 1.0.0.1
   231  
   232  # 可以自行指定端口[此处为5353],默认53端口
   233  nexttrace --udp --port 5353 1.0.0.1
   234  ```
   235  
   236  `NextTrace`也同样支持一些进阶功能,如 TTL 控制、并发数控制、模式切换等
   237  
   238  ```bash
   239  # 每一跳发送2个探测包
   240  nexttrace --queries 2 www.hkix.net
   241  
   242  # 无并发,每次只发送一个探测包
   243  nexttrace --parallel-requests 1 www.hkix.net
   244  
   245  # 从TTL为5开始发送探测包,直到TTL为10结束
   246  nexttrace --first 5 --max-hops 10 www.decix.net
   247  # 此外还提供了一个ENV,可以设置是否隐匿目的IP
   248  export NEXTTRACE_ENABLEHIDDENDSTIP=1
   249  
   250  # 关闭IP反向解析功能
   251  nexttrace --no-rdns www.bbix.net
   252  
   253  # 设置载荷大小为1024字节
   254  nexttrace --psize 1024 example.com
   255  
   256  # 特色功能:打印Route-Path图
   257  # Route-Path图示例:
   258  # AS6453 塔塔通信「Singapore『Singapore』」
   259  #  ╭╯
   260  #  ╰AS9299 Philippine Long Distance Telephone Co.「Philippines『Metro Manila』」
   261  #  ╭╯
   262  #  ╰AS36776 Five9 Inc.「Philippines『Metro Manila』」
   263  #  ╭╯
   264  #  ╰AS37963 阿里云「ALIDNS.COM『ALIDNS.COM』」
   265  nexttrace --route-path www.time.com.my
   266  # 禁止色彩输出
   267  nexttrace --nocolor 1.1.1.1
   268  # 或者使用环境变量
   269  export NO_COLOR=1
   270  ```
   271  
   272  `NextTrace`支持用户自主选择 IP 数据库(目前支持:`LeoMoeAPI`, `IP.SB`, `IPInfo`, `IPInsight`, `IPAPI.com`, `Ip2region`, `IPInfoLocal`, `CHUNZHEN`)
   273  
   274  ```bash
   275  # 可以自行指定IP数据库[此处为IP-API.com],不指定则默认为LeoMoeAPI
   276  nexttrace --data-provider ip-api.com
   277  ## 特别的: 其中 ipinfo 和 IPInsight API 对于免费版查询有频率限制,可从这些服务商自行购买服务以解除限制,如有需要可以 clone 本项目添加其提供的 token 自行编译
   278  ##        TOKEN填写路径:ipgeo/tokens.go
   279  ## 特别的: 对于离线库 IPInfoLocal,请自行下载并命名为 ipinfoLocal.mmdb (可以从这里下载:https://ipinfo.io/signup?ref=free-database-downloads)
   280  ##        对于离线库 Ip2region 可NextTrace自动下载,也可自行下载并命名为 ip2region.db
   281  ## 另外:由于IP.SB被滥用比较严重,会经常出现无法查询的问题,请知悉。
   282  ##      IP-API.com限制调用较为严格,如有查询不到的情况,请几分钟后再试。
   283  
   284  # 纯真IP数据库默认使用 http://127.0.0.1:2060 作为查询接口,如需自定义请使用环境变量
   285  export NEXTTRACE_CHUNZHENURL=http://127.0.0.1:2060
   286  ## 可使用 https://github.com/freshcn/qqwry 自行搭建纯真IP数据库服务
   287  
   288  # 也可以通过设置环境变量来指定默认IP数据库
   289  export NEXTTRACE_DATAPROVIDER=ipinfo
   290  ```
   291  
   292  `NextTrace`支持使用混合参数和简略参数
   293  
   294  ```bash
   295  Example:
   296  nexttrace --data-provider ip-api.com --max-hops 20 --tcp --port 443 --queries 5 --no-rdns 1.1.1.1
   297  nexttrace -tcp --queries 2 --parallel-requests 1 --table --route-path 2001:4860:4860::8888
   298  
   299  Equivalent to:
   300  nexttrace -d ip-api.com -m 20 -T -p 443 -q 5 -n 1.1.1.1
   301  nexttrace -T -q 2 --parallel-requests 1 -t -P 2001:4860:4860::8888
   302  ```
   303  
   304  ### 全部用法详见 Usage 菜单
   305  
   306  ```shell
   307  Usage: nexttrace [-h|--help] [-4|--ipv4] [-6|--ipv6] [-T|--tcp] [-U|--udp]
   308                   [-F|--fast-trace] [-p|--port <integer>] [-q|--queries
   309                   <integer>] [--parallel-requests <integer>] [-m|--max-hops
   310                   <integer>] [-d|--data-provider
   311                   (Ip2region|ip2region|IP.SB|ip.sb|IPInfo|ipinfo|IPInsight|ipinsight|IPAPI.com|ip-api.com|IPInfoLocal|ipinfolocal|chunzhen|LeoMoeAPI|leomoeapi|disable-geoip)]
   312                   [--pow-provider (api.nxtrace.org|sakura)] [-n|--no-rdns]
   313                   [-a|--always-rdns] [-P|--route-path] [-r|--report] [--dn42]
   314                   [-o|--output] [-t|--table] [--raw] [-j|--json] [-c|--classic]
   315                   [-f|--first <integer>] [-M|--map] [-e|--disable-mpls]
   316                   [-v|--version] [-s|--source "<value>"] [-D|--dev "<value>"]
   317                   [-z|--send-time <integer>] [-i|--ttl-time <integer>]
   318                   [--timeout <integer>] [--psize <integer>]
   319                   [_positionalArg_nexttrace_32 "<value>"] [--dot-server
   320                   (dnssb|aliyun|dnspod|google|cloudflare)] [-g|--language
   321                   (en|cn)] [--file "<value>"] [-C|--nocolor]
   322  
   323  Arguments:
   324  
   325    -h  --help                         Print help information
   326    -4  --ipv4                         Use IPv4 only
   327    -6  --ipv6                         Use IPv6 only
   328    -T  --tcp                          Use TCP SYN for tracerouting (default port
   329                                       is 80)
   330    -U  --udp                          Use UDP SYN for tracerouting (default port
   331                                       is 53)
   332    -F  --fast-trace                   One-Key Fast Trace to China ISPs
   333    -p  --port                         Set the destination port to use. It is
   334                                       either initial udp port value for
   335                                       "default"method (incremented by each
   336                                       probe, default is 33434), or initial seq
   337                                       for "icmp" (incremented as well, default
   338                                       from 1), or some constantdestination port
   339                                       for other methods (with default of 80 for
   340                                       "tcp", 53 for "udp", etc.)
   341    -q  --queries                      Set the number of probes per each hop.
   342                                       Default: 3
   343        --parallel-requests            Set ParallelRequests number. It should be
   344                                       1 when there is a multi-routing. Default:
   345                                       18
   346    -m  --max-hops                     Set the max number of hops (max TTL to be
   347                                       reached). Default: 30
   348    -d  --data-provider                Choose IP Geograph Data Provider [IP.SB,
   349                                       IPInfo, IPInsight, IP-API.com, Ip2region,
   350                                       IPInfoLocal, CHUNZHEN, disable-geoip].
   351                                       Default: LeoMoeAPI
   352        --pow-provider                 Choose PoW Provider [api.nxtrace.org, sakura]
   353                                       For China mainland users, please use
   354                                       sakura. Default: api.nxtrace.org
   355    -n  --no-rdns                      Do not resolve IP addresses to their
   356                                       domain names
   357    -a  --always-rdns                  Always resolve IP addresses to their
   358                                       domain names
   359    -P  --route-path                   Print traceroute hop path by ASN and
   360                                       location
   361    -r  --report                       output using report mode
   362        --dn42                         DN42 Mode
   363    -o  --output                       Write trace result to file
   364                                       (RealTimePrinter ONLY)
   365    -t  --table                        Output trace results as table
   366        --raw                          An Output Easy to Parse
   367    -j  --json                         Output trace results as JSON
   368    -c  --classic                      Classic Output trace results like
   369                                       BestTrace
   370    -f  --first                        Start from the first_ttl hop (instead from
   371                                       1). Default: 1
   372    -M  --map                          Disable Print Trace Map
   373    -e  --disable-mpls                 Disable MPLS
   374    -v  --version                      Print version info and exit
   375    -s  --source                       Use source src_addr for outgoing packets
   376    -D  --dev                          Use the following Network Devices as the
   377                                       source address in outgoing packets
   378    -z  --send-time                    Set how many [milliseconds] between
   379                                       sending each packet.. Useful when some
   380                                       routers use rate-limit for ICMP messages.
   381                                       Default: 100
   382    -i  --ttl-time                     Set how many [milliseconds] between
   383                                       sending packets groups by TTL. Useful when
   384                                       some routers use rate-limit for ICMP
   385                                       messages. Default: 500
   386        --timeout                      The number of [milliseconds] to keep probe
   387                                       sockets open before giving up on the
   388                                       connection.. Default: 1000
   389        --psize                        Set the packet size (payload size).
   390                                       Default: 52
   391        --_positionalArg_nexttrace_32  IP Address or domain name
   392        --dot-server                   Use DoT Server for DNS Parse [dnssb,
   393                                       aliyun, dnspod, google, cloudflare]
   394    -g  --language                     Choose the language for displaying [en,
   395                                       cn]. Default: cn
   396        --file                         Read IP Address or domain name from file
   397    -C  --nocolor                      Disable Colorful Output
   398  ```
   399  
   400  ## 项目截图
   401  
   402  ![image](https://user-images.githubusercontent.com/59512455/218505939-287727ce-7207-43c4-8e31-fcda7df0b872.png)
   403  
   404  ![image](https://user-images.githubusercontent.com/59512455/218504874-06b9fa4b-48e0-420a-a195-08a1200d65a7.png)
   405  
   406  ## 第三方 IP 数据库 API 开发接口
   407  
   408  NextTrace 所有的的 IP 地理位置 `API DEMO` 可以参考[这里](https://github.com/nxtrace/NTrace-core/blob/main/ipgeo/)
   409  
   410  你可以在这里添加你自己的 API 接口,为了 NextTrace 能够正确显示你接口中的内容,请参考 `leo.go` 中所需要的信息
   411  
   412  ✨NextTrace `LeoMoeAPI` 的后端 Demo
   413  
   414  [GitHub - sjlleo/nexttrace-backend: NextTrace BackEnd](https://github.com/sjlleo/nexttrace-backend)
   415  
   416  NextTrace `LeoMoeAPI`现已使用Proof of Work(POW)机制来防止滥用,其中NextTrace作为客户端引入了powclient库,POW CLIENT/SERVER均已开源,欢迎大家使用。(POW模块相关问题请发到对应的仓库)
   417  - [GitHub - tsosunchia/powclient: Proof of Work CLIENT for NextTrace](https://github.com/tsosunchia/powclient)
   418  - [GitHub - tsosunchia/powserver: Proof of Work SERVER for NextTrace](https://github.com/tsosunchia/powserver)
   419  
   420  对于中国大陆用户,可以使用 [Nya Labs](https://natfrp.com) 提供的位于大陆的POW服务器优化访问速度
   421  ```shell
   422  #使用方法任选其一
   423  #1. 在环境变量中设置
   424  export NEXTTRACE_POWPROVIDER=sakura
   425  #2. 在命令行中设置
   426  nexttrace --pow-provider sakura
   427  ```
   428  
   429  ## OpenTrace
   430  
   431  `OpenTrace`是 @Archeb 开发的`NextTrace`的跨平台`GUI`版本,带来您熟悉但更强大的用户体验。
   432  
   433  该软件仍然处于早期开发阶段,可能存在许多缺陷和错误,需要您宝贵的使用反馈。
   434  
   435  [https://github.com/Archeb/opentrace](https://github.com/Archeb/opentrace)
   436  
   437  ## NEXTTRACE WEB API
   438  
   439  `NextTraceWebApi`是一个`MTR`风格的`NextTrace`网页版服务端实现,提供了包括`Docker`在内多种部署方式。
   440  
   441  [https://github.com/nxtrace/nexttracewebapi](https://github.com/nxtrace/nexttracewebapi)
   442  
   443  ## NextTraceroute
   444  
   445  `NextTraceroute`,一款默认使用`NextTrace API`的免`root`安卓版路由跟踪应用,由 @surfaceocean 开发。
   446  
   447  [https://github.com/nxtrace/NextTraceroute](https://github.com/nxtrace/NextTraceroute)
   448  
   449  ## Credits
   450  
   451  [IPInfo](https://ipinfo.io) 无偿提供了本项目大部分数据支持
   452  
   453  [BGP.TOOLS](https://bgp.tools) 无偿提供了本项目的一些数据支持
   454  
   455  [PeeringDB](https://www.peeringdb.com) 无偿提供了本项目的一些数据支持
   456  
   457  [sjlleo](https://github.com/sjlleo) 项目永远的领导者、创始人及核心贡献者
   458  
   459  [tsosunchia](https://github.com/tsosunchia) 项目现任管理、基础设施运维及核心贡献者
   460  
   461  [Vincent Young](https://github.com/missuo)
   462  
   463  [zhshch2002](https://github.com/zhshch2002)
   464  
   465  [Sam Sam](https://github.com/samleong123)
   466  
   467  [waiting4new](https://github.com/waiting4new)
   468  
   469  [FFEE_CO](https://github.com/fkx4-p)
   470  
   471  [bobo liu](https://github.com/fakeboboliu)
   472  
   473  [YekongTAT](https://github.com/isyekong)
   474  
   475  ## Others
   476  
   477  其他第三方 API 尽管集成在本项目内,但是具体的 TOS 以及 AUP,请详见第三方 API 官网。如遇到 IP 数据错误,也请直接联系他们纠错。
   478  
   479  如何获取最新commit的新鲜出炉的二进制可执行文件?
   480  >请前往GitHub Actions中最新一次 [Build & Release](https://github.com/nxtrace/Ntrace-V1/actions/workflows/build.yml) workflow.
   481  
   482  ## IP 数据以及精准度说明
   483  
   484  对于IP相关信息的纠错反馈,我们目前开放了两个渠道:
   485  >- 本项目的GITHUB ISSUES区中的[IP 错误报告汇总帖](https://github.com/orgs/nxtrace/discussions/222)
   486  >- 本项目的纠错专用邮箱: `correction@nxtrace.org` (请注意此邮箱仅供IP相关信息纠错专用,其他反馈请发送ISSUE)
   487  
   488  NextTrace 有多个数据源可以选择,目前默认使用的 LeoMoeAPI 为我们项目维护的数据源。
   489  
   490  该项目由 OwO Network 的 [Missuo](https://github.com/missuo) && [Leo](https://github.com/sjlleo) 发起,由 [Zhshch](https://github.com/zhshch2002/) 完成最早期架构的编写和指导,后由 Leo 完成了大部分开发工作,现主要交由 [tsosunchia](https://github.com/tsosunchia) 完成后续的二开和维护工作。
   491  
   492  LeoMoeAPI 是 [Leo](https://github.com/sjlleo) 的作品,归属于 Leo Network,由 [Leo](https://github.com/sjlleo) 完成整套后端 API 编写,该接口未经允许不可用于任何第三方用途。
   493  
   494  LeoMoeAPI 早期数据主要来自 IPInsight、IPInfo,随着项目发展,越来越多的志愿者参与进了这个项目。目前 LeoMoeAPI 有近一半的数据是社区提供的,而另外一半主要来自于包含 IPInfo、IPData、BigDataCloud、IPGeoLocation 在内的多个第三方数据。
   495  
   496  LeoMoeAPI 的骨干网数据有近 70% 是社区自发反馈又或者是项目组成员校准的,这给本项目的路由跟踪基础功能带来了一定的保证,但是全球骨干网的体量庞大,我们并无能力如 IPIP 等商业公司拥有海量监测节点,这使得 LeoMoeAPI 的数据精准度无法和形如 BestTrace(IPIP)相提并论。
   497  
   498  LeoMoeAPI 已经尽力校准了比较常见的骨干网路由,这部分在测试的时候经常会命中,但是如果遇到封闭型 ISP 的路由,大概率可以遇到错误,此类数据不仅是我们,哪怕 IPInsight、IPInfo 也无法正确定位,目前只有 IPIP 能够标记正确,如对此类数据的精确性有着非常高的要求,请务必使用 BestTrace 作为首选。
   499  
   500  我们不保证我们的数据一定会及时更新,也不保证数据的精确性,我们希望您在发现数据错误的时候可以前往 issue 页面提交错误报告,谢谢。
   501  
   502  当您使用 LeoMoeAPI 即视为您已经完全了解 NextTrace LeoMoeAPI 的数据精确性,并且同意如果您引用 LeoMoeAPI 其中的数据从而引发的一切问题,均由您自己承担。
   503  
   504  ## DN42 模式使用说明
   505  
   506  使用这个模式需要您配置 2 个文件,分别是 geofeed.csv 以及 ptr.csv
   507  
   508  当您初次运行 DN42 模式,NT 会为您生成 nt_config.yaml 文件,您可以自定义 2 个文件的存放位置,默认应该存放在 NT 的运行目录下
   509  
   510  ### GeoFeed
   511  
   512  对于 geofeed.csv 来说,格式如下:
   513  ```
   514  IP_CDIR,LtdCode,ISO3166-2,CityName,ASN,IPWhois
   515  ```
   516  
   517  比如,您可以这么写:
   518  
   519  ```
   520  58.215.96.0/20,CN,CN-JS,Wuxi,23650,CHINANET-JS
   521  ```
   522  
   523  如果您有一个大段作为骨干网使用,您也可以不写地理位置信息,如下:
   524  
   525  ```
   526  202.97.0.0/16,,,4134,CHINANET-BACKBONE
   527  ```
   528  
   529  ### PTR
   530  
   531  对于 ptr.csv 来说,格式如下:
   532  ```
   533  IATA_CODE,LtdCode,RegionName,CityName
   534  ```
   535  
   536  比如对于美国洛杉矶,您可以这么写
   537  
   538  ```
   539  LAX,US,California,Los Anegles
   540  ```
   541  
   542  需要注意的是,NextTrace 支持自动匹配 CSV 中的城市名,如果您的 PTR 记录中有 `losangeles`,您可以只添加上面一条记录就可以正常识别并读取。
   543  
   544  ## Star History
   545  
   546  [![Star History Chart](https://api.star-history.com/svg?repos=nxtrace/NTrace-core&type=Date)](https://star-history.com/#nxtrace/NTrace-core&Date)