跳转到内容
IPS Logo IPS Docs

转储命令

简介

ips dump 命令允许用户从 IP 数据库文件中导出数据到文本文件中，用于数据分析或其他处理。此命令支持多种数据库格式，并允许自定义输出的数据字段。

使用方法

使用 ips dump 命令，可以指定输入文件、输入格式、导出字段等选项来执行数据导出操作。

命令语法

Terminal window
ips dump -i inputFile [--input-format] [-o outputFile] [flags]
  • -i, --input-file string：指定输入 IP 数据库文件的路径。必填项。
  • --input-format string：指定输入 IP 数据库文件的格式。默认为自动检测。
  • --input-option string：数据库读取器指定选项。具体信息请查阅数据库文档。
  • --hybrid-mode string: 指定混合读取器的操作模式，可选值为 comparison 与 aggregation，参数详细解释请参考 IPS 配置说明。
  • -o, --output-file string：指定转储文件的路径。不指定转储文件时，输出到标准输出流。
  • --lang string：设置输出信息的语言。默认为 zh-CN (中文)。
  • -f, --fields string：指定从输入文件中获取的字段。默认为所有字段。参数详细解释请参考 IPS 配置说明。
  • -r, --rewrite-files string：指定需要载入的改写文件列表。参数详细解释请参考 IPS 配置说明。

示例

转储 IP 数据库内容到标准输出流

Terminal window
# 从 GeoLite2-City.mmdb 数据库文件导出数据到标准输出流
ips dump -i GeoLite2-City.mmdb

转储 IP 数据库内容到文本文件

Terminal window
# 从 GeoLite2-City.mmdb 数据库文件导出数据到 geoip.txt
ips dump -i GeoLite2-City.mmdb -o geoip.txt

自定义导出字段

Terminal window
# 从数据库文件中仅导出国家和城市字段
ips dump -i GeoLite2-City.mmdb -o geoip.txt --fields "country,city"

设置输出语言和改写规则

Terminal window
# 设置导出数据的语言为英文，并应用改写规则
ips dump -i GeoLite2-City.mmdb -o geoip.txt --lang en -r rewrite_rules.txt

注意事项

  • 确保 --input-file 指向的数据库文件是存在且有效的。
  • 如果指定 --input-format，请确认格式与文件相符。
  • 使用 --fields 可以减少输出的数据量，仅导出需要的字段。
  • --lang 选项可以根据需要设置输出数据的语言，通常用于多语言数据库。
  • --rewrite-files 可以在导出数据前应用自定义的重写规则，以纠正数据库中的错误或进行数据定制。