firefart/network_info

Network Info Parser 镜像文档

镜像概述

Network Info Parser 是一个用于解析全球五大区域互联网注册机构（ARIN、APNIC、LACNIC、AfriNIC、RIPE）数据库的工具，可将数据导入本地PostgreSQL数据库，便于查询任意IPv4或IPv6地址的网络归属信息（如网段、网络名称、国家、描述等）。推荐通过Docker部署，简化环境配置流程。

注意：数据库会快速增长，需确保足够存储空间（PostgreSQL数据库约占用4.066GB）。

核心功能与特性

• 多源数据解析：支持解析ARIN、APNIC、LACNIC、AfriNIC、RIPE五大机构的数据库
• PostgreSQL存储：将解析后的数据结构化存储到PostgreSQL，便于高效查询
• IP查询支持：支持IPv4和IPv6地址的网络信息查询
• Docker化部署：提供Docker镜像及docker-compose配置，简化环境依赖管理
• 自动化流程：包含数据下载、解析、入库全流程自动化脚本

使用场景

• 网络数据分析与IP归属溯源
• 企业网络范围交叉验证
• 网络安全调查与IP信息查询
• 学术研究中的网络数据统计分析

使用方法

Docker快速部署

1. 直接连接外部PostgreSQL数据库

sh
# 拉取镜像
docker pull firefart/network_info

# 运行容器（替换数据库连接字符串）
docker run --rm firefart/network_info -c postgres://user:pass@db:5432/network_info

2. 搭配PostgreSQL容器使用

sh
# 启动PostgreSQL容器
docker run --name network_info_db \
  -e POSTGRES_DB=network_info \
  -e POSTGRES_USER=network_info \
  -e POSTGRES_PASSWORD=network_info \
  -d postgres:9-alpine

# 运行解析容器（链接数据库容器）
docker run --rm --link network_info_db:postgres \
  firefart/network_info -c postgres://network_info:network_info@postgres:5432/network_info

Docker Compose部署（Git仓库方式）

若已克隆项目仓库，可通过内置脚本简化操作：

sh
# 构建镜像、启动数据库、下载数据并开始解析
./bin/network_info

# 数据库会在解析完成后保持运行，可通过docker ps查看

快捷查询命令

sh
# 查询IPv4地址信息
./bin/query IPv4

# 查询IPv6地址信息
./bin/query IPv6

# 进入psql交互终端
./bin/psql

手动安装（非Docker方式）

1. 安装依赖（Ubuntu 16.04示例）

sh
# 方式一：直接安装系统包
apt install postgresql python3 python3-netaddr python3-psycopg2 python3-sqlalchemy

# 方式二：通过pip安装
apt install postgresql python3 python-pip
pip install -r requirements.txt

2. 创建PostgreSQL数据库

sh
# 创建数据库用户（密码建议设为"network_info"）
sudo -u postgres createuser --pwprompt --createdb network_info

# 创建数据库
sudo -u postgres createdb --owner=network_info network_info

3. 下载数据库 dumps

sh
./download_dumps.sh

4. 数据查询示例

SQL查询：

sql
-- 查询IPv6地址信息
SELECT block.inetnum, block.netname, block.country, block.description, 
       block.maintained_by, block.created, block.last_modified, block.source 
FROM block 
WHERE block.inetnum >> '2001:db8::1' 
ORDER BY block.inetnum DESC;

-- 查询IPv4地址信息
SELECT block.inetnum, block.netname, block.country, block.description, 
       block.maintained_by, block.created, block.last_modified, block.source 
FROM block 
WHERE block.inetnum >> '8.8.8.8' 
ORDER BY block.inetnum DESC;

脚本查询：

sh
./query_db.sh 192.0.2.1

示例运行输出（docker-compose方式）

$ ./bin/network_info
Creating network "ripe_default" with the default driver
Creating volume "ripe_pg_data" with local driver
Creating ripe_db_1
Downloading afrinic.db.gz...
Connecting to ftp.afrinic.net (196.216.2.24:21)
afrinic.db.gz        100% |****************************************************************************************************************************|  5419k  0:00:00 ETA
...（省略下载过程）...
2020-06-23 20:40:21,534 - create_db - INFO     - MainProcess - empty - script finished: 1149.83 seconds

$ ./bin/query 8.8.8.8
SELECT block.inetnum, block.netname, block.country, block.description, block.maintained_by, block.created, block.last_modified, block.source FROM block WHERE block.inetnum >> '8.8.8.8' ORDER BY block.inetnum DESC;
-[ RECORD 1 ]-+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
inetnum       | 8.0.0.0/8
netname       | IANA-NETBLOCK-8
country       | AU
description   | This network range is not allocated to APNIC. If your whois search has returned this message, then you have searched the APNIC whois database for an address that is allocated by another Regional Internet Registry (RIR). Please search the other RIRs at whois.arin.net or whois.ripe.net for more information about that range.
maintained_by | MAINT-APNIC-AP
created       |
last_modified | 2008-09-04 06:51:28
source        | apnic
...（省略其他记录）...