wodby/solr

自动构建

Solr是基于Apache Lucene构建的流行、极速开源企业搜索平台。

3 收藏0 次下载activewodby镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

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 镜像（基于 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）：

本地创建配置集目录（如 ./solr-config/myconfig），包含 solrconfig.xml（索引配置）和 schema.xml（字段定义）；

在 docker-compose.yml 中挂载该目录到容器内的 /opt/solr/server/solr/configsets：

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

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

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

4.4 环境变量说明

环境变量名	默认值	描述
`SOLR_CORE`	空	启动时自动创建的核心名称，若为空则需手动创建核心。
`SOLR_HEAP_SIZE`	`512m`	Solr JVM 堆大小（如 `2g`），优先级低于 `SOLR_JAVA_MEM`。
`SOLR_JAVA_MEM`	空	自定义 JVM 内存参数（如 `-Xms2g -Xmx2g`），覆盖 `SOLR_HEAP_SIZE`。
`SOLR_LOG_LEVEL`	`INFO`	日志级别，可选 `DEBUG`/`INFO`/`WARN`/`ERROR`。
`SOLR_PORT`	`8983`	容器内 Solr 服务端口，需与端口映射保持一致。
`SOLR_AUTH_TYPE`	空	认证类型，可选 `basic`（Basic Auth），启用需配合 `SOLR_AUTH_USER` 和 `SOLR_AUTH_PASSWORD`。
`SOLR_AUTH_USER`	空	Basic Auth 用户名（仅 `SOLR_AUTH_TYPE=basic` 时生效）。
`SOLR_AUTH_PASSWORD`	空	Basic Auth 密码（仅 `SOLR_AUTH_TYPE=basic` 时生效）。
`SOLR_ZK_HOST`	空	SolrCloud 模式下 ZooKeeper 集群地址（如 `zk1:2181,zk2:2181/solr`）。

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 端口到主机

五、注意事项

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