ucsb/rstudio-base

镜像概述

本镜像为集成Jupyter R笔记本与RStudio的Docker镜像，旨在提供一站式R语言数据科学开发环境。它整合了Jupyter的交互式笔记本功能与RStudio的专业IDE界面，适用于R语言数据分析、统计建模及可视化任务。

主要用途

提供便捷的R语言开发环境，支持代码编写、运行、调试及结果展示，满足数据科学家、分析师及教育工作者的日常工作需求。

核心功能和特性

• 双环境集成：同时包含Jupyter R笔记本（.ipynb格式）和RStudio IDE，支持多样化交互编程方式
• 即开即用：预装R语言核心运行环境及常用数据科学包（如tidyverse、ggplot2、dplyr等）
• 多端口访问：分别通过Jupyter（8888端口）和RStudio（8787端口）提供Web界面访问
• 持久化支持：支持本地目录挂载，确保工作文件持久化存储

使用场景和适用范围

• 数据科学研究：R语言数据分析、统计建模、机器学习模型开发
• 教学与培训：R语言入门教学、数据科学实践课程
• 团队协作：共享代码、复现分析结果、协同开发项目
• 快速原型验证：通过交互式环境快速验证R代码逻辑和算法

使用方法和配置说明

基础启动命令

通过以下命令启动容器，映射默认端口并指定容器名称：

bash
docker run -d \
  -p 8888:8888 \  # Jupyter笔记本Web端口
  -p 8787:8787 \  # RStudio Web端口
  --name jupyter-rstudio \
  ucsb-pstat/base-rstudio

挂载本地目录（推荐）

为避免容器销毁导致数据丢失，建议挂载本地工作目录至容器内：

bash
docker run -d \
  -p 8888:8888 \
  -p 8787:8787 \
  -v /本地工作目录:/home/jovyan/work \  # 挂载本地目录到容器工作目录
  --name jupyter-rstudio \
  ucsb-pstat/base-rstudio

说明：/本地工作目录需替换为实际本地路径（如~/data-science-projects），容器内默认工作目录为/home/jovyan/work

自定义访问配置

修改RStudio访问密码

通过PASSWORD环境变量设置RStudio登录密码：

bash
docker run -d \
  -p 8888:8888 \
  -p 8787:8787 \
  -e PASSWORD=your_secure_password \  # 设置RStudio密码
  -v /本地工作目录:/home/jovyan/work \
  --name jupyter-rstudio \
  ucsb-pstat/base-rstudio

自定义端口映射

如需修改默认端口（如避免端口冲突），可调整主机端口映射：

bash
docker run -d \
  -p 9000:8888 \  # 主机9000端口映射到Jupyter 8888端口
  -p 9001:8787 \  # 主机9001端口映射到RStudio 8787端口
  -v /本地工作目录:/home/jovyan/work \
  --name jupyter-rstudio \
  ucsb-pstat/base-rstudio

访问方式

1. Jupyter笔记本
   启动容器后，通过浏览器访问 http://localhost:8888，首次登录需输入认证token。可通过以下命令获取token：

   bash
   docker logs jupyter-rstudio | grep "token="
   

2. RStudio IDE
   通过浏览器访问 http://localhost:8787，默认登录信息：

   • 用户名：rstudio
   • 密码：若未自定义，默认密码为容器ID前8位（可通过docker inspect jupyter-rstudio | grep Id查看容器ID）

注意事项

• 详细配置及高级用法（如添加自定义R包、配置代理等）请参考官方源代码仓库：https://github.com/UCSB-PSTAT/base-rstudio
• 建议定期更新镜像以获取最新安全补丁和功能优化：docker pull ucsb-pstat/base-rstudio
• 生产环境使用时，建议通过环境变量自定义密码并限制容器网络访问权限