# 拉取指定版本（建議使用7.x或8.x穩(wěn)定版）
docker pull elasticsearch:7.17.20
# 驗(yàn)證鏡像
docker images | grep elasticsearch

# 創(chuàng)建數(shù)據(jù)、配置、插件、日志目錄
mkdir -p /opt/es/{data,config,plugins,logs}
# 設(shè)置權(quán)限（ES容器以u(píng)id:1000用戶運(yùn)行）
chown -R 1000:1000 /opt/es

cluster.name: "docker-cluster"
network.host: 0.0.0.0
http.port: 9200
discovery.type: single-node
xpack.security.enabled: false
http.cors.enabled: true
http.cors.allow-origin: "*"

docker run -d \
  --name elasticsearch \
  -p 9200:9200 \
  -p 9300:9300 \
  -e "discovery.type=single-node" \
  -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" \
  -v /opt/es/config/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml \
  -v /opt/es/data:/usr/share/elasticsearch/data \
  -v /opt/es/plugins:/usr/share/elasticsearch/plugins \
  -v /opt/es/logs:/usr/share/elasticsearch/logs \
  --restart=unless-stopped \
  elasticsearch:7.17.20

# 檢查容器狀態(tài)
docker ps | grep elasticsearch
# 測(cè)試ES服務(wù)
curl http://localhost:9200

{
  "name" : "node-1",
  "cluster_name" : "docker-cluster",
  "version" : { "number" : "7.17.20" }
}

# 進(jìn)入容器
docker exec -it elasticsearch /bin/bash
# 在線安裝IK（版本需與ES完全一致）
./bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.17.20/elasticsearch-analysis-ik-7.17.20.zip
# 退出并重啟
exit
docker restart elasticsearch

# 1. 下載對(duì)應(yīng)版本的IK插件包
cd /opt/es/plugins
wget https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v7.17.20/elasticsearch-analysis-ik-7.17.20.zip

# 2. 解壓到ik目錄
unzip elasticsearch-analysis-ik-7.17.20.zip -d ik
rm -f elasticsearch-analysis-ik-7.17.20.zip

# 3. 設(shè)置權(quán)限
chown -R 1000:1000 /opt/es/plugins/ik

# 4. 重啟容器
docker restart elasticsearch

FROM elasticsearch:7.17.20
COPY elasticsearch-analysis-ik-7.17.20.zip /tmp/
RUN ./bin/elasticsearch-plugin install -b file:///tmp/elasticsearch-analysis-ik-7.17.20.zip

docker build -t elasticsearch-with-ik:7.17.20 .
docker run -d --name elasticsearch -p 9200:9200 elasticsearch-with-ik:7.17.20

docker exec -it elasticsearch ./bin/elasticsearch-plugin list

curl -X POST "http://localhost:9200/_analyze" -H "Content-Type: application/json" -d'
{
  "analyzer": "ik_max_word",
  "text": "中華人民共和國(guó)國(guó)徽"
}'

{
  "tokens": [
    {"token": "中華人民共和國(guó)", "position": 0},
    {"token": "中華人民", "position": 1},
    {"token": "中華", "position": 2},
    {"token": "華人", "position": 3},
    {"token": "人民共和國(guó)", "position": 4},
    {"token": "人民", "position": 5},
    {"token": "共和國(guó)", "position": 6},
    {"token": "共和", "position": 7},
    {"token": "國(guó)", "position": 8},
    {"token": "國(guó)徽", "position": 9}
  ]
}

# 測(cè)試ik_smart（最少切分）
curl -X POST "http://localhost:9200/_analyze" -H "Content-Type: application/json" -d'
{
  "analyzer": "ik_smart",
  "text": "中華人民共和國(guó)國(guó)徽"
}'

# 查看插件目錄掛載位置
docker inspect elasticsearch | grep -A 10 "Mounts"

# 進(jìn)入容器
docker exec -it elasticsearch /bin/bash
# 編輯配置文件
vi /usr/share/elasticsearch/config/analysis-ik/IKAnalyzer.cfg.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
    <comment>IK Analyzer 擴(kuò)展配置</comment>
    <!-- 自定義擴(kuò)展詞典 -->
    <entry key="ext_dict">ext_dict.dic</entry>
    <!-- 自定義停用詞詞典 -->
    <entry key="ext_stopwords">stopword.dic</entry>
</properties>

# 進(jìn)入配置目錄
cd /usr/share/elasticsearch/config/analysis-ik/
# 創(chuàng)建擴(kuò)展詞典（每行一個(gè)詞）
echo "傳智播客" >> ext_dict.dic
echo "奧力給" >> ext_dict.dic
echo "人工智能" >> ext_dict.dic
# 創(chuàng)建停用詞詞典
echo "的" >> stopword.dic
echo "了" >> stopword.dic
echo "呢" >> stopword.dic
# 退出容器
exit
# 重啟ES
docker restart elasticsearch

# 1. 從容器復(fù)制默認(rèn)配置到宿主機(jī)
docker cp elasticsearch:/usr/share/elasticsearch/config/analysis-ik ./analysis-ik-config
# 2. 修改宿主機(jī)上的配置文件
vi ./analysis-ik-config/IKAnalyzer.cfg.xml
echo "自定義詞匯" >> ./analysis-ik-config/ext_dict.dic
# 3. 重新掛載啟動(dòng)（掛載配置目錄）
docker run -d \
  --name elasticsearch \
  -p 9200:9200 \
  -v /opt/es/config/elasticsearch.yml:/usr/share/elasticsearch/config/elasticsearch.yml \
  -v /opt/es/data:/usr/share/elasticsearch/data \
  -v /opt/es/plugins:/usr/share/elasticsearch/plugins \
  -v /opt/es/logs:/usr/share/elasticsearch/logs \
  -v $(pwd)/analysis-ik-config:/usr/share/elasticsearch/config/analysis-ik \
  elasticsearch:7.17.20

curl -X POST "http://localhost:9200/_analyze" -H "Content-Type: application/json" -d'
{
  "analyzer": "ik_max_word",
  "text": "傳智播客Java就業(yè)率超過(guò)95%,奧力給！"
}'

# 查看錯(cuò)誤日志
docker logs elasticsearch
# 常見(jiàn)原因：
# 1. IK版本與ES版本不匹配 → 重新下載匹配版本
# 2. 插件目錄權(quán)限不足 → chown -R 1000:1000 /opt/es/plugins
# 3. 內(nèi)存不足 → 調(diào)整ES_JAVA_OPTS=-Xms256m -Xmx256m

# 檢查插件是否安裝成功
docker exec -it elasticsearch ./bin/elasticsearch-plugin list

# 檢查文件編碼（必須是UTF-8，無(wú)BOM）
file -bi /opt/es/plugins/ik/config/*.dic

# 查看ES日志確認(rèn)詞典加載
docker logs elasticsearch 2>&1 | grep -i "dic"
# 預(yù)期輸出：
# [INFO] loading ext_dict.dic
# [INFO] loading stopword.dic