Docker 安装和配置 Elasticsearch 完整指南

原创 于 2025-10-27 11:21:41 发布 · 1k 阅读 · 10 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#docker #elasticsearch #容器

Elasticsearch 作为最流行的开源搜索引擎，在大数据搜索和日志分析领域广泛应用。结合 Docker，我们可以快速部署和管理 Elasticsearch 集群。本文将详细介绍如何使用 Docker 安装和配置 Elasticsearch。

目录

  • Elasticsearch 简介

  • 环境准备

  • 单节点安装

  • 配置参数详解

  • 数据持久化

  • 集群部署

  • 安全配置

  • Kibana 集成

  • 常用操作

  • 故障排查

Elasticsearch 简介

Elasticsearch 是一个分布式、RESTful 风格的搜索和数据分析引擎，具有以下特点：

  • 实时搜索和分析

  • 分布式架构

  • 支持多租户

  • RESTful API

  • 支持结构化、非结构化数据

环境准备

系统要求

  • Docker 20.10+

  • 至少 4GB 内存

  • 2核 CPU

  • 20GB 磁盘空间

安装 Docker

bash

# Ubuntu/Debian
sudo apt update
sudo apt install docker.io

# CentOS/RHEL
sudo yum install docker

# 启动 Docker
sudo systemctl start docker
sudo systemctl enable docker

# 验证安装
docker --version

单节点安装

快速启动

bash

# 拉取最新镜像
docker pull docker.elastic.co/elasticsearch/elasticsearch:8.11.0

# 简单运行
docker run -d --name elasticsearch \
  -p 9200:9200 -p 9300:9300 \
  -e "discovery.type=single-node" \
  -e "xpack.security.enabled=false" \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.0

验证安装

bash

# 检查服务状态
curl -X GET "localhost:9200/"

# 预期输出
{
  "name" : "node-1",
  "cluster_name" : "docker-cluster",
  "cluster_uuid" : "abcd1234",
  "version" : {
    "number" : "8.11.0",
    "build_flavor" : "default",
    "build_type" : "docker",
    "build_hash" : "abcdef123456",
    "build_date" : "2023-01-01T00:00:00.000Z",
    "build_snapshot" : false,
    "lucene_version" : "9.8.0",
    "minimum_wire_compatibility_version" : "7.17.0",
    "minimum_index_compatibility_version" : "7.0.0"
  },
  "tagline" : "You Know, for Search"
}

配置参数详解

基础配置

bash

docker run -d --name elasticsearch \
  -p 9200:9200 -p 9300:9300 \
  -e "discovery.type=single-node" \
  -e "ES_JAVA_OPTS=-Xms2g -Xmx2g" \
  -e "cluster.name=my-elasticsearch-cluster" \
  -e "node.name=node-1" \
  -e "network.host=0.0.0.0" \
  -e "http.cors.enabled=true" \
  -e "http.cors.allow-origin=*" \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.0

环境变量说明

  • discovery.type=single-node：单节点模式

  • ES_JAVA_OPTS：JVM 内存设置

  • cluster.name：集群名称

  • node.name：节点名称

  • network.host：网络绑定地址

  • http.cors.enabled：跨域访问支持

数据持久化

使用数据卷

bash

# 创建数据卷
docker volume create es-data

# 运行容器并挂载数据卷
docker run -d --name elasticsearch \
  -p 9200:9200 -p 9300:9300 \
  -e "discovery.type=single-node" \
  -e "xpack.security.enabled=false" \
  -v es-data:/usr/share/elasticsearch/data \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.0

使用宿主机目录

bash

# 创建本地目录
mkdir -p /docker/elasticsearch/{data,logs,config}

# 设置目录权限（重要！）
chmod -R 777 /docker/elasticsearch/

# 运行容器
docker run -d --name elasticsearch \
  -p 9200:9200 -p 9300:9300 \
  -e "discovery.type=single-node" \
  -e "xpack.security.enabled=false" \
  -v /docker/elasticsearch/data:/usr/share/elasticsearch/data \
  -v /docker/elasticsearch/logs:/usr/share/elasticsearch/logs \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.0

