Docker-ELK终极部署指南：3步快速搭建企业级日志分析平台

【免费下载链接】docker-elk deviantony/docker-elk: 是一个使用 Docker 部署的 ELK Stack（Elasticsearch、Logstash 和 Kibana）解决方案，提供了预先构建的 Docker 镜像和简单的部署脚本。适合对 ELK Stack、日志管理和想要使用 Docker 部署 ELK Stack 的开发者。 项目地址: https://gitcode.com/gh_mirrors/do/docker-elk

Docker-ELK是一个使用Docker部署的ELK Stack（Elasticsearch、Logstash和Kibana）解决方案，提供了预先构建的Docker镜像和简单的部署脚本，帮助开发者快速搭建企业级日志分析平台。

🚀 准备工作：环境与依赖检查

在开始部署前，请确保您的系统满足以下要求：

• Docker Engine (20.10.0+)
• Docker Compose (v2.0+)
• 至少4GB可用内存（推荐8GB以上）
• Git工具

通过以下命令检查Docker环境：

docker --version
docker compose version

🔄 第一步：获取项目源码

使用Git克隆官方仓库到本地：

git clone https://gitcode.com/gh_mirrors/do/docker-elk
cd docker-elk

项目核心配置文件位于根目录的docker-compose.yml，包含了Elasticsearch、Logstash、Kibana等核心服务的编排定义。

⚙️ 第二步：配置与初始化

1. 创建环境变量文件（可选）： 复制示例环境变量文件并设置密码：

   cp .env.example .env
   # 编辑.env文件设置密码
   

2. 执行初始化脚本： 该步骤会创建Elasticsearch用户、角色和权限：

   docker compose up setup
   

   初始化服务定义在setup/entrypoint.sh，会自动配置如logstash_internal、kibana_system等必要用户。

🎯 第三步：启动ELK Stack

使用Docker Compose启动所有服务：

docker compose up -d

服务启动后，您可以通过以下端口访问各组件：

• Elasticsearch: http://localhost:9200
• Kibana: http://localhost:5601
• Logstash: 5044 (Beats输入)、9600 (监控API)

🔍 验证部署状态

1. 检查服务运行状态：

   docker compose ps
   

2. 访问Kibana控制台（默认用户名elastic，密码为.env文件中设置的ELASTIC_PASSWORD）：

   http://localhost:5601
   

📊 扩展功能：日志收集与分析

项目提供了多种日志收集扩展，位于extensions/目录：

• Filebeat: 轻量级日志收集器 (extensions/filebeat/)
• Metricbeat: 系统指标收集 (extensions/metricbeat/)
• Heartbeat: 服务可用性监控 (extensions/heartbeat/)

以Filebeat为例，启动命令：

cd extensions/filebeat
docker compose -f filebeat-compose.yml up -d

❗ 常见问题解决

1. Elasticsearch启动失败： 检查内存配置，可在docker-compose.yml第74行调整ES_JAVA_OPTS参数。

2. Kibana无法连接Elasticsearch： 确认elasticsearch/config/elasticsearch.yml中的网络配置。

3. 权限问题： 参考setup/roles/目录下的角色定义文件，检查用户权限配置。

📚 学习资源

• 官方配置文档：README.md
• 扩展组件说明：extensions/README.md
• Logstash管道配置：logstash/pipeline/logstash.conf

通过以上步骤，您已成功部署企业级ELK日志分析平台。该方案适合日志管理、监控告警、数据分析等多种场景，帮助您快速实现日志集中化管理与可视化分析。

【免费下载链接】docker-elk deviantony/docker-elk: 是一个使用 Docker 部署的 ELK Stack（Elasticsearch、Logstash 和 Kibana）解决方案，提供了预先构建的 Docker 镜像和简单的部署脚本。适合对 ELK Stack、日志管理和想要使用 Docker 部署 ELK Stack 的开发者。 项目地址: https://gitcode.com/gh_mirrors/do/docker-elk