bitnami/solr

Bitnami Apache Solr 镜像

什么是 Apache Solr？

Apache Solr 是一个基于 Apache Lucene 构建的极其强大的开源企业搜索平台。它高度可靠、灵活、可扩展，旨在部署后快速带来价值。

Apache Solr 概述 商标声明：本软件列表由 Bitnami 打包。产品中提及的各个商标分别归各自公司所有，使用这些商标并不意味着任何关联或背书。

快速启动

console
docker run --name solr bitnami/solr:latest

您可以在环境变量部分找到可用的配置选项。

⚠️ 重要通知：Bitnami 目录即将变更

自2025年8月28日起，Bitnami 将改进其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦镜像集。作为此过渡的一部分：

• 首次向社区用户提供热门容器镜像的安全优化版本。
• Bitnami 将开始在其免费层级中弃用对非强化、基于 Debian 的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以“latest”标签发布，适用于开发目的。
• 从8月28日开始，在两周内，所有现有容器镜像（包括旧版本或带版本号的标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用 Bitnami Secure Images，包括强化容器、更小的***面、CVE 透明度（通过 VEX/KEV）、SBOM 以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有 Bitnami 用户的安全态势。有关更多详情，请访问https://github.com/bitnami/containers/issues/83267%E3%80%82

为什么使用 Bitnami Secure Images？

• Bitnami Secure Images 和 Helm 图表旨在使开源更安全且适合企业使用。
• 更快地分类安全漏洞，通过行业标准漏洞可利用性交换（VEX）、KEV 和 EPSS 分数透明了解 CVE 风险。
• 我们的强化镜像使用最小化操作系统（Photon Linux），减少***面，同时通过行业标准包格式保持可扩展性。
• 通过持续构建的镜像（在上游补丁发布后数小时内更新），保持更高的安全性和合规性。
• Bitnami 容器、虚拟机和云镜像使用相同的组件和配置方法，便于根据项目需求在不同格式之间切换。
• 强化镜像附带证明签名（Notation）、SBOM、病毒扫描报告和其他在 SLSA-3 合规软件工厂中生成的元数据。

只有部分 BSI 应用程序可免费使用。希望访问整个应用程序目录以及企业支持？立即尝试Bitnami Secure Images 商业版。

支持的标签及相应的 Dockerfile 链接

了解更多关于 Bitnami 标签策略以及滚动标签和不可变标签之间的区别，请参阅我们的文档页面。

您可以通过查看分支文件夹中存在的 tags-info.yaml 文件（即 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）来了解不同标签之间的对应关系。

通过关注 https://github.com/bitnami/containers 订阅项目更新。

获取此镜像

获取 Bitnami solr Docker 镜像的推荐方式是从 https://hub.docker.com/r/bitnami/solr 拉取预构建镜像。

console
docker pull bitnami/solr:latest

要使用特定版本，您可以拉取带版本的标签。您可以在 Docker Hub Registry 中查看https://hub.docker.com/r/bitnami/solr/tags/%E3%80%82

console
docker pull bitnami/solr:[TAG]

如果需要，您也可以通过克隆仓库、切换到包含 Dockerfile 的目录并执行 docker build 命令来自行构建镜像。请记住将下面示例命令中的 APP、VERSION 和 OPERATING-SYSTEM 路径占位符替换为正确的值。

console
git clone https://github.com/bitnami/containers.git
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

持久化应用数据

如果您删除容器，所有数据和配置都将丢失，下次运行镜像时数据库将重新初始化。为避免数据丢失，您应该挂载一个在容器删除后仍能持久化的卷。

为实现持久化，您应该在 /bitnami 路径挂载卷。上述示例定义了一个名为 solr_data 的 docker 卷。只要此卷未被删除，Solr 应用状态就会持久化。

为避免意外删除此卷，您可以将主机目录挂载为数据卷。或者，您也可以使用卷插件来托管卷数据。

console
docker run -v /path/to/solr-persistence:/bitnami bitnami/solr:latest

或者修改此仓库中存在的 https://github.com/bitnami/containers/blob/main/bitnami/solr/docker-compose.yml 文件：

yaml
solr:
  ...
  volumes:
    - /path/to/solr-persistence:/bitnami
  ...

注意：由于这是一个非 root 容器，挂载的文件和目录必须对 UID 1001 具有适当的权限。

连接到其他容器

使用 Docker 容器网络，在容器内运行的 Solr 服务器可以轻松被您的应用容器访问。

