网站开发后端作用宁波网站seo诊断工具

---

前言

在现代应用架构中，Elasticsearch 是一款强大的分布式搜索引擎，广泛应用于日志分析、实时搜索、数据可视化等场景。通过 Docker 部署 Elasticsearch，可以快速搭建、灵活扩展，并与容器化平台无缝集成。

本文将详细介绍如何使用 Docker 安装和配置 Elasticsearch 8.x，包括目录结构设置、配置文件管理、容器启动与管理、端口配置、日志查看、服务访问等内容，帮助你快速搭建一个高效、可维护的 Elasticsearch 环境。

---

一、准备工作

首先，确保你的系统上已经安装了 Docker。

Linux上进行Docker安装有两种方式：

1. Docker自动化安装
2. Docker手动安装

可以根据该文章的步骤进行安装：https://blog.csdn.net/weixin_44876263/article/details/136714078?spm=1001.2014.3001.5502

二、设置容器的目录结构

为了持久化存储日志、数据、配置和插件，需要在宿主机上创建对应目录，并赋予 Elasticsearch 容器内部用户的写权限。

# 安装路径
DIR="/opt/docker/demo"
DOCKER_NAME="docker-elasticsearch"# 创建目录结构
mkdir -p "$DIR/elasticsearch/logs"
mkdir -p "$DIR/elasticsearch/data"
mkdir -p "$DIR/elasticsearch/config"
mkdir -p "$DIR/elasticsearch/plugins"# 赋予文件权限
chmod -R 777 $DIR/elasticsearch/

三、启动一个临时的容器来复制配置文件

启动一个临时的 Elasticsearch 容器，用于复制默认配置文件到宿主机。

docker run -d \--restart=always \--name elasticsearch \--network host \-p 9388:9200 \-p 9389:9300 \--privileged \-e "discovery.type=single-node" \-e "ES_JAVA_OPTS=-Xms2g -Xmx2g" \docker.elastic.co/elasticsearch/elasticsearch:8.17.0

四、复制配置文件到本地目录

将容器中的配置文件复制到宿主机的对应目录。

docker cp elasticsearch:/usr/share/elasticsearch/data $DIR/elasticsearch/
docker cp elasticsearch:/usr/share/elasticsearch/plugins $DIR/elasticsearch/
docker cp elasticsearch:/usr/share/elasticsearch/config $DIR/elasticsearch/
docker cp elasticsearch:/usr/share/elasticsearch/logs $DIR/elasticsearch/

五、删除临时容器

docker stop elasticsearch
docker rm elasticsearch

六、创建并运行容器，挂载本地目录

使用以下命令启动 Elasticsearch 容器，并挂载本地目录。

docker run -d \--name "$DOCKER_NAME" \--restart=always \--network host \-v "$DIR/elasticsearch/data:/usr/share/elasticsearch/data" \-v "$DIR/elasticsearch/plugins:/usr/share/elasticsearch/plugins" \-v "$DIR/elasticsearch/config:/usr/share/elasticsearch/config" \-v "$DIR/elasticsearch/logs:/usr/share/elasticsearch/logs" \-e "discovery.type=single-node" \-e "ES_JAVA_OPTS=-Xms2g -Xmx2g" \-e "ELASTIC_PASSWORD=123456" \docker.elastic.co/elasticsearch/elasticsearch:8.17.0

七、修改文件配置监听端口

修改配置文件 $DIR/elasticsearch/config/elasticsearch.yml

cluster.name: "docker-cluster"network.host: 0.0.0.0http.port: 9200

八、端口配置：Host 网络模式 vs Port 映射模式

1. Host 网络模式

docker run -d \--restart=always \--name "$DOCKER_NAME" \--network host \-v "$DIR/elasticsearch/data:/usr/share/elasticsearch/data" \-v "$DIR/elasticsearch/plugins:/usr/share/elasticsearch/plugins" \-v "$DIR/elasticsearch/config:/usr/share/elasticsearch/config" \-v "$DIR/elasticsearch/logs:/usr/share/elasticsearch/logs" \-e "discovery.type=single-node" \-e "ES_JAVA_OPTS=-Xms2g -Xmx2g" \-e "ELASTIC_PASSWORD=123456" \docker.elastic.co/elasticsearch/elasticsearch:8.17.0

