Bitnami OpenSearch Dashboards 镜像文档

镜像概述和主要用途

OpenSearch Dashboards 是 OpenSearch 安装的可视化工具。OpenSearch 是一个可扩展的开源解决方案，用于搜索、分析和可观测性。

核心功能和特性

• 提供 OpenSearch 集群的可视化界面
• 支持数据探索、可视化和仪表板创建
• 与 OpenSearch 无缝集成
• 支持安全连接和认证
• 可通过环境变量灵活配置
• 基于 Bitnami Secure Images 构建，增强安全性

使用场景和适用范围

• OpenSearch 集群的可视化监控和管理
• 日志和指标数据分析
• 安全事件监控和分析
• 应用性能监控
• 开发和生产环境中的 OpenSearch 可视化需求

快速开始

console
docker run -it --name opensearch-dashboards bitnami/opensearch-dashboards:latest

重要通知：Bitnami Catalog 即将变更

自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用户的安全状况。

为什么使用Bitnami Secure Images？

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

只有部分BSI应用程序可免费使用。

支持的标签和Dockerfile链接

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

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

通过关注bitnami/containers GitHub仓库订阅项目更新。

获取此镜像

获取Bitnami OpenSearch Dashboards Docker镜像的推荐方式是从Docker Hub Registry拉取预构建镜像。

console
docker pull bitnami/opensearch-dashboards:latest

要使用特定版本，可以拉取带版本的标签。您可以在Docker Hub Registry查看可用版本列表。

console
docker pull bitnami/opensearch-dashboards:[TAG]

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

console
git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

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

基本部署

使用Docker Run部署

console
docker run -d \
  --name opensearch-dashboards \
  -p 5601:5601 \
  -e OPENSEARCH_DASHBOARDS_OPENSEARCH_URL=[***] \
  bitnami/opensearch-dashboards:latest

使用Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'

services:
  opensearch:
    image: bitnami/opensearch:latest
    environment:
      - OPENSEARCH_DISABLE_SECURITY_PLUGIN=yes
    ports:
      - "9200:9200"
    volumes:
      - opensearch_data:/bitnami/opensearch

  opensearch-dashboards:
    image: bitnami/opensearch-dashboards:latest
    ports:
      - "5601:5601"
    environment:
      - OPENSEARCH_DASHBOARDS_OPENSEARCH_URL=[***]
    depends_on:
      - opensearch

volumes:
  opensearch_data:

启动服务：

console
docker-compose up -d

维护

升级镜像

Bitnami提供最新版本的OpenSearch Dashboards，包括安全补丁。建议按照以下步骤升级容器：

步骤1：获取更新的镜像

console
docker pull bitnami/opensearch-dashboards:latest

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

console
docker rm -v opensearch-dashboards

步骤3：运行新镜像

从新镜像重新创建容器。

console
docker run --name opensearch-dashboards bitnami/opensearch-dashboards:latest

配置

环境变量

可自定义环境变量

只读环境变量

运行命令

要在此容器内运行命令，可以使用docker run，例如执行opensearch-dashboards --help：

console
docker run --rm --name opensearch-dashboards bitnami/opensearch-dashboards:latest --help

有关如何使用OpenSearch Dashboards的更多信息，请查看***OpenSearch Dashboards文档。

启用HTTPS

要启用HTTPS，需要配置TLS相关环境变量：

console
docker run -d \
  --name opensearch-dashboards \
  -p 5601:5601 \
  -e OPENSEARCH_DASHBOARDS_SERVER_ENABLE_TLS=true \
  -e OPENSEARCH_DASHBOARDS_SERVER_TLS_USE_PEM=true \
  -e OPENSEARCH_DASHBOARDS_SERVER_CERT_LOCATION=/path/to/cert.crt \
  -e OPENSEARCH_DASHBOARDS_SERVER_KEY_LOCATION=/path/to/cert.key \
  -v /local/certs:/bitnami/opensearch-dashboards/certs \
  bitnami/opensearch-dashboards:latest

FIPS配置

Bitnami OpenSearch Dashboards Docker镜像包含额外功能和设置，可将容器配置为具有FIPS功能。您可以配置以下环境变量：

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

维护和升级

数据持久化

为确保数据持久化，需要挂载卷：

console
docker run -d \
  --name opensearch-dashboards \
  -p 5601:5601 \
  -v opensearch-dashboards_data:/bitnami/opensearch-dashboards \
  bitnami/opensearch-dashboards:latest

升级镜像

console
# 获取更新的镜像
docker pull bitnami/opensearch-dashboards:latest

# 停止并删除当前容器
docker stop opensearch-dashboards
docker rm opensearch-dashboards

# 使用新镜像启动容器
docker run -d \
  --name opensearch-dashboards \
  -p 5601:5601 \
  -v opensearch-dashboards_data:/bitnami/opensearch-dashboards \
  bitnami/opensearch-dashboards:latest

显著变更

2024年1月16日起

• docker-compose.yaml文件已被移除，因为它仅用于内部测试目的。

贡献

我们欢迎您为此Docker镜像做出贡献。您可以通过创建issue请求新功能，或提交pull request贡献代码。

问题

如果您在运行此容器时遇到问题，可以提交issue。为了让我们提供更好的支持，请务必填写issue模板。

许可证

Copyright © 2025 Bitnami

根据Apache许可证2.0版（"许可证"）授权；除非遵守许可证，否则您不得使用此文件。您可以在以下位置获取许可证副本：

<[***]>

除非适用***要求或书面同意，否则根据许可证分发的软件是按"原样"分发的，不附带任何明示或暗示的担保或条件。有关许可证下权限和限制的具体语言，请参阅许可证。