GeoIP2-CN的IP段合并工具开发：命令行参数详解

GeoIP2-CN的IP段合并工具开发：命令行参数详解

GeoIP2-CN项目提供了小巧精悍、准确、实用的GeoIP2数据库解决方案。本文将详细解析其IP段合并工具的命令行参数，帮助开发者快速上手和定制化使用该工具。通过本文，你将了解工具的核心功能、参数配置方法以及实际应用场景。

工具核心功能与参数概览

GeoIP2-CN的IP段合并工具主要用于将IP列表文件转换为MaxMind格式的数据库文件，核心功能由main.go实现。工具通过命令行参数接收输入输出路径及数据库类型，完成IP段到MMDB格式的转换。

工具支持的命令行参数如下表所示：

参数解析逻辑在main.go的init函数中实现，通过Go标准库的flag包进行参数绑定：

func init() { flag.StringVar(&srcFile, "s", "ipip_cn.txt", "specify source ip list file") flag.StringVar(&dstFile, "d", "Country.mmdb", "specify destination mmdb file") flag.StringVar(&databaseType,"t", "GeoIP2-Country", "specify MaxMind database type") flag.Parse() }

源文件参数(-s/--srcFile)详解

-s参数用于指定包含IP段列表的源文件路径，默认值为"ipip_cn.txt"。源文件需包含符合CIDR格式的IP段，每行一个条目。工具通过ip2cidr.go中的parseCIDRs函数解析这些IP段：

func parseCIDRs(txtList []string) []*net.IPNet { var networkList = make([]*net.IPNet,0, 50) for _, cidrTxt := range txtList { _,network, err := net.ParseCIDR(cidrTxt) if err != nil || network == nil { log.Printf("%s fail to parse to CIDR\n", cidrTxt) continue } networkList = append(networkList, network) } return networkList }

使用示例：

./geoip2-cn -s custom_ips.txt

该命令将从custom_ips.txt文件读取IP段列表，文件格式示例：

1.0.1.0/24 1.0.2.0/23 1.0.8.0/21

目标文件参数(-d/--dstFile)详解

-d参数指定生成的MMDB数据库文件路径，默认值为"Country.mmdb"。工具在main.go的main函数中创建并写入目标文件：

outFh, err := os.Create(dstFile) if err != nil { log.Fatalf("fail to create output file %v\n", err) } _, err = writer.WriteTo(outFh) if err != nil { log.Fatalf("fail to write to file %v\n", err) }

使用示例：

./geoip2-cn -d china_ip.mmdb

生成的MMDB文件可用于各种支持MaxMind数据库的应用程序，如Nginx、Apache等Web服务器的IP地理位置解析模块。

数据库类型参数(-t/--databaseType)详解

-t参数指定生成的MaxMind数据库类型，默认值为"GeoIP2-Country"。该参数影响数据库的元数据信息，在创建mmdbwriter时被使用：

writer, err := mmdbwriter.New( mmdbwriter.Options{ DatabaseType: databaseType, RecordSize: 24, }, )

支持的数据库类型包括但不限于：

• GeoIP2-Country：国家级别IP数据库
• GeoIP2-City：城市级别IP数据库
• GeoLite2-Country：轻量级国家数据库

使用示例：

./geoip2-cn -t GeoLite2-Country

完整命令示例与工作流程

以下是使用GeoIP2-CN IP段合并工具的完整工作流程示例：

1. 准备IP段列表文件custom_ips.txt
2. 执行转换命令：

./geoip2-cn -s custom_ips.txt -d china_ip.mmdb -t GeoIP2-Country

工具的工作流程如下：

1. 解析命令行参数，获取源文件、目标文件和数据库类型
2. 读取源文件内容，通过ip2cidr.go中的parseCIDRs函数解析IP段
3. 创建MMDB写入器，设置数据库类型和记录大小
4. 将解析后的IP段插入数据库
5. 将数据库内容写入目标文件

参数组合使用与注意事项

在实际应用中，可以组合使用多个参数以满足特定需求。例如，生成城市级别的数据库：

./geoip2-cn -s city_ips.txt -d city.mmdb -t GeoIP2-City

使用时需注意以下事项：

• 源文件必须符合CIDR格式，否则工具会跳过无效条目并记录日志
• 目标文件所在目录需有写入权限
• 数据库类型应与源文件包含的地理信息级别匹配

总结与扩展应用

GeoIP2-CN的IP段合并工具通过简洁的命令行参数提供了灵活的IP数据库生成功能。开发者可根据实际需求定制源数据、输出路径和数据库类型，快速生成符合MaxMind格式的IP地理位置数据库。

除了基本参数使用外，还可通过修改main.go中的cnRecord变量自定义数据库记录内容，或扩展verify/verify_ip.go添加IP段验证功能，进一步增强工具的实用性。

项目的完整使用说明可参考README.md，更多技术细节请查阅项目源代码。