wodby/solr

Solr Docker 镜像文档

一、镜像概述和主要用途

Solr 是一款基于 Apache Lucene™ 构建的流行、高性能开源企业级搜索平台。本 Docker 镜像封装了 Solr 服务，提供开箱即用的部署方案，适用于快速搭建搜索服务、索引管理及数据检索场景。镜像旨在简化 Solr 的部署流程，支持灵活配置和扩展，满足不同规模的企业搜索需求。

二、核心功能和特性

• 全文搜索能力：基于 Lucene 实现高效的全文检索，支持分词、拼写纠错、同义词扩展等高级搜索特性。
• 分布式部署：支持 SolrCloud 模式，可通过 ZooKeeper 实现集群管理、分片和副本机制，保障高可用。
• 实时索引：支持近实时索引更新，数据写入后可快速被检索。
• 丰富的查询语法：支持 Lucene 查询语法、JSON 查询 DSL、过滤查询（fq）、排序、分组统计（facet）等。
• REST API 接口：提供完整的 HTTP REST API，方便集成到各类应用系统。
• 可扩展性：支持自定义插件、分词器、索引字段类型，适配业务需求。
• 多语言支持：内置多种语言分词器，支持中文、英文、日文等多语言文本处理。
• 安全功能：支持 Basic Auth、SSL/TLS 加密、IP 访问控制等安全机制。
• 监控与管理：内置管理界面（Solr Admin UI），支持索引监控、性能分析、配置管理等操作。

三、使用场景和适用范围

适用场景

• 企业网站/门户的站内搜索（如产品文档、帮助中心检索）。
• 电商平台的商品搜索（支持按价格、分类、评分等多维度筛选）。
• 内容管理系统（CMS）的内容检索（如新闻、文章、文档搜索）。
• 日志/数据日志分析（结构化/非结构化日志的检索与统计）。
• 数据挖掘与分析（对大规模数据进行关键词提取和趋势分析）。

适用范围

• 中小企业：快速部署单节点 Solr 服务，满足基础搜索需求。
• 大型企业：通过 SolrCloud 模式搭建分布式集群，支撑高并发、海量数据检索。

四、详细的使用方法和配置说明

4.1 镜像获取

从 Docker Hub 拉取官方维护的 Solr 镜像（基于 https://github.com/wodby/solr 仓库）：

bash
docker pull wodby/solr:latest  # 拉取最新版本，建议指定具体版本号（如 9.4.0）以避免兼容性问题

4.2 基本使用示例

4.2.1 单节点快速启动（docker run）

通过 docker run 命令启动单节点 Solr 服务，默认创建一个核心（core）并暴露 Web 管理界面：

bash
docker run -d \
  --name solr \
  -p 8983:8983 \  # 映射 Solr 默认端口（8983）到主机
  -e SOLR_CORE=mycore \  # 指定初始化核心名称（首次启动时自动创建）
  -v solr-data:/var/solr/data \  # 挂载数据卷持久化索引数据
  wodby/solr:latest

启动后，通过 http://localhost:8983 访问 Solr Admin UI，核心 mycore 已自动创建。

4.2.2 docker-compose 配置示例（推荐生产环境）

使用 docker-compose.yml 配置更复杂的部署（如指定堆大小、日志级别、持久化路径等）：

yaml
version: '3.8'

services:
  solr:
    image: wodby/solr:9.4.0  # 指定具体版本
    container_name: solr
    restart: always  # 服务异常时自动重启
    ports:
      - "8983:8983"  # 管理界面及 API 端口
    volumes:
      - ./solr-data:/var/solr/data  # 本地目录挂载，持久化索引数据
      - ./solr-config:/opt/solr/server/solr/configsets  # 挂载自定义配置集（可选）
    environment:
      - SOLR_CORE=mycore  # 初始化核心名称
      - SOLR_HEAP_SIZE=2g  # JVM 堆大小（根据服务器资源调整，建议为物理内存的 50%）
      - SOLR_LOG_LEVEL=INFO  # 日志级别（DEBUG/INFO/WARN/ERROR）
      - SOLR_JAVA_MEM="-Xms2g -Xmx2g"  # 自定义 JVM 内存参数（覆盖 SOLR_HEAP_SIZE）
      - SOLR_PORT=8983  # 容器内服务端口（默认 8983，一般无需修改）
    networks:
      - solr-network  # 自定义网络隔离

