使用 Docker 安装 Elasticsearch

要删除容器及其网络，请运行

# Remove the Elastic network
docker network rm elastic

# Remove Elasticsearch containers
docker rm es01
docker rm es02

# Remove the Kibana container
docker rm kib01

您现在已经设置了测试 Elasticsearch 环境。在开始正式开发或在生产环境中使用 Elasticsearch 之前，请查看在生产环境中使用 Docker 运行 Elasticsearch 时适用的 要求和建议。

要停止集群，请运行 docker-compose down。Docker 卷中的数据会保留并在您使用 docker-compose up 重新启动集群时加载。

docker-compose down

要删除网络、容器和卷，请在停止集群时指定 -v 选项

docker-compose down -v

您现在已经设置了测试 Elasticsearch 环境。在开始正式开发或在生产环境中使用 Elasticsearch 之前，请查看在生产环境中使用 Docker 运行 Elasticsearch 时适用的 要求和建议。

在生产环境中使用时，必须将 vm.max_map_count 内核设置设置为至少 262144。

设置 vm.max_map_count 的方法取决于您的平台。

grep vm.max_map_count /etc/sysctl.conf
vm.max_map_count=262144

sysctl -w vm.max_map_count=262144

docker-machine ssh
sudo sysctl -w vm.max_map_count=262144

wsl -d docker-desktop -u root
sysctl -w vm.max_map_count=262144

[wsl2]
kernelCommandLine = "sysctl.vm.max_map_count=262144"

wsl -d docker-desktop -u root
vi /etc/sysctl.conf

vm.max_map_count = 262144

默认情况下，Elasticsearch 在容器内以用户 elasticsearch 身份运⾏，⽤户 ID 和组 ID 分别为 1000:0。

如果您要绑定挂载本地⽬录或⽂件，则该⽬录或⽂件必须可被 elasticsearch 用户读取。此外，该⽤户必须对 配置、数据和⽇志⽬录 具有写⼊权限（Elasticsearch 需要对 config ⽬录具有写⼊权限，以便它可以⽣成密钥库）。⼀个好的策略是授予本地⽬录的组 ID 为 0 的组访问权限。

例如，要准备⼀个本地⽬录，以便通过绑定挂载存储数据

mkdir esdatadir
chmod g+rwx esdatadir
chgrp 0 esdatadir

您还可以使⽤自定义的 UID 和 GID 运⾏ Elasticsearch 容器。您必须确保⽂件权限不会阻止 Elasticsearch 执⾏。您可以使⽤以下两种⽅法之⼀

必须为 Elasticsearch 容器提供增加的 nofile 和 nproc 的 ulimit。验证 Docker 守护进程的 init 系统 是否将其设置为可接受的值。

要检查 Docker 守护进程的 ulimit 默认值，请运⾏

docker run --rm docker.elastic.co/elasticsearch/elasticsearch:8.14.2 /bin/bash -c 'ulimit -Hn && ulimit -Sn && ulimit -Hu && ulimit -Su'

如果需要，请在守护进程中调整它们，或为每个容器覆盖它们。例如，当使⽤ docker run 时，请设置

--ulimit nofile=65535:65535

为了性能和节点稳定性，需要禁用交换。有关如何禁用的信息，请参阅 禁用交换。

如果您选择 bootstrap.memory_lock: true ⽅法，则还需要在 Docker 守护进程 中定义 memlock: true ulimit，或者如 示例组合⽂件 中所示，为容器显式设置。当使⽤ docker run 时，您可以指定

-e "bootstrap.memory_lock=true" --ulimit memlock=-1:-1

该镜像 公开 TCP 端口 9200 和 9300。对于⽣产集群，建议使⽤ --publish-all 随机化发布的端口，除非您为每个主机固定⼀个容器。

默认情况下，Elasticsearch 会根据节点的 角色 和节点容器可⽤的总内存⾃动调整 JVM 堆⼤⼩。我们建议在⼤多数⽣产环境中使⽤此默认⼤⼩。如果需要，您可以通过⼿动设置 JVM 堆⼤⼩来覆盖默认⼤⼩。

要在⽣产环境中⼿动设置堆⼤⼩，请在 /usr/share/elasticsearch/config/jvm.options.d 下绑定挂载⼀个包含您所需 堆⼤⼩ 设置的 JVM 选项 ⽂件。

为了测试，您还可以使⽤ ES_JAVA_OPTS 环境变量⼿动设置堆⼤⼩。例如，要使⽤ 1GB，请使⽤以下命令。

