pgensler/sandboxr

sandboxr

镜像概述和主要用途

sandboxr是一个用于以可重现方式测试R包的沙箱环境。该镜像基于RStudio构建，提供了隔离的R运行环境，确保R包测试过程的一致性和可重复性。适用于R开发者在本地环境中安全测试tidyverse相关包及其他R扩展，避免对本地系统造成干扰。

核心功能和特性

• RStudio集成：内置RStudio Server，通过Web界面访问，支持交互式R开发
• 文件共享：支持本地文件夹挂载至容器，实现宿主机器与容器间文件双向访问
• 端口映射：默认使用8787端口，方便本地访问RStudio界面
• 环境隔离：提供独立的R运行环境，避免包依赖冲突
• 资源可配置：支持调整Docker分配的内存等资源，满足不同测试需求

使用场景和适用范围

• R包开发过程中的功能测试与兼容性验证
• 教学或演示环境中快速部署标准化R开发环境
• 多版本R包测试，确保代码在不同依赖环境下的稳定性
• 临时数据分析任务，无需在本地安装完整R环境

使用方法和配置说明

前置要求

使用前需安装Docker及Docker Quickstart Terminal（根据操作系统选择相应版本）。

镜像拉取

bash
docker pull pgensler/sandboxr

容器运行

基础运行（无文件挂载）

bash
docker run --rm -p 8787:8787 pgensler/sandboxr:latest

• --rm：容器停止后自动删除
• -p 8787:8787：将宿主8787端口映射到容器8787端口（RStudio默认端口）

带本地文件挂载

bash
docker run -d -p 8787:8787 -v ~/Desktop:/home/rstudio pgensler/sandboxr

• -d：后台运行容器
• -v ~/Desktop:/home/rstudio：将本地~/Desktop文件夹挂载到容器内/home/rstudio目录，实现文件共享

访问RStudio

1. 容器启动后，在浏览器中访问 localhost:8787（Docker for Mac环境）
2. 使用默认 credentials 登录：
   • 用户名：rstudio
   • 密码：rstudio

配置参数说明

端口映射

• 固定使用8787端口，不支持修改（RStudio Server默认配置）
• 格式：-p <宿主端口>:8787，需确保宿主端口未被占用

文件挂载

• 格式：-v <本地路径>:/home/rstudio
• 示例：-v ~/Documents/R_Projects:/home/rstudio 将本地R项目文件夹挂载到容器

资源配置

默认Docker分配2GB内存，如需调整：

1. 打开Docker偏好设置（Docker -> Preferences）
2. 进入"Advanced"选项卡
3. 调整内存分配后重启Docker

注意事项

• 端口占用：由于RStudio使用8787端口，同一台机器上只能运行一个该容器实例
• rJava安装：如需使用rJava包，需通过R CMD rJava命令安装，具体参考相关解决方案
• Debian包管理：容器基于Debian系统，系统级依赖需通过apt-get安装，使用sudo apt-get命令（如sudo apt-get install <包名>）

参考资源

• 示例Dockerfile：
  • https://github.com/mhermans/dockerding/blob/master/rversioned/Dockerfile
  • https://hub.docker.com/r/andrewheiss/docker-example-r-environment/~/dockerfile/
  • https://github.com/verajosemanuel/tidyviz/blob/master/Dockerfile
• Travis CI配置：Travis CI Docker构建测试指南
• GitLab容器 registry：GitLab容器 registry 使用文档