Wodby Elasticsearch Docker镜像文档

镜像概述

Wodby Elasticsearch Docker镜像是基于Elasticsearch***版本构建的容器化解决方案，旨在简化分布式搜索引擎的部署与管理。该镜像针对生产环境进行了优化，提供预配置的参数、灵活的扩展性和丰富的集成选项，适用于需要高效全文搜索、日志分析和实时数据处理的应用场景。

核心功能与特性

• 多版本支持：兼容Elasticsearch 7.x/8.x等主流版本，满足不同应用的版本需求
• 分布式部署：支持单节点和集群模式部署，可通过配置实现节点发现和自动集群扩展
• 安全增强：集成基础安全配置，支持密码认证、TLS加密和角色权限管理
• 资源优化：默认配置JVM参数优化，可根据宿主机资源动态调整内存分配
• 持久化存储：支持数据卷挂载，确保索引数据持久化保存和迁移
• 监控集成：兼容Prometheus、Grafana等监控工具，提供 metrics 接口便于性能监控

使用场景与适用范围

• 企业级全文搜索：为电商平台、内容管理系统提供商品搜索、文档检索功能
• 日志与日志分析：作为ELK/EFK栈核心组件，处理和分析系统日志、应用日志
• 实时数据分析：对业务数据进行实时聚合计算，支持仪表盘展示和趋势预测
• 应用性能监控：存储和分析APM（应用性能监控）数据，定位系统瓶颈
• 物联网数据处理：处理海量传感器数据，支持实时查询和历史数据分析

使用方法与配置说明

快速启动（单节点模式）

bash
docker run -d \
  --name elasticsearch \
  -p 9200:9200 \
  -e ES_JAVA_OPTS="-Xms512m -Xmx512m" \
  -e ES_CLUSTER_NAME=my-cluster \
  -e ES_NODE_NAME=node-1 \
  -e ES_DISCOVERY_TYPE=single-node \
  -v es-data:/usr/share/elasticsearch/data \
  wodby/elasticsearch:8.11

分布式集群部署（docker-compose示例）

yaml
version: '3.8'

services:
  es-master-1:
    image: wodby/elasticsearch:8.11
    container_name: es-master-1
    environment:
      - ES_JAVA_OPTS=-Xms1g -Xmx1g
      - ES_CLUSTER_NAME=es-cluster
      - ES_NODE_NAME=master-1
      - ES_NODE_MASTER=true
      - ES_NODE_DATA=false
      - ES_NODE_INGEST=false
      - ES_DISCOVERY_SEED_HOSTS=es-master-2,es-master-3
      - ES_CLUSTER_INITIAL_MASTER_NODES=master-1,master-2,master-3
      - ES_SECURITY_ENABLED=true
      - ES_ELASTIC_PASSWORD=StrongPassword123!
    volumes:
      - es-master-1-data:/usr/share/elasticsearch/data
    ports:
      - "9200:9200"
    networks:
      - es-network

  es-master-2:
    image: wodby/elasticsearch:8.11
    container_name: es-master-2
    environment:
      - ES_JAVA_OPTS=-Xms1g -Xmx1g
      - ES_CLUSTER_NAME=es-cluster
      - ES_NODE_NAME=master-2
      - ES_NODE_MASTER=true
      - ES_NODE_DATA=false
      - ES_NODE_INGEST=false
      - ES_DISCOVERY_SEED_HOSTS=es-master-1,es-master-3
      - ES_CLUSTER_INITIAL_MASTER_NODES=master-1,master-2,master-3
      - ES_SECURITY_ENABLED=true
    volumes:
      - es-master-2-data:/usr/share/elasticsearch/data
    networks:
      - es-network

  es-master-3:
    image: wodby/elasticsearch:8.11
    container_name: es-master-3
    environment:
      - ES_JAVA_OPTS=-Xms1g -Xmx1g
      - ES_CLUSTER_NAME=es-cluster
      - ES_NODE_NAME=master-3
      - ES_NODE_MASTER=true
      - ES_NODE_DATA=false
      - ES_NODE_INGEST=false
      - ES_DISCOVERY_SEED_HOSTS=es-master-1,es-master-2
      - ES_CLUSTER_INITIAL_MASTER_NODES=master-1,master-2,master-3
      - ES_SECURITY_ENABLED=true
    volumes:
      - es-master-3-data:/usr/share/elasticsearch/data
    networks:
      - es-network

volumes:
  es-master-1-data:
  es-master-2-data:
  es-master-3-data:

networks:
  es-network:
    driver: bridge

关键环境变量配置

数据持久化与备份

通过挂载数据卷/usr/share/elasticsearch/data实现数据持久化，建议定期通过以下命令备份数据：

bash
docker exec -it elasticsearch tar -czf /tmp/es-backup.tar.gz /usr/share/elasticsearch/data
docker cp elasticsearch:/tmp/es-backup.tar.gz /local/backup/path/

注意事项

• 生产环境建议至少部署3个主节点以确保集群高可用
• JVM堆内存建议设置为物理内存的50%，且不超过31GB（Elasticsearch性能优化最佳实践）
• 启用安全认证后，需通过https协议访问API（默认端口9200）
• 集群网络需确保节点间端口通信正常（9300/tcp用于节点间通信）