使用自定义配置文件

创建配置文件

yaml

# elasticsearch.yml
cluster.name: "docker-cluster"
network.host: 0.0.0.0

# 单节点配置
discovery.type: single-node

# 跨域配置
http.cors.enabled: true
http.cors.allow-origin: "*"

# 内存设置
bootstrap.memory_lock: false

# 安全配置（生产环境建议开启）
xpack.security.enabled: false

运行容器

bash

docker run -d --name elasticsearch \
  -p 9200:9200 -p 9300:9300 \
  -v /docker/elasticsearch/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml \
  -v /docker/elasticsearch/data:/usr/share/elasticsearch/data \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.0

集群部署

使用 Docker Compose

创建 docker-compose.yml 文件：

yaml

version: '3.8'

services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.0
    container_name: elasticsearch
    environment:
      - discovery.type=single-node
      - "ES_JAVA_OPTS=-Xms2g -Xmx2g"
      - cluster.name=docker-cluster
      - xpack.security.enabled=false
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - es-data:/usr/share/elasticsearch/data
      - ./elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml
    ports:
      - "9200:9200"
      - "9300:9300"
    networks:
      - es-net

volumes:
  es-data:
    driver: local

networks:
  es-net:
    driver: bridge

启动集群服务

bash

# 启动服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f elasticsearch

安全配置

启用安全功能

bash

# 运行带有安全配置的容器
docker run -d --name elasticsearch \
  -p 9200:9200 -p 9300:9300 \
  -e "discovery.type=single-node" \
  -e "xpack.security.enabled=true" \
  -e "ELASTIC_PASSWORD=your_secure_password" \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.0

使用安全连接

bash

# 使用密码访问
curl -u elastic:your_secure_password "localhost:9200/"

# 或使用 API Key
curl -H "Authorization: ApiKey your_api_key" "localhost:9200/"

Kibana 集成

安装 Kibana

bash

# 拉取 Kibana 镜像
docker pull docker.elastic.co/kibana/kibana:8.11.0

# 运行 Kibana
docker run -d --name kibana \
  -p 5601:5601 \
  -e "ELASTICSEARCH_HOSTS=http://elasticsearch:9200" \
  --link elasticsearch:elasticsearch \
  docker.elastic.co/kibana/kibana:8.11.0

完整的 Docker Compose 配置

yaml

version: '3.8'

services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.0
    container_name: elasticsearch
    environment:
      - discovery.type=single-node
      - "ES_JAVA_OPTS=-Xms1g -Xmx1g"
      - xpack.security.enabled=false
    ulimits:
      memlock:
        soft: -1
        hard: -1
    volumes:
      - es-data:/usr/share/elasticsearch/data
    ports:
      - "9200:9200"
    networks:
      - elk-network

  kibana:
    image: docker.elastic.co/kibana/kibana:8.11.0
    container_name: kibana
    environment:
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
    ports:
      - "5601:5601"
    depends_on:
      - elasticsearch
    networks:
      - elk-network

volumes:
  es-data:
    driver: local

networks:
  elk-network:
    driver: bridge

常用操作

容器管理命令

bash

# 启动容器
docker start elasticsearch

# 停止容器
docker stop elasticsearch

# 重启容器
docker restart elasticsearch

# 查看日志
docker logs -f elasticsearch

# 进入容器
docker exec -it elasticsearch /bin/bash

# 查看资源使用
docker stats elasticsearch

Elasticsearch 基本操作

bash

# 检查集群健康状态
curl -X GET "localhost:9200/_cluster/health?pretty"

# 查看节点信息
curl -X GET "localhost:9200/_cat/nodes?v"

# 查看索引
curl -X GET "localhost:9200/_cat/indices?v"

# 创建索引
curl -X PUT "localhost:9200/my-index?pretty"

# 插入文档
curl -X POST "localhost:9200/my-index/_doc" \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "测试文档",
    "content": "这是一个测试文档的内容",
    "timestamp": "2023-01-01"
  }'