docker run -e ES_JAVA_OPTS="-Xms1g -Xmx1g" -e ENROLLMENT_TOKEN="<token>" --name es01 -p 9200:9200 --net elastic -it docker.elastic.co/elasticsearch/elasticsearch:8.14.2

ES_JAVA_OPTS 变量会覆盖所有其他 JVM 选项。我们不建议在⽣产环境中使⽤ ES_JAVA_OPTS。

将您的部署固定到 Elasticsearch Docker 镜像的特定版本。例如 docker.elastic.co/elasticsearch/elasticsearch:8.14.2。

您应该使⽤绑定到 /usr/share/elasticsearch/data 的卷，原因如下

如果您使⽤ devicemapper 存储驱动程序，请不要使⽤默认的 loop-lvm 模式。配置 docker-engine 以使⽤ direct-lvm。

考虑使⽤不同的 日志驱动程序 集中您的日志。另请注意，默认的 json-file 日志驱动程序不适合⽣产使⽤。

创建自定义配置⽂件，并将它们绑定挂载到 Docker 镜像中的对应⽂件上。例如，要使⽤ docker run 绑定挂载 custom_elasticsearch.yml，请指定

-v full_path_to/custom_elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml

如果您绑定挂载了自定义的 elasticsearch.yml ⽂件，请确保它包含 network.host: 0.0.0.0 设置。此设置确保节点可供 HTTP 和传输流量访问，前提是其端口已公开。Docker 镜像的内置 elasticsearch.yml ⽂件默认包含此设置。

默认情况下，Elasticsearch 会为 安全设置 ⾃动⽣成密钥库⽂件。此⽂件已混淆，但未加密。

要使⽤密码加密您的安全设置，并使其在容器外部持久化，请使⽤ docker run 命令⼿动创建密钥库。该命令必须

例如

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:8.14.2 \
bin/elasticsearch-keystore create -p

您还可以使⽤ docker run 命令在密钥库中添加或更新安全设置。系统将提示您输⼊设置值。如果密钥库已加密，系统还会提示您输⼊密钥库密码。

docker run -it --rm \
-v full_path_to/config:/usr/share/elasticsearch/config \
docker.elastic.co/elasticsearch/elasticsearch:8.14.2 \
bin/elasticsearch-keystore \
add my.secure.setting \
my.other.secure.setting

如果您已创建密钥库，并且不需要更新它，则可以将 elasticsearch.keystore ⽂件直接绑定挂载。您可以使⽤ KEYSTORE_PASSWORD 环境变量在启动时向容器提供密钥库密码。例如，docker run 命令可能具有以下选项

-v full_path_to/config/elasticsearch.keystore:/usr/share/elasticsearch/config/elasticsearch.keystore
-e KEYSTORE_PASSWORD=mypassword

在某些环境中，准备包含您配置的自定义镜像可能更有意义。一个 Dockerfile 来实现这一点可能很简单，例如

FROM docker.elastic.co/elasticsearch/elasticsearch:8.14.2
COPY --chown=elasticsearch:elasticsearch elasticsearch.yml /usr/share/elasticsearch/config/

然后，您可以使用以下命令构建并运行镜像：

docker build --tag=elasticsearch-custom .
docker run -ti -v /usr/share/elasticsearch/data elasticsearch-custom

某些插件需要额外的安全权限。您必须通过以下方式明确接受它们：

有关更多信息，请参阅 插件管理。

排查 Elasticsearch 的 Docker 错误编辑

以下是使用 Docker 运行 Elasticsearch 时解决常见错误的方法。

Exception in thread "main" org.elasticsearch.bootstrap.BootstrapException: java.io.IOException: Is a directory: SimpleFSIndexInput(path="/usr/share/elasticsearch/config/elasticsearch.keystore") Likely root cause: java.io.IOException: Is a directory

一个 与密钥库相关的 docker run 命令尝试直接绑定挂载一个不存在的 elasticsearch.keystore 文件。如果您使用 -v 或 --volume 标志挂载不存在的文件，Docker 反而会创建一个具有相同名称的目录。

要解决此错误，请执行以下操作：

Exception in thread "main" java.nio.file.FileSystemException: /usr/share/elasticsearch/config/elasticsearch.keystore.tmp -> /usr/share/elasticsearch/config/elasticsearch.keystore: Device or resource busy

一个 docker run 命令尝试 更新密钥库，同时直接绑定挂载 elasticsearch.keystore 文件。要更新密钥库，容器需要访问 config 目录中的其他文件，例如 keystore.tmp。

要解决此错误，请执行以下操作：