dockerkun/elasticsearch-icu-kuromoji

Elasticsearch Docker 镜像文档

镜像概述

Elasticsearch Docker 镜像是官方提供的容器化部署方案，用于快速搭建 Elasticsearch 搜索引擎实例。该镜像基于轻量级 Linux 发行版构建，包含完整的 Elasticsearch 运行环境，支持单节点部署和分布式集群配置，适用于开发、测试和生产环境。

主要用途

• 存储和检索结构化/非结构化数据
• 执行复杂全文搜索和过滤查询
• 实时数据聚合与分析
• 日志、指标和事件数据集中处理
• 构建企业级搜索应用

核心功能与特性

核心功能

• 分布式架构：自动分片和副本机制，支持数据分布式存储与查询
• 全文搜索：基于 Lucene 的强大全文检索能力，支持分词、模糊匹配、高亮等
• 实时分析：毫秒级数据索引和查询响应，支持近实时数据处理
• 聚合分析：提供丰富的聚合功能（统计、分组、排序等），支持复杂数据分析
• RESTful API：通过 HTTP 接口轻松与应用集成，支持 JSON 格式数据交互

关键特性

• 水平扩展：通过添加节点无缝扩展集群容量和性能
• 高可用性：自动副本同步，节点故障时自动故障转移
• 多租户支持：通过索引隔离实现多用户数据分离
• 插件生态：支持分词器、监控、安全等丰富插件扩展
• 内存优化：高效的内存管理机制，支持大规模数据集

使用场景与适用范围

典型使用场景

• 日志与指标分析：作为 ELK/Elastic Stack 核心，集中收集、存储和分析系统日志、应用日志
• 企业搜索：构建产品目录、文档管理系统、知识库等搜索功能
• 应用性能监控：存储和分析应用性能指标，实现实时监控和告警
• 电子商务搜索：提供商品搜索、过滤、排序和推荐功能
• 安全信息与事件管理（SIEM）：集中分析安全事件日志，检测异常行为

适用范围

• 中小型应用单节点部署
• 大型企业分布式集群（支持数百节点）
• 开发/测试环境快速验证
• 云原生环境容器化部署

使用方法与配置说明

前提条件

• Docker Engine 19.03+
• Docker Compose 2.0+（集群部署时）
• 至少 2GB 可用内存（单节点最小配置）

单节点快速启动

基础启动命令

bash
docker run -d \
  --name elasticsearch \
  -p 9200:9200 \
  -e "discovery.type=single-node" \
  -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" \
  docker.xuanyuan.run/elasticsearch:8.11.3

验证启动

bash
# 检查容器状态
docker ps | grep elasticsearch

# 验证服务可用性
curl http://localhost:9200
# 预期响应（包含集群名称、版本等信息）
{
  "name" : "container-id",
  "cluster_name" : "docker-cluster",
  "cluster_uuid" : "...",
  "version" : { ... },
  "tagline" : "You Know, for Search"
}

分布式集群部署（Docker Compose）

docker-compose.yml 配置示例（3节点集群）

yaml
version: '3.8'

services:
  es01:
    image: docker.xuanyuan.run/elasticsearch:8.11.3
    container_name: es01
    environment:
      - node.name=es01
      - cluster.name=es-docker-cluster
      - discovery.seed_hosts=es02,es03
      - cluster.initial_master_nodes=es01,es02,es03
      - ES_JAVA_OPTS=-Xms1g -Xmx1g
      - xpack.security.enabled=false  # 生产环境建议启用
    volumes:
      - esdata01:/usr/share/elasticsearch/data
    ports:
      - "9200:9200"
    networks:
      - elastic

  es02:
    image: docker.xuanyuan.run/elasticsearch:8.11.3
    container_name: es02
    environment:
      - node.name=es02
      - cluster.name=es-docker-cluster
      - discovery.seed_hosts=es01,es03
      - cluster.initial_master_nodes=es01,es02,es03
      - ES_JAVA_OPTS=-Xms1g -Xmx1g
      - xpack.security.enabled=false
    volumes:
      - esdata02:/usr/share/elasticsearch/data
    networks:
      - elastic

  es03:
    image: docker.xuanyuan.run/elasticsearch:8.11.3
    container_name: es03
    environment:
      - node.name=es03
      - cluster.name=es-docker-cluster
      - discovery.seed_hosts=es01,es02
      - cluster.initial_master_nodes=es01,es02,es03
      - ES_JAVA_OPTS=-Xms1g -Xmx1g
      - xpack.security.enabled=false
    volumes:
      - esdata03:/usr/share/elasticsearch/data
    networks:
      - elastic

volumes:
  esdata01:
  esdata02:
  esdata03:

networks:
  elastic:
    driver: bridge

启动集群

bash
docker-compose up -d

验证集群状态

bash
curl http://localhost:9200/_cluster/health?pretty
# 预期响应（status 为 green 表示集群健康）
{
  "cluster_name" : "es-docker-cluster",
  "status" : "green",
  "timed_out" : false,
  "number_of_nodes" : 3,
  "number_of_data_nodes" : 3,
  ...
}

关键配置参数

环境变量配置

持久化存储

Elasticsearch 数据需持久化存储，通过 Docker 卷挂载实现：

bash
docker run -d \
  --name elasticsearch \
  -v esdata:/usr/share/elasticsearch/data \
  ... \
  elasticsearch:8.11.3

安全配置（生产环境必需）

8.x 版本默认启用安全功能，首次启动需获取自动生成的密码：

bash
# 获取初始密码（elastic 用户）
docker exec -it elasticsearch bin/elasticsearch-reset-password -u elastic

启用安全后访问需认证：

bash
curl -u elastic:密码 http://localhost:9200

注意事项

1. 内存配置：确保 ES_JAVA_OPTS 中 Xms 和 Xmx 设置为相同值，且不超过主机内存的 50%
2. 文件描述符限制：生产环境需提高主机文件描述符限制（建议至少 65535）
3. 内核参数：调整内核参数（如 vm.max_map_count=262144），详情参考 https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html#_set_vm_max_map_count_to_at_least_262144
4. 版本兼容性：Elasticsearch 主版本间不兼容，升级需遵循官方迁移指南
5. 备份策略：定期通过 _snapshot API 创建数据备份

参考链接

• https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html
• https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html
• https://www.elastic.co/guide/en/elastic-stack/current/index.html