Repolode
deviantony

deviantony/docker-elk

基于 Docker Compose 一键在本地运行 Elasticsearch、Logstash 和 Kibana(ELK)日志分析栈。

Star
18,380
Fork
6,848
未关闭 Issue
5
最近提交
5天前

这是什么?

docker-elk 将 Elastic 技术栈(Elasticsearch、Logstash 和 Kibana)打包成 Docker 镜像和 Docker Compose 配置,只需几条命令即可搭建可用的日志搜索与可视化环境。镜像基于 Elastic 官方 Docker 镜像构建,main 分支跟随最新版 Elastic Stack,旧版本分别保留在独立分支中。

该项目面向快速上手和本地实验,而非生产部署。各组件的配置文件位于仓库中,Compose 文件里的环境变量可覆盖设置。初始化步骤会创建 Kibana 与 Logstash 所需的内置用户,并说明如何重置密码、调整 JVM 堆内存,以及通过重新构建镜像添加 Logstash 插件。

默认配置关闭了 Elasticsearch 的引导检查,并使用较小的堆内存,适合约 1.5 GB 内存的开发机器。默认暴露 Beats、TCP 日志输入、Elasticsearch 和 Kibana 的端口。另有 tls 分支可启用 TLS 加密。

核心功能

  • 01通过一个 Docker Compose 文件同时运行 Elasticsearch、Logstash 和 Kibana。
  • 02内置 setup 服务,用于初始化内置用户和角色。
  • 03可通过环境变量覆盖各组件配置。
  • 04Logstash 默认提供 50000 端口的 TCP 输入,用于发送日志。
  • 05提供 tls 分支,在 Elasticsearch 和 Kibana 中启用 TLS 加密。
  • 06旧版本 Elastic Stack 保留在独立分支中。

适用场景

  • 在开发机上试用 Elasticsearch、Logstash 和 Kibana。
  • 将样例日志导入 Kibana 进行搜索和可视化。
  • 在迁移到生产集群前验证日志处理流程原型。
  • 学习 Elastic 各组件之间的连接与身份认证方式。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/deviantony/docker-elk.git
  2. 2

    初始化 Elasticsearch 用户和用户组

    docker compose up setup
  3. 3

    启动各个堆栈组件

    docker compose up

使用前须知

  • 不适用于生产环境;已禁用引导检查,主要作为开发环境模板。
  • 需要至少 1.5 GB 内存以及 Docker Compose。
  • 白金版功能默认启用 30 天试用,之后自动回退到免费许可证。

收录于专题

标签

常见问题

docker-elk 是什么?
基于 Docker Compose 一键在本地运行 Elasticsearch、Logstash 和 Kibana(ELK)日志分析栈。 docker-elk 将 Elastic 技术栈(Elasticsearch、Logstash 和 Kibana)打包成 Docker 镜像和 Docker Compose 配置,只需几条命令即可搭建可用的日志搜索与可视化环境。镜像基于 Elastic 官方 Docker 镜像构建,main 分支跟随最新版 Elastic Stack,旧版本分别保留在独立分支中。
docker-elk 可以免费使用吗?用的什么许可证?
docker-elk 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
docker-elk 还在维护吗?
活跃维护中。docker-elk 最近一次提交是在 2026年11月2日。
docker-elk 适合用来做什么?
在开发机上试用 Elasticsearch、Logstash 和 Kibana。 将样例日志导入 Kibana 进行搜索和可视化。 在迁移到生产集群前验证日志处理流程原型。 学习 Elastic 各组件之间的连接与身份认证方式。
docker-elk 怎么安装和运行?
克隆仓库: git clone https://github.com/deviantony/docker-elk.git 初始化 Elasticsearch 用户和用户组: docker compose up setup 启动各个堆栈组件: docker compose up
在哪里获取 docker-elk?
源代码和安装说明在 GitHub 上:https://github.com/deviantony/docker-elk

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目

一种与厂商无关的日志检测规则通用格式,并附带大量可直接使用的 Sigma 规则库。

安全#siem#detection-rules#log-analysis
1.1万+49 本周2922PythonOther维护活跃更新于 20小时前