# 搜索文档
curl -X GET "localhost:9200/my-index/_search?q=测试&pretty"

备份和恢复

bash

# 创建快照仓库
curl -X PUT "localhost:9200/_snapshot/my_backup" \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "fs",
    "settings": {
      "location": "/usr/share/elasticsearch/backups"
    }
  }'

# 创建快照
curl -X PUT "localhost:9200/_snapshot/my_backup/snapshot_1?wait_for_completion=true"

# 恢复快照
curl -X POST "localhost:9200/_snapshot/my_backup/snapshot_1/_restore"

性能优化

JVM 内存设置

bash

docker run -d --name elasticsearch \
  -p 9200:9200 -p 9300:9300 \
  -e "discovery.type=single-node" \
  -e "ES_JAVA_OPTS=-Xms4g -Xmx4g" \
  -e "bootstrap.memory_lock=true" \
  --ulimit memlock=-1:-1 \
  docker.elastic.co/elasticsearch/elasticsearch:8.11.0

生产环境配置

yaml

# elasticsearch.yml 生产配置
cluster.name: production-cluster
node.name: ${HOSTNAME}
network.host: 0.0.0.0
http.port: 9200

# 发现设置
discovery.seed_hosts: []
discovery.type: single-node

# 内存设置
bootstrap.memory_lock: true

# 网关设置
gateway.recover_after_nodes: 1

# 各种超时设置
action.destructive_requires_name: true

# 安全设置
xpack.security.enabled: true
xpack.security.transport.ssl.enabled: true

故障排查

常见问题解决

1. 内存不足

bash

# 查看系统内存
free -h

# 调整 JVM 内存
-e "ES_JAVA_OPTS=-Xms2g -Xmx2g"

2. 权限问题

bash

# 修复数据目录权限
chown -R 1000:1000 /docker/elasticsearch/data
chmod -R 755 /docker/elasticsearch/data

3. 启动失败

bash

# 查看详细日志
docker logs elasticsearch

# 检查系统资源
docker system df
docker system prune  # 清理无用资源

4. 连接被拒绝

bash

# 检查端口是否开放
netstat -tulpn | grep 9200

# 检查防火墙设置
sudo ufw status

健康检查

bash

# 健康状态API
curl -X GET "localhost:9200/_cluster/health?pretty"

# 节点状态
curl -X GET "localhost:9200/_cat/health?v"

# 磁盘使用情况
curl -X GET "localhost:9200/_cat/allocation?v"

监控和维护

使用 Elasticsearch API 监控

bash

# 集群状态
curl -s "localhost:9200/_cluster/stats?pretty" | jq .

# 节点状态
curl -s "localhost:9200/_nodes/stats?pretty" | jq .

# 索引状态
curl -s "localhost:9200/_stats?pretty" | jq .

定期维护任务

bash

# 清理旧索引（保留最近30天）
curl -X DELETE "localhost:9200/logstash-$(date -d '30 days ago' +%Y.%m.%d)"

# 优化索引
curl -X POST "localhost:9200/my-index/_forcemerge?max_num_segments=1"

# 刷新索引
curl -X POST "localhost:9200/my-index/_refresh"

总结

通过 Docker 部署 Elasticsearch 提供了便捷的部署和管理方式。本文涵盖了从基础安装到生产环境配置的完整流程，包括：

  • ✅ 单节点和集群部署

  • ✅ 数据持久化配置

  • ✅ 安全设置

  • ✅ 性能优化

  • ✅ 监控维护

  • ✅ 故障排查

使用 Docker 部署 Elasticsearch 可以快速搭建搜索和分析平台，为应用程序提供强大的全文搜索能力。记得在生产环境中要特别注意安全配置、数据备份和性能监控。

