streamlinehq/elasticsearch

自定义ElasticSearch镜像（含同义词文件）

镜像概述

本镜像基于官方ElasticSearch构建，预先集成同义词文件，旨在简化ElasticSearch同义词功能的配置流程，提升搜索结果对同义词的识别与匹配能力。适用于需要增强文本搜索相关性的场景，无需手动配置同义词文件即可直接使用。

核心功能与特性

• 预配置同义词文件：内置常用同义词词典，开箱即可使用同义词搜索功能
• 版本兼容性：与官方ElasticSearch对应版本保持兼容，支持标准ElasticSearch功能
• 灵活扩展：支持通过挂载外部文件自定义同义词词典，满足特定业务需求
• 简化部署：集成同义词配置，减少手动配置步骤，降低使用门槛

使用场景

• 电商平台商品搜索：支持"手机"与"智能手机"、"电脑"与"计算机"等同义词匹配
• 内容管理系统：实现文章、文档中同义词的检索优化
• 企业内部搜索：提升知识库、文档库中同义词搜索的准确性
• 任何需要增强文本搜索相关性的ElasticSearch应用场景

使用方法

基本使用（Docker Run）

bash
docker run -d \
  --name es-synonyms \
  -p 9200:9200 \
  -p 9300:9300 \
  -e "discovery.type=single-node" \
  -v /path/to/custom-synonyms.txt:/usr/share/elasticsearch/config/synonyms.txt \
  your-image-name:tag

Docker Compose配置

yaml
version: '3'
services:
  elasticsearch:
    image: your-image-name:tag
    container_name: es-synonyms
    ports:
      - "9200:9200"
      - "9300:9300"
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    volumes:
      - ./synonyms.txt:/usr/share/elasticsearch/config/synonyms.txt
      - es-data:/usr/share/elasticsearch/data
    restart: unless-stopped

volumes:
  es-data:

配置说明

环境变量

• discovery.type=single-node：单节点模式，适用于开发和测试环境
• ES_JAVA_OPTS：Java虚拟机参数，建议根据服务器配置调整（如-Xms1g -Xmx1g）

同义词文件

• 默认路径：/usr/share/elasticsearch/config/synonyms.txt
• 文件格式：每行一个同义词组，用逗号分隔，例如：手机,智能手机,移动电话
• 自定义方法：通过-v参数挂载本地同义词文件到默认路径

验证同义词配置

1. 启动容器后，通过ElasticSearch API创建包含同义词过滤器的索引：

bash
curl -X PUT "http://localhost:9200/test-index" -H "Content-Type: application/json" -d '{
  "settings": {
    "analysis": {
      "analyzer": {
        "synonym_analyzer": {
          "type": "custom",
          "tokenizer": "standard",
          "filter": ["lowercase", "synonym"]
        }
      },
      "filter": {
        "synonym": {
          "type": "synonym",
          "synonyms_path": "synonyms.txt"
        }
      }
    }
  }
}'

2. 测试同义词分析效果：

bash
curl -X GET "http://localhost:9200/test-index/_analyze" -H "Content-Type: application/json" -d '{
  "analyzer": "synonym_analyzer",
  "text": "我需要一部智能手机"
}'

3. 响应应包含"手机"、"智能手机"、"移动电话"等同义词 token，验证配置生效。