Bitnami JupyterHub 镜像

什么是JupyterHub？

JupyterHub将笔记本的强大功能带给用户组。它为用户提供计算环境和资源的访问权限，而无需用户承担安装和维护任务。

JupyterHub概述 商标声明：本软件列表由Bitnami打包。产品中提及的各自商标归相应公司所有，使用这些商标并不意味着任何关联或认可。

概要

此镜像旨在在Kubernetes集群中运行。

⚠️ 重要通知：Bitnami目录即将发生的变化

自2025年8月28日起，Bitnami将改进其公共目录，在新的Bitnami安全镜像计划下提供精选的经过加固、注重安全的镜像集。作为此次过渡的一部分：

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

这些变化旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有Bitnami用户的安全态势。有关更多详情，请访问Bitnami安全镜像公告。

为什么使用Bitnami安全镜像？

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

只有部分BSI应用程序可免费使用。希望访问完整的应用程序目录以及企业支持？立即尝试Bitnami安全镜像商业版。

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

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

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

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

获取此镜像

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

console
docker pull bitnami/jupyterhub:latest

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

console
docker pull bitnami/jupyterhub:[TAG]

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

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

为什么使用非root容器？

非root容器镜像增加了额外的安全层，通常推荐用于生产环境。但是，由于它们以非root用户运行，通常无法执行特权任务。在我们的文档中了解更多关于非root容器的信息。

配置

环境变量

可自定义环境变量

只读环境变量

运行命令

要在此容器内运行命令，您可以使用docker run，例如执行jupyterhub --version，可以按照以下示例操作：

console
docker run --rm --name jupyterhub bitnami/jupyterhub:latest --version

查看JupyterHub***文档，或运行以下命令列出所有可用参数。

console
docker run --rm --name jupyterhub bitnami/jupyterhub:latest --help-all

Bitnami安全镜像中的FIPS配置

Bitnami安全镜像目录中的Bitnami JupyterHub Docker镜像包含额外功能和设置，可将容器配置为具备FIPS能力。您可以配置以下环境变量：

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

使用docker-compose.yaml

请注意，此文件未经内部测试。因此，我们建议仅将其用于开发或测试目的。对于生产就绪的部署，我们强烈建议使用其关联的Bitnami Helm图表。

如果您在docker-compose.yaml文件中发现任何问题，欢迎按照我们的贡献指南报告问题或提供修复。

贡献

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

问题反馈

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

许可协议

版权所有 © 2025 Broadcom。术语“Broadcom”指Broadcom Inc.及其子公司。

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

<[***]>

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