networks:
  solr-network:
    driver: bridge

volumes:
  solr-data:  # 若使用命名卷，需提前创建：docker volume create solr-data

启动命令：

bash
docker-compose up -d  # 后台启动服务
docker-compose logs -f  # 查看实时日志

4.3 核心配置与管理

4.3.1 创建/删除核心

除启动时通过 SOLR_CORE 自动创建核心外，也可通过 Solr Admin UI 或命令行手动管理：

• 命令行创建核心（进入容器执行）：

  bash
  docker exec -it solr solr create_core -c newcore -d basic_configs  # 使用默认配置集创建核心 newcore
  

• 命令行删除核心：

  bash
  docker exec -it solr solr delete_core -c newcore
  

4.3.2 自定义索引配置

如需修改索引字段（如分词器、字段类型），可挂载自定义配置集（configsets）：

1. 本地创建配置集目录（如 ./solr-config/myconfig），包含 solrconfig.xml（索引配置）和 schema.xml（字段定义）；
2. 在 docker-compose.yml 中挂载该目录到容器内的 /opt/solr/server/solr/configsets：

   yaml
   volumes:
     - ./solr-config:/opt/solr/server/solr/configsets
   

3. 创建核心时指定自定义配置集：

   bash
   docker exec -it solr solr create_core -c mycore -d /opt/solr/server/solr/configsets/myconfig
   

4.4 环境变量说明

4.5 数据持久化

Solr 的索引数据默认存储在容器内的 /var/solr/data 目录，为避免容器重启后数据丢失，需通过数据卷挂载持久化该目录：

• 使用命名卷（推荐生产环境）：

  yaml
  volumes:
    - solr-data:/var/solr/data  # 命名卷由 Docker 管理，路径在 `/var/lib/docker/volumes/`
  

• 使用本地目录挂载（开发/测试环境）：

  yaml
  volumes:
    - ./solr-data:/var/solr/data  # 本地目录需确保权限正确（如 `chmod 777 ./solr-data`）
  

4.6 安全配置

4.6.1 启用 Basic Auth

生产环境需启用认证以保护管理界面和 API，通过环境变量配置：

yaml
environment:
  - SOLR_AUTH_TYPE=basic
  - SOLR_AUTH_USER=admin
  - SOLR_AUTH_PASSWORD=SecurePassword123!

访问时需通过 http://admin:SecurePassword123!@localhost:8983 认证。

4.6.2 网络隔离

通过 Docker 网络限制 Solr 服务仅允许内部应用访问，避免直接暴露公网：

yaml
networks:
  - backend-network  # 与应用服务共享同一网络，不暴露 8983 端口到主机

五、注意事项

1. 版本选择：生产环境建议指定具体版本标签（如 wodby/solr:9.4.0），避免 latest 标签自动更新导致兼容性问题。
2. 资源配置：根据数据量和查询并发调整 SOLR_HEAP_SIZE（建议不超过物理内存的 50%），并配置 CPU 限制（如 cpus: 2）。
3. 数据备份：定期备份 /var/solr/data 目录（如通过 docker exec solr tar -czf /backup/solr-data-$(date +%F).tar.gz /var/solr/data）。
4. 监控集成：可通过 Prometheus + Grafana 监控 Solr 指标（需启用 Solr 的 Metrics 功能）。

六、参考链接

• 官方仓库：https://github.com/wodby/solr%EF%BC%88%E9%95%9C%E5%83%8F%E9%85%8D%E7%BD%AE%E5%8F%8A%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97%EF%BC%89
• Solr 官方文档：Apache Solr Documentation（核心功能及高级配置）
• Docker Hub 镜像：https://hub.docker.com/r/wodby/solr%EF%BC%88%E9%95%9C%E5%83%8F%E7%89%88%E6%9C%AC%E5%8F%8A%E6%A0%87%E7%AD%BE%E8%AF%B4%E6%98%8E%EF%BC%89