Docker安装部署ElasticSearch
时代各有不同，青春一脉相承。
04-03 1733
部署单点ElasticSearch因为我们还需要部署kibana容器，因此需要让ElasticSearch和kibana容器互联。考虑到ElasticSearch的兼容性，这里ElasticSearch、kibana统一下载8.6.2版本。# 拉取镜像 docker pull elasticsearch:8.6.2 docker pull kibana:8.6.2
ES(Elasticsearch)的docker安装部署教程
qq_33034733的博客
05-24 1万+
需要手动将docker中的es四个目录同步到宿主机上。1.1 拉取docker镜像。1.2 创建es挂载目录。1.4 桥接网络节点配置。3、logstash部署。1.3 开放防火墙端口。1.5 容器实例启动。2、Kibana部署。
Docker部署Elasticsearch
学而不思则忘
12-20 2622
1. 下载镜像 docker pull elasticsearch:7.16.1 2. 创建容器挂载目录并授权，持久化容器数据和配置 mkdir -p /elasticsearch/data mkdir -p /elasticsearch/config mkdir -p /elasticsearch/plugins 授予读写权限 chmod -R 777 /elasticsearch 3. 运行下面命令启动 #配置es可以被远程的任何机器访问 --可根据实际业务需求进行设定 echo "http.ho
docker安装elasticsearch（最详细版）
热门推荐
bright的博客
12-23 9万+
docker安装elasticsearch 1.设置max_map_count不能启动es会启动不起来 查看max_map_count的值 默认是65530 cat /proc/sys/vm/max_map_count 重新设置max_map_count的值 sysctl -w vm.max_map_count=262144 2.下载镜像并运行 #拉取镜像 docker pull elasticsearch:6.5.4 #启动镜像 docker run --name elasticsearch -d
Docker安装Elasticsearch超详细图文
普通人一枚
03-09 6752
Docker安装Elasticsearch超详细图文
初识ES-安装kibana
Leon_Jinhai_Sun的博客
11-14 1176
部署kibana kibana可以给我们提供一个elasticsearch的可视化界面，便于我们学习。 部署 运行docker命令，部署kibana docker run -d \ --name kibana \ -e ELASTICSEARCH_HOSTS=http://es:9200 \ --network=es-net \ -p 5601:5601 \ kibana:7.12.1 --network es-net ：加入一个名为es-net的网络中，与elasticsearch在同一
基于Docker安装Elasticsearch【保姆级教程、内含图解】
Acloasia的博客
05-15 4万+
【摘自百度百科】Elasticsearch 是一个分布式、高扩展、高实时的搜索与数据分析引擎。它能很方便的使大量数据具有搜索、分析和探索的能力。充分利用Elasticsearch的水平伸缩性，能使数据在生产环境变得更有价值。Elasticsearch 的实现原理主要分为以下几个步骤，首先用户将数据提交到Elasticsearch 数据库中，再通过分词控制器去将对应的语句分词，将其权重和分词结果一并存入数据，当用户搜索数据时候，再根据权重将结果排名，打分，再将返回结果呈现给用户。
Docker安装Elasticsearch及相关插件详细步骤，全程亲测避坑
secretdaixin的博客
12-06 7230
docker部署Elasticsearch、kibana、analysis-ik、elasticsearch-head、ingest-attachment 解决elasticsearch安装报错：default discovery settings are unsuitablefor production use，访问报错：Empty reply from server 解决kibana访问报错：server is not read yet 解决elasticsearch-head连接失败、访问报错406
Docker 安装 Elasticsearch 教程
最新发布
shitou的博客
04-02 6654
通过以上步骤，你可以在 Docker 上成功安装 Elasticsearch，并配置常用的网络、数据挂载和插件安装。掌握这些常用命令，可以帮助你更高效地管理和使用 Elasticsearch 集群。如果在使用过程中遇到任何问题，可以参考Elasticsearch 官方文档或社区寻求帮助。
Docker部署Elasticsearch（包含win10环境部署）
ywj_csdn的博客
12-02 3473
kibana中提供了一个DevTools界面，地址：http://localhost:5601/app/dev_tools#/console，如下：这个界面中可以编写DSL来操作elasticsearch。并且对DSL语句有自动补全功能。
Elasticsearch + Docker：实现容器化部署指南
IT成长日记的博客
03-22 1829
通过以上步骤，我们就完成了使用Docker快速部署Elasticsearch单节点操作。使用容器化部署不仅简化了环境配置，还提高了系统的可维护性和扩展性。
【Docker容器】Docker安装ElasticSearch详细步骤(看这一篇就够啦！)
分享记录开发中的问题，欢迎一起探讨！
05-25 4116
帮助有些小伙伴能快速学习的语法命令不至于在安装的时候卡住或者放弃，只要按照下面的安装步骤就可以快速启动一个es进行学习啦，话不多说直接开搞。
Docker安装Elasticsearch详细步骤
m0_51431003的博客
04-09 2864
如果大家完全按照我的步骤执行是不会遇到这些错误的，但是怕大家漏掉步骤出错，找不到原因，所以还是将这两个比较常见的错误总结以西，具体原因就不再赘述，感兴趣的话，大家可以自己去查阅相关文章。创建时挂载目录时，将 elasticsearch.yml 创建成了目录（应该是文件），导致容器启动失败。使用 IP:9200 进行服务访问，如果出现如下界面，则配置成功。使用 IP:5601 进行服务访问，如果出现如下界面，则配置成功。下载对应版本即可，我下载的是7.12.1。
docker安装elasticsearch
博客
08-10 4579
学过docker的小伙伴们，都知道用docker-compose也可以将es和kinbana容器互联，这里不用是因为，可能后续小伙伴们只需要用到es不需要kibana，所以这样便于改造。在互联网项目中，在网络传输的速度很快，所以很多语言是不允许在网络上传递的，如关于宗教、政治等敏感话题，同时一些语气助词也可以忽略，那么我们在搜索时也应该忽略当前词汇。出现了很多新的词语，在原有的词汇列表中并不词在。上面的这个GET指的是GET请求，_search指的是搜索功能，下面的就是DSL语句，表示查询所有的数据。
Docker 部署 ElasticSearch (图文并茂超详细)
人生需要动态规划 学习需要贪心算法
09-06 1645
使用 Docker 部署 ElasticSearch 是一种高效、灵活的方式，特别适合快速启动和管理分布式搜索引擎服务。首先，从 Docker Hub 拉取 ElasticSearch 的官方镜像。然后，通过命令行启动容器，可以配置内存限制、集群名称、节点角色等参数。ElasticSearch 运行在 Docker 提供的隔离环境中，与主机系统独立，减少了依赖冲突的风险。为了确保数据的持久性，可以将 ElasticSearch 的数据目录挂载到主机文件系统中，避免因容器重启或删除而丢失数据。
docker elasticsearch容器部署
kcy5856的博客
06-22 900
e ES_JAVA_OPTS="-Xms256m -Xmx256m" \ 测试环境下，设置ES的初始内存和最大内存，否则导致过大启动不了ES。plugins是es的插件，如ik，而数据挂载需要权限，需要设置data文件的权限为可读可写,需要下边的指令。集群部署需要为每个es节点容器配置单独的目录，每个容器使用自己的elasticsearch.yml。-e "discovery.type=single-node" 设置为单节点。http://自己的IP地址:5601/app/kibana。
五分钟搞定Docker安装ElasticSearch
咔咔博客
08-30 2万+
使用Docker安装es遇到的所有问题前言一、Docker 安装二、安装ElasticSearch三、安装ElasticSearch-Head 前言 公司项目准备上es，公司用什么就学什么，那么就开启es之旅。对于es的介绍就不聊了，自行百度哈！ 之前也写过关于es的零星文章，这次准备出全系列文章，会跟MySQL系列文章交叉发布。 一、Docker 安装 目前咔咔对Docker的理解还只是个皮毛，对于不了解的东西就要多多使用，使用的多了自然而然也就会了。 二、安装ElasticSearch 使用docker
Elasticsearch 7.12.1 Docker 安装及IK插件配置指南
资源摘要信息: "Elasticsearch 7.12.1 Docker 安装指南及插件配置" Elasticsearch 是一个基于 Apache Lucene 构建的开源搜索引擎。它提供了全文搜索功能，并具备近实时的搜索能力。它常常与其他组件一起被用作ELK ...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

移动端开发者

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值