posit/package-manager

Posit Package Manager 容器镜像

该容器镜像提供Posit Package Manager (PPM)，这是一款仓库管理服务器，用于跨团队、部门或组织组织和集中管理R和Python包。

[!NOTE] 这些镜像处于预览阶段，因为Posit正在从https://github.com/rstudio/rstudio-docker-products%E8%BF%81%E7%A7%BB%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8F%E3%80%82%E7%8E%B0%E6%9C%89%E9%95%9C%E5%83%8F%E4%BB%8D%E5%8F%97%E6%94%AF%E6%8C%81%E3%80%82

快速启动

bash
PPM_VERSION="2026.04.0"
PPM_IMAGE="ghcr.io/posit-dev/package-manager"  # 或 docker.io/posit/package-manager
PPM_LICENSE="/path/to/license.lic"
docker run -d \
  --name package-manager \
  -p 4242:4242 \
  -v ${PPM_LICENSE}:/etc/rstudio-pm/license.lic \
  ${PPM_IMAGE}:${PPM_VERSION}

通过 http://localhost:4242 访问Package Manager。

[!NOTE] 此示例未挂载数据卷。容器停止时，包数据将不会持久化。有关持久存储，请参见卷挂载。

镜像变体

提供两种变体：

有关如何基于最小镜像构建的示例，请参见https://github.com/posit-dev/images-examples/tree/main/extending%E3%80%82

镜像标签

镜像发布于：

• Docker Hub: docker.io/posit/package-manager
• GitHub Container Registry: ghcr.io/posit-dev/package-manager

默认操作系统为Ubuntu 24.04。

标签格式：

• 2026.04.0 - 最新操作系统，标准变体
• 2026.04.0-ubuntu-24.04 - 显式操作系统，标准变体
• 2026.04.0-ubuntu-24.04-std - 显式操作系统和变体
• 2026.04.0-ubuntu-24.04-min - 最小变体
• latest - 最新版本，默认操作系统，标准变体

配置

许可证激活

需要产品许可证。Posit建议使用许可证文件激活。选择以下一种方法：

方法1：许可证文件（推荐）

bash
docker run -v /path/to/license.lic:/etc/rstudio-pm/license.lic ...

方法2：许可证密钥

bash
docker run -e PPM_LICENSE="your-license-key" ...

方法3：浮动许可证服务器

bash
docker run -e PPM_LICENSE_SERVER="http://license-server:8989" ...

环境变量

旧版环境变量

注意：旧版RSPM_变量仍受支持，但计划在2025年后弃用。有关详细信息和更新，请参见Posit Package Manager发布说明。新部署应始终使用PPM_前缀以确保向前兼容。

卷挂载

如需持久化数据，在docker run命令中添加以下卷挂载：

bash
-v /data/rstudio-pm:/var/lib/rstudio-pm \
-v /data/rstudio-pm-config:/etc/rstudio-pm

自定义配置

挂载自定义配置文件：

bash
docker run -v /path/to/rstudio-pm.gcfg:/etc/rstudio-pm/rstudio-pm.gcfg ...

有关可用选项，请参见配置文档。

暴露端口

用户

以rstudio-pm用户（UID/GID 999）运行。

与 rstudio/rstudio-package-manager 的区别

此镜像与旧版https://hub.docker.com/r/rstudio/rstudio-package-manager%E9%95%9C%E5%83%8F%E7%9A%84%E5%8C%BA%E5%88%AB%EF%BC%9A

注意事项

安全性

这些镜像在生产环境使用前应进行审查。有特定CVE或漏洞要求的组织应重新构建这些镜像以满足其安全标准。

处于活跃支持期的Posit产品版本的已发布镜像每周重建一次，以纳入操作系统补丁。

许可证密钥

如果容器未优雅停止，容器中使用的许可证密钥可能会丢失激活槽。许可证在容器退出时会停用，但非优雅关闭（崩溃、docker kill）可能导致Posit许可证服务器上的激活槽仍被占用。

为确保正确的许可证停用，请使用足够的停止超时：

bash
docker run -d \
  --stop-timeout 120 \
  -e PPM_LICENSE="your-license-key" \
  ...

生产部署中，建议使用许可证文件而非许可证密钥。

硬件锁定

许可证状态文件与硬件绑定。MAC地址、主机名或容器编排平台（如Kubernetes）的更改可能使现有许可证状态失效，需要重新激活。

文档

• Posit Package Manager文档
• 管理员指南
• 配置参考