Nali

An offline tool for querying IP geographic information and CDN provider.

Github Actions

#### [中文文档](https://github.com/zu1k/nali/blob/master/README.md) ## Feature - Multi database support - Chunzhen qqip database - ZX ipv6 database - Geoip2 city database - IPIP free database - ip2region database - DB-IP database - IP2Location DB3 LITE database - CDN provider query - Pipeline support - Interactive query - Both ipv4 and ipv6 supported - Multilingual support - Offline query - Full platform support - Color print ## Install ### Install from source Nali Requires Go >= 1.19. You can build it from source: ```sh $ go install github.com/zu1k/nali@latest ``` ### Install pre-build binary Pre-built binaries are available here: [release](https://github.com/zu1k/nali/releases) Download the binary compatible with your platform, unpack and copy to the directory in path ### Arch Linux We have published 3 packages in Aur: - `nali-go`: release version, compile when installing - `nali-go-bin`: release version, pre-compiled binary - `nali-go-git`: the latest master branch version, compile when installing ## Usage ### Query a simple IP address ``` $ nali 1.2.3.4 1.2.3.4 [澳大利亚 APNIC Debogon-prefix网络] ``` #### or use `pipe` ``` $ echo IP 6.6.6.6 | nali IP 6.6.6.6 [美国 亚利桑那州华楚卡堡市美国国防部网络中心] ``` ### Query multiple IP addresses ``` $ 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 [越南 越南邮电集团公司] ``` ### Interactive query use `exit` or `quit` to 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 ``` ### Use with `dig` ``` $ dig nali.zu1k.com +short | nali 104.28.2.115 [美国 CloudFlare公司CDN节点] 104.28.3.115 [美国 CloudFlare公司CDN节点] 172.67.135.48 [美国 CloudFlare节点] ``` ### Use with `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节点] ``` ### Use with any other program Because nali can read the contents of the `stdin` pipeline, it can be used with any program. ``` bash abc.sh | nali ``` Nali will insert IP information after IP address. ### IPv6 support Use like 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. 服务器网段] ``` ### Query CDN provider ``` $ 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)] ``` ## Interface After nali runs for the first time, a configuration file `config.yaml` will be generated in the working directory (default `~/.nali/config.yaml`), the configuration file defines the database information. A database is defined as follows: ```yaml - name: geoip name-alias: - geolite - geolite2 format: mmdb file: GeoLite2-City.mmdb languages: - ALL types: - IPv4 - IPv6 ``` ### Help ``` $ nali --help Usage: nali [flags] nali [command] Available Commands: completion generate the autocompletion script for the specified shell help Help about any command update update chunzhen ip database Flags: --gbk Use GBK decoder -h, --help help for nali Use "nali [command] --help" for more information about a command. ``` ### Update database Update all databases if available: ``` $ nali update 2020/07/17 12:53:46 正在下载最新纯真 IP 库... 2020/07/17 12:54:05 已将最新的纯真 IP 库保存到本地 /root/.nali/qqwry.dat ``` Update specified databases: ``` $ nali update --db qqwry,cdn 2020/07/17 12:53:46 正在下载最新纯真 IP 库... 2020/07/17 12:54:05 已将最新的纯真 IP 库保存到本地 /root/.nali/qqwry.dat ``` ### Specify database Users can specify which database to use，set environment variables `NALI_DB_IP4`, `NALI_DB_IP6` or both. Supported database: - Geoip2 `['geoip', 'geoip2']` - Chunzhen `['chunzhen', 'qqwry']` - IPIP `['ipip']` - Ip2Region `['ip2region', 'i2r']` - DBIP `['dbip', 'db-ip']` - IP2Location `['ip2location']` #### Windows ##### Use geoip db ``` set NALI_DB_IP4=geoip or use powershell $env:NALI_DB_IP4="geoip" ``` ##### Use ipip db ``` set NALI_DB_IP6=ipip or use powershell $env:NALI_DB_IP6="ipip" ``` #### Linux ##### Use geoip db ``` export NALI_DB_IP4=geoip ``` ##### Use ipip db ``` export NALI_DB_IP6=ipip ``` ### Multilingual support Specify the language to be used by modifying the environment variable `NALI_LANG`, when using a non-Chinese language only the GeoIP2 database is supported The values that can be set for this parameter can be found in the list of supported databases for GeoIP2 ``` # NALI_LANG=en nali 1.1.1.1 1.1.1.1 [Australia] ``` ### Change directory Set the environment variable `NALI_HOME` to specify the working directory where the configuration file and database are stored. You can also use absolute paths in the configuration file to specify other database paths. Set the environment variable `NALI_CONFIG_HOME` to specify the configuration file directory and `NALI_DB_HOME` to specify the database file directory. If no environment variable is specified, the XDG specification will be used, with the configuration file directory in `$XDG_CONFIG_HOME/nali` and the database file directory in `$XDG_DATA_HOME/nali`. ``` set NALI_HOME=D:\nalidb or export NALI_HOME=/home/nali ``` ## Thanks - [纯真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) *use the IPv6 BIN as it contains both IPv4 & IPv6* - [Cobra CLI库](https://github.com/spf13/cobra) Thanks to JetBrains for the Open Source License ## Author **Nali** © [zu1k](https://github.com/zu1k), Released under the [MIT](./LICENSE) License.