willdurand/elk

willdurand/elk镜像说明

镜像概述

该镜像整合Elasticsearch、Logstash、Kibana（ELK）技术栈，用于快速构建日志收集、存储与可视化分析平台。需注意：镜像已停止维护，不同版本分支对应不同组件版本：

• latest/kibana-4.1.2：Kibana 4.1.2 + Elasticsearch 1.x + Logstash 1.x
• kibana-4.4.2：Kibana 4.4.2 + Elasticsearch 2.2 + Logstash 2.2
• kibana-4.5.4：Kibana 4.5.4 + Elasticsearch 2.3 + Logstash 2.3
• kibana-5.x：Kibana 5.x + Elasticsearch 5.x + Logstash 5.x

核心功能

1. 日志收集与处理：通过Logstash接收多源日志，支持过滤、转换等数据预处理
2. 数据存储：Elasticsearch提供分布式搜索与存储能力，高效管理结构化日志
3. 可视化分析：Kibana生成图表、仪表盘，直观展示日志趋势与异常

使用场景

• 生产服务器日志集中管理与故障排查
• 应用系统运行状态监控
• 业务数据日志的统计分析

配置说明

快速启动

bash
docker run -p 8080:80 \
    -v /path/to/your/logstash/config:/etc/logstash \
    willdurand/elk

启动后访问 http://localhost:8080（替换为实际IP），需确保Logstash配置目录至少包含一个配置文件。

Docker Compose基础配置

yaml
elk:
    image: willdurand/elk
    ports:
        - "8080:80"
    volumes:
        - /path/to/your/logstash/config:/etc/logstash

数据持久化

通过数据卷容器保存Elasticsearch数据：

1. 创建数据卷容器：

bash
docker run -d -v /data --name dataelk busybox

2. 启动ELK并挂载数据卷：

bash
docker run -p 8080:80 \
    -v /path/to/your/logstash/config:/etc/logstash \
    --volumes-from dataelk \
    willdurand/elk

Compose配置：

yaml
elk:
    image: willdurand/elk
    ports:
        - "8080:80"
    volumes:
        - /path/to/your/logstash/config:/etc/logstash
    volumes_from:
        - dataelk

dataelk:
    image: busybox
    volumes:
        - /data

生产环境日志接收示例

结合Logstash Forwarder接收生产服务器日志：

yaml
elk:
    image: willdurand/elk
    ports:
        - "80:80"
        - "XX.XX.XX.XX:5043:5043" # 绑定私有IP增强安全性
    volumes:
        - /path/to/your/ssl/files:/etc/ssl
        - /path/to/your/logstash/config:/etc/logstash
    volumes_from:
        - dataelk

dataelk:
    image: busybox
    volumes:
        - /data

Logstash配置需包含：

input {
  lumberjack {
    port => 5043
    ssl_certificate => "/etc/ssl/logstash-forwarder.crt"
    ssl_key => "/etc/ssl/logstash-forwarder.key"
  }
}

扩展建议

遵循Docker最佳实践，建议基于该镜像构建自定义镜像（添加配置文件、依赖等），而非直接映射主机目录到容器卷。