351537865/elasticsearch

Elasticsearch 镜像文档

镜像概述

该镜像基于Elasticsearch构建，预集成IK中文分词插件、拼音分词插件，并已开启X-Pack安全功能，可直接用于需要中文全文检索及安全认证的单节点Elasticsearch部署。

核心功能与特性

• IK分词支持：集成IK中文分词插件，提供精准的中文分词能力，支持自定义词典
• 拼音分词支持：集成拼音分词插件，支持基于拼音的检索功能
• X-Pack安全功能：默认开启X-Pack安全模块，提供用户认证、权限控制等安全特性

使用场景

• 中文网站全文检索系统
• 需要拼音检索功能的应用（如人名、地名搜索）
• 对安全认证有要求的Elasticsearch单节点部署环境

使用方法与配置说明

1. 部署容器

使用以下命令启动Elasticsearch容器：

bash
docker run -d \
  --name=elasticsearch \
  --restart=always \
  -p 9200:9200 \  # HTTP API端口
  -p 9300:9300 \  # 节点间通信端口
  -e "discovery.type=single-node" \  # 单节点模式
  351537865/elasticsearch:v3

2. 处理初始密码问题

容器启动后，默认elastic用户密码可能无法直接使用，需通过以下步骤重置密码：

2.1 进入容器

bash
docker exec -it elasticsearch /bin/bash

2.2 创建超级管理员用户

bash
bin/elasticsearch-users useradd <超级管理员用户名> -p <超级管理员密码> -r superuser

替换<超级管理员用户名>和<超级管理员密码>为自定义值

2.3 修改elastic用户密码

使用创建的超级管理员身份执行密码修改命令：

bash
curl -u <超级管理员用户名> -XPUT 'http://localhost:9200/_xpack/security/user/elastic/_password?pretty' \
  -H 'Content-Type: application/json' \
  -d'
{
  "password" : "<elastic用户的密码>"
}'

替换<超级管理员用户名>和<elastic用户的密码>为实际值

3. 验证访问

打开浏览器访问 http://localhost:9200，使用以下凭据登录：

• 用户名：elastic
• 密码：<elastic用户的密码>（步骤2.3中设置的值）

4. 清理临时超级管理员

验证登录成功后，删除临时创建的超级管理员以提升安全性：

bash
bin/elasticsearch-users userdel <超级管理员用户名>

注意事项

• 该镜像适用于单节点部署，生产环境建议使用集群模式
• 首次启动可能需要几分钟时间初始化插件和安全配置
• 确保主机有足够的内存资源（建议至少4GB）以保证Elasticsearch正常运行