hasecuritysolutions/logstash

Logstash Docker镜像文档

镜像概述和主要用途

本Logstash Docker镜像提供了动态安装插件的功能，允许用户在容器启动时通过指定插件路径来扩展Logstash的功能。适用于需要根据实际需求自定义Logstash插件的场景，支持在线和离线两种插件安装方式。

核心功能和特性

• 动态插件安装：启动时自动安装/logstash_plugins目录中引用的插件
• 在线插件支持：需访问互联网拉取插件，依赖特定域名
• 离线插件支持：可通过本地文件路径指定离线插件包
• 卷映射配置：通过卷映射将宿主机插件目录挂载到容器内指定路径

使用场景和适用范围

• 需要自定义Logstash插件的日志处理场景
• 在线环境：可访问互联网获取插件的部署环境
• 离线环境：已准备离线插件包的隔离网络环境

详细使用方法和配置说明

在线插件安装

前提条件

• Logstash容器需具备互联网访问能力
• 确保可访问以下域名：
  • artifacts.elastic.co
  • index.rubygems.org

操作步骤

1. 在宿主机创建插件目录，例如/opt/elastic_stack/logstash/logstash_plugins
2. 在该目录中创建文件，包含需要安装的插件名称，例如：

   logstash-output-opensearch
   logstash-filter-tld
   

3. 通过卷映射将宿主机目录挂载到容器的/logstash_plugins路径

离线插件安装

前提条件

• 已下载Logstash离线插件包（.zip格式）
• 宿主机可访问离线插件包文件

操作步骤

1. 将离线插件包（如logstash-offline-output-opensearch.zip）放置在宿主机目录，例如/opt/elastic_stack/logstash/
2. 在宿主机插件目录（如/opt/elastic_stack/logstash/logstash_plugins）中创建文件，包含离线插件的本地路径，格式如下：

   file:///opt/elastic_stack/logstash/logstash-offline-output-opensearch.zip
   file:///opt/elastic_stack/logstash/logstash-offline-filter-tld.zip
   

3. 通过卷映射将宿主机插件目录和离线插件文件目录挂载到容器

Docker部署示例

docker run命令（在线插件）

bash
docker run -d \
  -v /opt/elastic_stack/logstash/logstash_plugins:/logstash_plugins \
  --name logstash \
  logstash:latest

docker run命令（离线插件）

bash
docker run -d \
  -v /opt/elastic_stack/logstash/logstash_plugins:/logstash_plugins \
  -v /opt/elastic_stack/logstash:/opt/elastic_stack/logstash \
  --name logstash \
  logstash:latest

docker-compose配置示例

yaml
version: '3'
services:
  logstash:
    image: logstash:latest
    volumes:
      - /opt/elastic_stack/logstash/logstash_plugins:/logstash_plugins
      # 离线插件需添加以下映射
      # - /opt/elastic_stack/logstash:/opt/elastic_stack/logstash
    restart: always
    container_name: logstash