cirepo/elasticsearch

docker-elasticsearch

镜像概述和主要用途

Elasticsearch 是 ELK（Elasticsearch, Logstash, Kibana）栈的核心组件，提供分布式全文搜索和实时数据分析能力。本 Docker 镜像封装了 Elasticsearch，便于快速部署和集成到各类应用架构中，适用于日志集中分析、全文检索系统、实时数据监控等场景。

官方资源

• https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html
• https://github.com/elastic/elasticsearch/blob/master/distribution/docker/src/docker/Dockerfile
• https://github.com/elastic/elasticsearch
• https://hub.docker.com/_/elasticsearch/%EF%BC%88%E6%96%B0%E5%9C%B0%E5%9D%80%EF%BC%9Ahttps://www.docker.elastic.co/%EF%BC%89

核心功能和特性

• 分布式架构：支持水平扩展，可构建高可用集群
• 实时搜索：毫秒级响应全文检索请求
• 多插件支持：内置丰富插件，满足不同场景需求
• 监控集成：支持 X-Pack 监控功能，实时收集集群指标
• 灵活配置：通过环境变量和配置文件自定义集群参数

使用场景和适用范围

• 日志集中管理与分析（配合 Logstash、Kibana）
• 企业级全文检索系统（如电商商品搜索、文档检索）
• 实时数据分析与可视化
• 业务指标监控与告警

使用方法和配置说明

默认凭据

• 用户名：elastic
• 密码：changeme（生产环境需立即修改）

启用监控

通过以下 API 请求启用集群监控（需使用默认凭据认证）：

bash
PUT _cluster/settings

请求体：

json
{
  "persistent": {
    "xpack.monitoring.collection.enabled": true
  }
}

内核参数配置

生产环境需将 vm.max_map_count 内核参数设置为至少 262144，具体配置方法如下：

Linux 系统

1. 永久配置（重启后生效）：
   编辑 /etc/sysctl.conf，添加或修改：

   bash
   vm.max_map_count=262144
   

2. 临时生效（当前会话）：

   bash
   sysctl -w vm.max_map_count=262144
   

3. 验证配置：

   bash
   grep vm.max_map_count /etc/sysctl.conf
   # 或
   sysctl vm.max_map_count
   

macOS（Docker for Mac）

需在 xhyve 虚拟机内配置：

1. 连接虚拟机终端：

   bash
   screen ~/Library/Containers/com.docker.docker/Data/com.docker.driver.amd64-linux/tty
   

2. 使用 root 用户（无密码）登录后执行：

   bash
   sysctl -w vm.max_map_count=262144
   # 验证
   sysctl vm.max_map_count
   

内置插件

默认 Kibana 插件

• ingest-geoip（6.2.3）
• ingest-user-agent（6.2.3）

AWS 实例插件

• 分析插件：analysis-icu（6.2.3）、analysis-kuromoji（6.2.3）、analysis-phonetic（6.2.3）、analysis-seunjeon（x.x.x.x，仅 AWS）、analysis-smartcn（6.2.3）、analysis-stempel（6.2.3）、analysis-ukrainian（6.2.3）
• 发现插件：discovery-ec2（6.2.3）
• 其他插件：elasticsearch-jetty（2.2.0，仅 AWS）、ingest-attachment（6.2.3）、mapper-murmur3（6.2.3）、mapper-size（6.2.3）、repository-s3（6.2.3）

性能监控

• 查看集群统计信息：

  bash
  GET /_stats
  

• 写密集型场景建议：
  使用 iostat 工具监控磁盘 IO 指标，调整 index.translog.flush_threshold_size 参数优化写入性能。

部署示例

基础单节点部署

bash
docker run -d \
  --name elasticsearch \
  -p 9200:9200 \
  -e "discovery.type=single-node" \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.3

注：版本号需根据实际需求替换，生产环境建议配置持久化存储和集群模式。