该容器镜像提供Posit Workbench(PWB),这是一个面向数据科学团队的集成开发环境,支持R、Python和VS Code。
[!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部署,Workbench需配合以下镜像使用。有关Helm配置,请参见https://github.com/posit-dev/images-workbench#deploying-on-kubernetes%E3%80%82
| 镜像 | 描述 | Docker Hub | GHCR |
|---|---|---|---|
workbench-session | Kubernetes会话镜像(R和Python版本矩阵) | https://hub.docker.com/r/posit/workbench-session | https://github.com/posit-dev/images-workbench/pkgs/container/workbench-session |
workbench-session-init | 提供会话运行时组件的初始化容器 | https://hub.docker.com/r/posit/workbench-session-init | https://github.com/posit-dev/images-workbench/pkgs/container/workbench-session-init |
workbench-positron-init | 提供Positron IDE组件的初始化容器 | https://hub.docker.com/r/posit/workbench-positron-init | https://github.com/posit-dev/images-workbench/pkgs/container/workbench-positron-init |
bashPWB_VERSION="2026.01.2" PWB_IMAGE="ghcr.io/posit-dev/workbench" # 或 docker.io/posit/workbench PWB_LICENSE="/path/to/license.lic" docker run -d \ --name workbench \ -p 8787:8787 \ -e PWB_TESTUSER=posit \ -e PWB_TESTUSER_PASSWD=posit \ -v ${PWB_LICENSE}:/etc/rstudio-server/license.lic \ ${PWB_IMAGE}:${PWB_VERSION}
通过http://localhost:8787访问Workbench。使用用户名posit和密码posit登录。
[!NOTE] 此示例未挂载数据卷。容器停止后,会话数据将不会保留。有关持久存储,请参见卷挂载。
提供两种变体:
| 变体 | 描述 |
|---|---|
std(标准) | 预设配置镜像,可直接运行 |
min(最小) | 精简镜像,需自行扩展依赖,无法直接运行 |
有关如何基于最小镜像构建的示例,请参见https://github.com/posit-dev/images-examples/tree/main/extending%E3%80%82
镜像发布于:
docker.io/posit/workbenchghcr.io/posit-dev/workbench默认操作系统为Ubuntu 24.04。
标签格式:
2026.01.2 - 最新操作系统,标准变体2026.01.2-ubuntu-24.04 - 显式指定操作系统,标准变体2026.01.2-ubuntu-24.04-std - 显式指定操作系统和变体2026.01.2-ubuntu-24.04-min - 最小变体latest - 最新版本,默认操作系统,标准变体需要产品许可证。Posit建议使用许可证文件激活。选择以下一种方法:
方法1:许可证文件(推荐)
bashdocker run -v /path/to/license.lic:/etc/rstudio-server/license.lic ...
方法2:许可证密钥
bashdocker run -e PWB_LICENSE="your-license-key" ...
方法3:浮动许可证服务器
bashdocker run -e PWB_LICENSE_SERVER="http://license-server:8989" ...
| 变量 | 描述 |
|---|---|
PWB_LICENSE | 用于激活的许可证密钥 |
PWB_LICENSE_SERVER | 浮动许可证服务器URL |
PWB_LAUNCHER | 启用Job Launcher(默认:true) |
PWB_LAUNCHER_TIMEOUT | Launcher启动超时时间(秒)(默认:10) |
PWB_TESTUSER | 测试用户名。若为空,则不创建测试用户 |
PWB_TESTUSER_PASSWD | 测试用户密码 |
PWB_TESTUSER_UID | 测试用户UID(默认:当PWB_TESTUSER设置时为10000) |
STARTUP_DEBUG_MODE | 设置为1启用详细启动日志 |
DIAGNOSTIC_ENABLE | 启用诊断日志(默认:false) |
DIAGNOSTIC_DIR | 诊断日志目录(默认:/var/log/rstudio) |
旧版环境变量
| 旧版变量 | 推荐替代变量 | 说明 |
|---|---|---|
RSW_LICENSE | PWB_LICENSE | 行为相同 |
RSW_LICENSE_SERVER | PWB_LICENSE_SERVER | 行为相同 |
RSW_LAUNCHER | PWB_LAUNCHER | 行为相同 |
RSW_LAUNCHER_TIMEOUT | PWB_LAUNCHER_TIMEOUT | 行为相同 |
RSW_TESTUSER | PWB_TESTUSER | 行为相同 |
RSW_TESTUSER_PASSWD | PWB_TESTUSER_PASSWD | 行为相同 |
RSW_TESTUSER_UID | PWB_TESTUSER_UID | 行为相同 |
注意:旧版RSW_变量仍受支持,但计划在2025年后弃用。有关详细信息和更新,请参见Posit Workbench发布说明。对于新部署,应始终使用PWB_前缀以确保向前兼容性。
如需持久化数据,请在docker run命令中添加以下卷挂载:
bash-v /data/rstudio-server:/var/lib/rstudio-server \ -v /data/rstudio-server-config:/etc/rstudio
| 挂载点 | 描述 |
|---|---|
/var/lib/rstudio-server | 会话数据和数据库 |
/etc/rstudio | 配置文件 |
挂载自定义配置文件:
bashdocker run -v /path/to/rserver.conf:/etc/rstudio/rserver.conf ...
有关可用选项,请参见配置文档。
| 端口 | 描述 |
|---|---|
| 8787 | HTTP Web界面 |
| 5559 | Job Launcher |
以rstudio-server用户运行。
此镜像与旧版https://hub.docker.com/r/rstudio/rstudio-workbench%E9%95%9C%E5%83%8F%E7%9A%84%E5%8C%BA%E5%88%AB%EF%BC%9A
| 方面 | 此镜像 | rstudio/rstudio-workbench |
|---|---|---|
| 仓库 | posit/workbench | rstudio/rstudio-workbench |
| 许可证环境变量 | PWB_前缀 | RSW_前缀 |
| 变体 | std(含R/Python)、min(精简) | 单一变体;不同R/Python版本使用不同标签 |
| 基础OS选项 | Ubuntu 24.04、Ubuntu 22.04 | Ubuntu 22.04 |
这些镜像在生产使用前应进行审查。有特定CVE或漏洞要求的组织应重建这些镜像以满足其安全标准。
处于活跃支持状态的Posit产品版本的已发布镜像每周重建一次,以纳入操作系统补丁。
若容器未正常停止,容器中使用的许可证密钥可能会导致激活槽丢失。许可证会在容器退出时停用,但非正常关闭(崩溃、docker kill)可能导致Posit许可证服务器上的激活槽仍被占用。
为确保许可证正常停用,请使用足够的停止超时:
bashdocker run -d \ --stop-timeout 120 \ -e PWB_LICENSE="your-license-key" \ ...
对于生产部署,推荐使用许可证文件而非许可证密钥。
许可证状态文件与硬件绑定。MAC地址、主机名或容器编排平台(如Kubernetes)的变化可能导致现有许可证状态失效,需要重新激活。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务