如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
该容器镜像提供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)的变化可能导致现有许可证状态失效,需要重新激活。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务