连接到同一网络的容器可以使用容器名称作为主机名进行通信。

使用命令行

步骤 1：创建网络

console
docker network create solr-network --driver bridge

步骤 2：在网络中启动 solr 容器

使用 --network <NETWORK> 参数执行 docker run 命令，将容器附加到 solr-network 网络。

console
docker run --name solr-node1 --network solr-network bitnami/solr:latest

步骤 3：运行其他容器

您可以使用 docker run 命令中的相同标志（--network NETWORK）启动其他容器。如果您也为容器设置了名称，则可以在网络中将其用作主机名。

使用 Docker Compose 文件

未指定时，Docker Compose 会自动设置一个新网络，并将所有部署的服务附加到该网络。不过，我们将显式定义一个名为 solr-network 的新桥接网络。

yaml
version: '2'

networks:
  solr-network:
    driver: bridge

services:
  solr-node1:
    image: bitnami/solr:latest
    networks:
      - solr-network
    ports:
      - 8983:8983
  solr-node2:
    image: bitnami/solr:latest
    networks:
      - solr-network
    ports:
      - 8984:8984

然后，使用以下命令启动容器：

console
docker-compose up -d

配置

环境变量

可自定义环境变量

只读环境变量

启动 solr 镜像时，您可以通过在 docker-compose 文件或 docker run 命令行中传递一个或多个环境变量来调整实例配置。

使用 Docker Compose 指定环境变量

这需要对本仓库中存在的 https://github.com/bitnami/containers/blob/main/bitnami/solr/docker-compose.yml 文件进行 minor 修改：

yaml
solr:
  ...
  environment:
    - SOLR_CORES=my_core
  ...

在 Docker 命令行上指定环境变量

console
docker run -d -e SOLR_CORES=my_core --name solr bitnami/solr:latest

使用自定义 Apache Solr 核心配置文件

为了加载您自己的配置文件，您需要使这些文件对容器可用。您可以通过挂载卷到所需位置并设置带有自定义值的环境变量来实现（如上所述，默认值为 data_driven_schema_configs）。

使用 Docker Compose

这需要对本仓库中存在的 https://github.com/bitnami/containers/blob/main/bitnami/solr/docker-compose.yml 文件进行 minor 修改：

yaml
solr:
  ...
  environment:
    - SOLR_CORE_CONF_DIR=/container/path/to/your/confDir
  volumes:
    - /local/path/to/your/confDir:/container/path/to/your/confDir
  ...

Bitnami Secure Images 中的 FIPS 配置

来自 Bitnami Secure Images 目录的 Bitnami Apache Solr Docker 镜像包含额外功能和设置，可将容器配置为具有 FIPS 功能。您可以配置以下环境变量：

• OPENSSL_FIPS：OpenSSL 是否以 FIPS 模式运行。yes（默认）、no。

日志

Bitnami solr Docker 镜像将容器日志发送到 stdout。要查看日志：

console
docker logs solr

或使用 Docker Compose：

console
docker-compose logs solr

如果您希望以不同方式消费容器日志，可以使用 --log-driver 选项配置容器的日志驱动程序。在默认配置中，docker 使用 json-file 驱动程序。

维护

升级此镜像

Bitnami 会在 upstream 发布后尽快提供 solr 的最新版本，包括安全补丁。建议您按照以下步骤升级容器。

步骤 1：获取更新的镜像

console
docker pull bitnami/solr:latest

如果使用 Docker Compose，请将 image 属性的值更新为 bitnami/solr:latest。

步骤 2：停止并备份当前运行的容器

使用以下命令停止当前运行的容器：

console
docker stop solr

或使用 Docker Compose：

console
docker-compose stop solr

接下来，使用以下命令对持久卷 /path/to/solr-persistence 进行快照：

console
rsync -a /path/to/solr-persistence /path/to/solr-persistence.bkp.$(date +%Y%m%d-%H.%M.%S)

如果升级失败，您可以使用此快照恢复数据库状态。

步骤 3：删除当前运行的容器

console
docker rm -v solr

或使用 Docker Compose：

console
docker-compose rm -v solr

步骤 4：运行新镜像

从新镜像重新创建容器，必要时恢复备份。

console
docker run --name solr bitnami/solr:latest

或使用 Docker Compose：

console
docker-compose up solr

重要变更

8.11.3-debian-12-r2 和 9.5.0-debian-12-r7

• 由于 CVEs 移除 HDFS 模块

8.8.0-debian-10-r11

• 添加 SSL 支持。

8.8