• 特点：

  在 Host 网络模式下，容器共享宿主机的网络栈，容器内的网络接口直接映射到宿主机的网络接口。​这意味着容器可以使用宿主机的 IP 地址和端口进行通信。​对于 Elasticsearch 来说，使用 Host 网络模式可以减少网络延迟，提高性能。

• 优点：

  • 简化网络配置，无需额外的 -p 端口映射。

  • 延迟更低，吞吐更高。

• 缺点：

  • 与宿主机完全共享端口，若宿主机已有同端口服务运行，会冲突。

  • 安全隔离较弱，容器网络直接暴露给宿主机。

2. Port 映射模式

docker run -d \--restart=always \--name "$DOCKER_NAME" \-p 9201:9200 \-p 9301:9300 \-v "$DIR/elasticsearch/data:/usr/share/elasticsearch/data" \-v "$DIR/elasticsearch/plugins:/usr/share/elasticsearch/plugins" \-v "$DIR/elasticsearch/config:/usr/share/elasticsearch/config" \-v "$DIR/elasticsearch/logs:/usr/share/elasticsearch/logs" \-e "discovery.type=single-node" \-e "ES_JAVA_OPTS=-Xms2g -Xmx2g" \-e "ELASTIC_PASSWORD=123456" \docker.elastic.co/elasticsearch/elasticsearch:8.17.0

• 特点：

  在 Port 映射模式下，容器使用 Docker 的默认桥接网络，容器内的端口通过宿主机的端口进行映射。​这种方式适用于需要将容器服务暴露给外部访问的场景。​例如，将容器的 9200 端口映射到宿主机的 9201 端口。

• 优点：

  • 容器与宿主机网络隔离，提高安全性。

  • 可以在同一宿主机上运行多个容器，避免端口冲突。

• 缺点：

  • 可能增加网络延迟，影响性能。

  • 需要手动配置端口映射，增加配置复杂度。

九、查看日志和检查容器状态

使用以下命令查看 Elasticsearch 容器的日志：

docker logs -f "$DOCKER_NAME"

要查看容器的状态，可以使用：

docker ps -a

如果容器未运行，可以使用以下命令启动：

docker start "$DOCKER_NAME"

十、访问服务

在浏览器中访问以下地址，检查 Elasticsearch 是否正常运行
默认的用户名为：elastic
密码：123456

http://localhost:9200

如果使用了 Port 映射模式，并将容器的 9200 端口映射到宿主机的 9201 端口，则应访问：

http://localhost:9201

应该看到类似以下的 JSON 响应：

{"name" : "docker-cluster","cluster_name" : "docker-cluster","cluster_uuid" : "abcdefghijklmno","version" : {"number" : "8.17.0","build_flavor" : "default","build_type" : "deb","build_hash" : "1234567890abcdef","build_date" : "2025-04-15T12:34:56.789Z","build_snapshot" : false,"lucene_version" : "8.10.0","minimum_wire_compatibility_version" : "7.10.0","minimum_index_compatibility_version" : "7.10.0"},"tagline" : "You Know, for Search"
}

十一、Elasticsearch 常用操作命令

1. 检查集群健康状态

   使用以下命令检查 Elasticsearch 集群的健康状态：

   curl -X GET "localhost:9200/_cluster/health?pretty"
   

2. 查看所有索引

   使用以下命令检查 Elasticsearch 集群的健康状态：

   curl -X GET "localhost:9200/_cat/indices?v"
   

3. 创建索引

   使用以下命令创建一个新的索引：

   curl -X PUT "localhost:9200/my_index"
   

4. 删除索引

   使用以下命令删除指定的索引：

   curl -X DELETE "localhost:9200/my_index"
   

5. 查询索引中的所有文档

   使用以下命令查询索引中的所有文档：

   curl -X GET "localhost:9200/my_index/_search?q=*:*
   

6. 修改用户密码

   Elasticsearch 提供了 elasticsearch-reset-password 工具，用于重置用户密码。​例如，重置 elastic 用户的密码：

   docker exec -it elasticsearch bin/elasticsearch-reset-password -u elastic
   

   执行后，系统将提示输入新密码并确认。​请确保在生产环境中妥善保管密码。

7. 查看集群节点信息

   curl -X GET "localhost:9200/_cat/nodes?v"
   

8. 查看集群分片分配情况

   curl -X GET "localhost:9200/_cat/shards?v"
   

9. 查看集群所有分配情况

   curl -X GET "localhost:9200/_cat/allocation?v"
   

10. 查看索引文档数量

    curl -X GET "localhost:9200/my_index/_count"