posit/connect

Posit Connect容器镜像

该容器镜像提供Posit Connect（PCT），这是一个发布平台，用于连接您和您与他人共享的工作成果。可部署Shiny应用、R Markdown文档、Plumber API、Python应用（Flask、Dash、FastAPI、Bokeh、Streamlit）、Jupyter笔记本、Quarto文档等。

[!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

相关镜像

对于Kubernetes部署，Connect需同时使用这三个镜像。有关Helm配置，请参见https://github.com/posit-dev/images-connect#deploying-on-kubernetes%E3%80%82

快速开始

bash
PCT_VERSION="2026.03.1"
PCT_IMAGE="ghcr.io/posit-dev/connect"  # 或 docker.io/posit/connect
PCT_LICENSE="/path/to/license.lic"
docker run -d \
  --name connect \
  --privileged \
  -p 3939:3939 \
  -v ${PCT_LICENSE}:/etc/rstudio-connect/license.lic \
  ${PCT_IMAGE}:${PCT_VERSION}

通过http://localhost:3939访问Posit Connect。

[!NOTE] --privileged标志是Connect管理沙箱内容执行环境所必需的。 本示例未挂载数据卷。容器停止时应用数据将不会持久化。有关持久存储，请参见卷挂载。

[!IMPORTANT] 要使Posit Connect支持多个用户，需在rstudio-connect.gcfg文件中定义Server.Address。将其设置为用户访问Connect的URL，然后启动或重启容器。

镜像变体

提供两种变体：

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

[!WARNING] 由于平台支持限制，linux/arm64的标准镜像构建不包含Pro Drivers。

镜像标签

镜像发布于：

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

默认操作系统为Ubuntu 24.04。

标签格式：

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

配置

许可证激活

需要产品许可证。Posit建议使用许可证文件激活。Connect还必须使用--privileged标志运行。选择以下激活方法之一：

选项1：许可证文件（推荐）

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

选项2：许可证密钥

bash
docker run --privileged -e PCT_LICENSE="your-license-key" ...

选项3：浮动许可证服务器

bash
docker run --privileged -e PCT_LICENSE_SERVER="license-server:port" ...

环境变量

遗留环境变量

注意： 为向后兼容支持遗留RSC_变量，但计划弃用。有关详细信息和更新，请参见Posit Connect发布说明。对于新部署，始终使用PCT_前缀以确保向前兼容。

卷挂载

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

bash
-v /data/connect:/data \
-v /data/connect-config:/etc/rstudio-connect

自定义配置

挂载自定义配置文件：

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

确保配置文件包含以下字段：

• Server.Address 设置为用户访问Connect的确切URL
• Server.DataDir 设置为/data/
• HTTP.Listen（或等效的HTTP、HTTPS或HTTPRedirect设置）
• Python.Enabled 和 Python.Executable

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

暴露端口

用户

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

与rstudio/rstudio-connect的区别

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

注意事项

安全

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

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

特权模式

Posit Connect需要--privileged标志来运行容器。这是Connect在隔离环境中执行用户内容所必需的。

许可证密钥

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

为避免"泄露"许可证，请使用足够的停止超时：

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

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

要在容器重启之间保留许可证状态数据，将以下目录挂载到持久存储：

• 许可证密钥
  • /var/lib/.local
  • /var/lib/.prof
  • /var/lib/rstudio-connect
• 浮动许可证
  • /var/lib/.TurboFloat

硬件锁定

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

文档

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