42wim/logstash

Logstash (IPv6 GeoIP支持版) 镜像文档

镜像概述

本镜像为官方Logstash Docker镜像的衍生版本，特别集成了对geoip插件的IPv6支持（基于https://github.com/logstash-plugins/logstash-filter-geoip/pull/8/%E5%AE%9E%E7%8E%B0%EF%BC%89%E3%80%82Logstash%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E7%9A%84%E6%95%B0%E6%8D%AE%E6%94%B6%E9%9B%86%E3%80%81%E5%A4%84%E7%90%86%E5%92%8C%E8%BD%AC%E5%8F%91%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E5%9C%A8%E4%BF%9D%E7%95%99%E5%85%B6%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E7%9A%84%E5%9F%BA%E7%A1%80%E4%B8%8A%EF%BC%8C%E5%A2%9E%E5%BC%BA%E4%BA%86%E5%AF%B9IPv6%E5%9C%B0%E5%9D%80%E7%9A%84%E5%9C%B0%E7%90%86%E4%BF%A1%E6%81%AF%E8%A7%A3%E6%9E%90%E8%83%BD%E5%8A%9B%E3%80%82

核心功能与特性

• 完整Logstash功能：包含Logstash的所有标准功能，如日志收集、过滤、转换和输出
• IPv6 GeoIP支持：通过修改后的geoip插件，支持对IPv6地址进行地理信息解析（如国家、地区、城市等）
• 兼容性：与官方Logstash镜像接口兼容，可无缝替换使用

使用场景

• 需要处理包含IPv6地址的日志数据并进行地理信息分析的场景
• 网络监控系统中对IPv6流量来源进行定位分析
• 多协议环境下的日志集中管理与地理信息关联分析

使用方法

基本运行

使用以下命令启动容器，基本用法与官方Logstash镜像一致：

bash
docker run -d --name logstash-ipv6-geoip [镜像名称]

配置示例

通过挂载配置文件自定义Logstash管道，示例配置（logstash.conf）：

conf
input {
  stdin {}
}

filter {
  geoip {
    source => "ip"  # 日志中IPv6地址字段名
    target => "geoip"
    # 启用IPv6支持（本镜像默认已支持）
  }
}

output {
  stdout { codec => rubydebug }
}

启动容器时挂载配置文件：

bash
docker run -d --name logstash-ipv6-geoip -v /path/to/logstash.conf:/usr/share/logstash/pipeline/logstash.conf [镜像名称]

环境变量配置

支持官方Logstash镜像的所有环境变量，例如设置JVM堆大小：

bash
docker run -d --name logstash-ipv6-geoip -e "LS_JAVA_OPTS=-Xms512m -Xmx512m" [镜像名称]

注意事项

• 确保GeoIP数据库已更新，以获取最新的IPv6地址地理信息
• 配置geoip插件时，source字段需指向日志中的IPv6地址字段
• 本镜像基于官方Logstash镜像构建，版本兼容性请参考官方文档