nali/README.md
2023-11-29 12:12:04 +08:00

336 lines
8.5 KiB
Markdown
Raw Permalink 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.

<h1 align="center">
<br>Nali x NextTrace<br>
</h1>
#### [English](https://github.com/zu1k/nali/blob/master/README_en.md)
## 相比原版nali的特别功能
- 支持**NextTrace的LEOMOEAPI** (默认使用若要使用其他API请先设置环境变量NALI=1)
- 支持管道处理 尤其是**配合MTR使用有奇效**
举个例子:
```bash
mtr -n4 tj.189.cn | ./nali-nt_linux_amd64
```
<img width="833" alt="image" src="https://github.com/tsosunchia/nali-nexttrace/assets/59512455/71f7e878-3b81-458d-9e54-f44c196df190">
```bash
mtr -n6 tj.10086.cn | ./nali-nt_linux_amd64
```
<img width="837" alt="image" src="https://github.com/tsosunchia/nali-nexttrace/assets/59512455/5909c266-83b1-4d04-baa5-1991dd09a808">
```bash
#在您的.bashrc 或者 .zshrc中添加如下代码可以方便您的使用
ntr(){
mtr $* -n | /path/to/your/nali-nt
}
#然后就能用如下捷径利用mtr x nexttrace了
ntr 1.1.1.1
#甚至不影响您使用mtr的其他参数比如
ntr 1.1.1.1 -T -c 10
```
**以上操作需要您先自行安装mtr
## 功能
- CDN 服务提供商查询
- 支持交互式查询
- 同时支持IPv4和IPv6
- 支持多语言
- 查询完全离线
- 全平台支持
- 支持彩色输出
- 支持多种数据库
- 纯真 IPv4 离线数据库
- ZX IPv6 离线数据库
- Geoip2 城市数据库 (可选)
- IPIP 数据库 (可选)
- ip2region 数据库 (可选)
- DB-IP 数据库 (可选)
- IP2Location DB3 LITE 数据库 (可选)
## 安装
### 下载预编译的可执行程序
可以从Release页面下载预编译好的可执行程序: [Release](https://github.com/zu1k/nali/releases)
你需要选择适合你系统和硬件架构的版本下载,解压后可直接运行
## 使用说明
### 查询一个IP的地理信息
```
$ nali 1.2.3.4
1.2.3.4 [澳大利亚 APNIC Debogon-prefix网络]
```
#### 或者 使用 `管道`
```
$ echo IP 6.6.6.6 | nali
IP 6.6.6.6 [美国 亚利桑那州华楚卡堡市美国国防部网络中心]
```
### 同时查询多个IP的地理信息
```
$ nali 1.2.3.4 4.3.2.1 123.23.3.0
1.2.3.4 [澳大利亚 APNIC Debogon-prefix网络]
4.3.2.1 [美国 新泽西州纽瓦克市Level3Communications]
123.23.3.0 [越南 越南邮电集团公司]
```
### 交互式查询
使用 `exit``quit` 退出查询
```
$ nali
123.23.23.23
123.23.23.23 [越南 越南邮电集团公司]
1.0.0.1
1.0.0.1 [美国 APNIC&CloudFlare公共DNS服务器]
8.8.8.8
8.8.8.8 [美国 加利福尼亚州圣克拉拉县山景市谷歌公司DNS服务器]
quit
```
### 与 `dig` 命令配合使用
需要你系统中已经安装好 dig 程序
```
$ dig nali.zu1k.com +short | nali
104.28.2.115 [美国 CloudFlare公司CDN节点]
104.28.3.115 [美国 CloudFlare公司CDN节点]
172.67.135.48 [美国 CloudFlare节点]
```
### 与 `nslookup` 命令配合使用
需要你系统中已经安装好 nslookup 程序
```
$ nslookup nali.zu1k.com 8.8.8.8 | nali
Server: 8.8.8.8 [美国 加利福尼亚州圣克拉拉县山景市谷歌公司DNS服务器]
Address: 8.8.8.8 [美国 加利福尼亚州圣克拉拉县山景市谷歌公司DNS服务器]#53
Non-authoritative answer:
Name: nali.zu1k.com
Address: 104.28.3.115 [美国 CloudFlare公司CDN节点]
Name: nali.zu1k.com
Address: 104.28.2.115 [美国 CloudFlare公司CDN节点]
Name: nali.zu1k.com
Address: 172.67.135.48 [美国 CloudFlare节点]
```
### 与任意程序配合使用
因为 nali 支持管道处理,所以可以和任意程序配合使用
```
bash abc.sh | nali
```
Nali 将在 IP后面插入IP地理信息CDN域名后面插入CDN服务提供商信息
### 支持IPv6
和 IPv4 用法完全相同
```
$ nslookup google.com | nali
Server: 127.0.0.53 [局域网 IP]
Address: 127.0.0.53 [局域网 IP]#53
Non-authoritative answer:
Name: google.com
Address: 216.58.211.110 [美国 Google全球边缘网络]
Name: google.com
Address: 2a00:1450:400e:809::200e [荷兰Amsterdam Google Inc. 服务器网段]
```
### 查询 CDN 服务提供商
因为 CDN 服务通常使用 CNAME 的域名解析方式,所以推荐与 `nslookup` 或者 `dig` 配合使用,在已经知道 CNAME 后可单独使用
```
$ nslookup www.gov.cn | nali
Server: 127.0.0.53 [局域网 IP]
Address: 127.0.0.53 [局域网 IP]#53
Non-authoritative answer:
www.gov.cn canonical name = www.gov.cn.bsgslb.cn [白山云 CDN].
www.gov.cn.bsgslb.cn [白山云 CDN] canonical name = zgovweb.v.bsgslb.cn [白山云 CDN].
Name: zgovweb.v.bsgslb.cn [白山云 CDN]
Address: 103.104.170.25 [新加坡 ]
Name: zgovweb.v.bsgslb.cn [白山云 CDN]
Address: 2001:428:6402:21b::5 [美国Louisiana州Monroe Qwest Communications Company, LLC (CenturyLink)]
Name: zgovweb.v.bsgslb.cn [白山云 CDN]
Address: 2001:428:6402:21b::6 [美国Louisiana州Monroe Qwest Communications Company, LLC (CenturyLink)]
```
## 用户交互
程序第一次运行后,会在工作目录生成配置文件 `config.yaml` (默认`~/.nali/config.yaml`),配置文件定义了数据库信息,默认用户无需进行修改
数据库格式默认如下:
```yaml
- name: geoip
name-alias:
- geolite
- geolite2
format: mmdb
file: GeoLite2-City.mmdb
languages:
- ALL
types:
- IPv4
- IPv6
```
其中,`languages` 和 `types` 表示该数据库支持的语言和查询类型。 如果你需要增加数据库,需小心修改配置文件,如果有任何问题,欢迎提 issue 询问。
### 查看帮助
```
$ nali --help
Usage:
nali [flags]
nali [command]
Available Commands:
help Help about any command
update update qqwry, zxipv6wry, ip2region ip database and cdn
Flags:
-h, --help help for nali
-t, --toggle Help message for toggle
Use "nali [command] --help" for more information about a command.
```
### 更新数据库
更新所有可以自动更新的数据库
```
$ nali update
2020/07/17 12:53:46 正在下载最新纯真 IP 库...
2020/07/17 12:54:05 已将最新的纯真 IP 库保存到本地 /root/.nali/qqwry.dat
```
或者指定数据库
```
$ nali update --db qqwry,cdn
2020/07/17 12:53:46 正在下载最新纯真 IP 库...
2020/07/17 12:54:05 已将最新的纯真 IP 库保存到本地 /root/.nali/qqwry.dat
```
### 自选数据库
用户可以指定使用哪个数据库,需要设置环境变量: `NALI_DB_IP4`、`NALI_DB_IP6` 或者两个同时设置
支持的变量内容:
- Geoip2 `['geoip', 'geoip2']`
- Chunzhen `['chunzhen', 'qqwry']`
- IPIP `['ipip']`
- Ip2Region `['ip2region', 'i2r']`
- DBIP `['dbip', 'db-ip']`
- IP2Location `['ip2location']`
#### Windows平台
##### 使用geoip数据库
```
set NALI_DB_IP4=geoip
或者使用 powershell
$env:NALI_DB_IP4="geoip"
```
##### 使用ipip数据库
```
set NALI_DB_IP6=ipip
或者使用 powershell
$env:NALI_DB_IP6="ipip"
```
#### Linux平台
##### 使用geoip数据库
```
export NALI_DB_IP4=geoip
```
##### 使用ipip数据库
```
export NALI_DB_IP4=ipip
```
### 多语言支持
通过修改环境变量 `NALI_LANG` 来指定使用的语言当使用非中文语言时仅支持GeoIP2这个数据库
该参数可设置的值见 GeoIP2 这个数据库的支持列表
```
# NALI_LANG=en nali 1.1.1.1
1.1.1.1 [Australia]
```
### 工作目录
设置环境变量 `NALI_HOME` 来指定工作目录,配置文件和数据库存放在工作目录下。也可在配置文件中使用绝对路径指定其他数据库路径。
设置环境变量 `NALI_CONFIG_HOME` 来指定配置文件目录,`NALI_DB_HOME` 来执行数据库文件目录
如果未指定相关环境变量,将使用 XDG 规范,配置文件目录在 `$XDG_CONFIG_HOME/nali`,数据库文件目录在 `$XDG_DATA_HOME/nali`
```
set NALI_HOME=D:\nali
or
export NALI_HOME=/var/nali
```
## 感谢列表
- [纯真QQIP离线数据库](http://www.cz88.net)
- [qqwry纯真数据库解析](https://github.com/yinheli/qqwry)
- [ZX公网ipv6数据库](https://ip.zxinc.org/ipquery/)
- [Geoip2 city数据库](https://www.maxmind.com/en/geoip2-precision-city-service)
- [geoip2-golang解析器](https://github.com/oschwald/geoip2-golang)
- [CDN provider数据库](https://github.com/SukkaLab/cdn)
- [IPIP数据库](https://www.ipip.net/product/ip.html)
- [IPIP数据库解析](https://github.com/ipipdotnet/ipdb-go)
- [ip2region数据库](https://github.com/lionsoul2014/ip2region)
- [IP2Location DB3 LITE](https://lite.ip2location.com/database/db3-ip-country-region-city)
- [Cobra CLI库](https://github.com/spf13/cobra)
感谢 JetBrains 提供开源项目免费License
<a href="https://www.jetbrains.com/?from=nali">
<img src="assets/GoLand.svg">
</a>
## 作者
**Nali** © [zu1k](https://github.com/zu1k), 遵循 [MIT](./LICENSE) 证书.<br>