rocker/shiny-verse

Rocker Shiny + Tidyverse 镜像文档

镜像概述与主要用途

Rocker Shiny + Tidyverse 镜像是基于 Rocker 项目 的版本稳定镜像构建，集成了 Shiny 服务器和 Tidyverse 数据科学生态系统。该镜像旨在为数据科学家、分析师和开发者提供开箱即用的环境，快速部署基于 R Shiny 的交互式 Web 应用，同时支持数据处理、可视化和统计分析等任务。

• 构建源：https://github.com/rocker-org/rocker-versioned2
• 官方文档：<[***]>

核心功能与特性

1. 内置 Shiny 服务器

• 预配置 Shiny Server，支持直接运行 Shiny 应用，无需额外安装服务器组件。
• 默认监听 3838 端口，兼容标准 Web 访问流程。

2. Tidyverse 全家桶集成

• 预装 Tidyverse 核心包，包括：
  • dplyr（数据操作）、ggplot2（数据可视化）
  • tidyr（数据清洗）、readr（数据读取）
  • purrr（函数式编程）、tibble（增强数据框）等
• 满足数据导入、清洗、分析、可视化全流程需求。

3. 版本稳定性

• 基于 Rocker versioned2 系列，采用固定版本标签（如 4.3.0），确保 R 环境、Shiny 及依赖包版本一致性，避免生产环境依赖冲突。

4. 系统与扩展性

• 基于 Debian/Ubuntu 稳定发行版，支持 apt 管理系统级依赖。
• 预留 R 包扩展路径，支持用户自定义安装额外包（系统级或用户级）。

使用场景与适用范围

1. 快速部署 Shiny 应用

• 数据科学家无需手动配置服务器环境，直接挂载本地 Shiny 应用代码即可运行。

2. 教学与培训环境

• 提供统一的 Shiny + Tidyverse 环境，避免学员因本地配置差异导致的实验失败。

3. 数据分析工具 Web 化

• 将脚本化分析流程（如报表生成、交互式仪表盘）转换为 Web 应用，供非技术人员使用。

4. 团队协作与共享

• 容器化部署确保团队成员使用一致的分析环境，便于共享应用和结果。

使用方法与配置说明

前提条件

• 已安装 Docker Engine（20.10+ 版本推荐）。
• 本地网络可访问 Docker Hub（用于拉取镜像）。

镜像拉取

通过 Docker Hub 拉取最新稳定版（标签规则参考 Rocker 版本文档）：

bash
docker pull rocker/shiny-verse:latest

注：shiny-verse 是 Rocker 项目中集成 Shiny 和 Tidyverse 的标准镜像标签，对应本镜像描述的功能。

Docker Run 命令示例

1. 基本运行（默认应用）

启动容器并映射 Shiny 默认端口（3838）：

bash
docker run -d -p 3838:3838 --name shiny-app rocker/shiny-verse:latest

访问 http://localhost:3838 即可打开 Shiny 欢迎页面。

2. 挂载本地 Shiny 应用

将本地应用目录（如 ./my-shiny-app）挂载到容器，运行自定义应用：

bash
docker run -d -p 3838:3838 \
  -v $(pwd)/my-shiny-app:/srv/shiny-server/ \
  --name my-shiny-app \
  rocker/shiny-verse:latest

说明：容器内 Shiny 服务器默认从 /srv/shiny-server/ 加载应用，需确保本地目录包含 app.R 或 server.R+ui.R 文件。

3. 自定义端口与数据持久化

指定主机端口（如 8080），并挂载数据卷持久化应用数据：

bash
docker run -d -p 8080:3838 \
  -v $(pwd)/my-shiny-app:/srv/shiny-server/ \
  -v shiny-data:/srv/shiny-server/data \  # 命名卷存储应用数据
  --name shiny-app-custom \
  rocker/shiny-verse:latest

Docker Compose 配置示例

创建 docker-compose.yml 定义完整服务（含配置、数据卷、时区等）：

yaml
version: '3.8'

services:
  shiny-app:
    image: rocker/shiny-verse:latest
    container_name: shiny-app
    restart: always  # 容器退出后自动重启
    ports:
      - "3838:3838"
    volumes:
      - ./my-shiny-app:/srv/shiny-server/  # 本地应用目录
      - shiny-data:/srv/shiny-server/data  # 数据持久化卷
      - ./shiny-server.conf:/etc/shiny-server/shiny-server.conf  # 自定义 Shiny 配置
    environment:
      - TZ=Asia/Shanghai  # 设置时区为上海
      - R_ENVIRON_USER=/srv/shiny-server/.Renviron  # 加载应用级环境变量

volumes:
  shiny-data:  # 命名卷（自动创建，数据持久化）

启动服务：

bash
docker-compose up -d

配置参数与环境变量

核心配置参数

常用环境变量

扩展与定制

安装额外 R 包

• 临时安装：容器运行中通过终端执行：

  bash
  docker exec -it shiny-app R -e "install.packages('plotly', dependencies=TRUE)"
  

• 构建自定义镜像：通过 Dockerfile 预安装依赖：

  dockerfile
  FROM rocker/shiny-verse:latest
  # 安装系统依赖（如需）
  RUN apt-get update && apt-get install -y libssl-dev libcurl4-openssl-dev
  # 安装 R 包
  RUN R -e "install.packages(c('plotly', 'DT'), dependencies=TRUE)"
  

自定义 Shiny Server 配置

通过挂载 shiny-server.conf 调整服务器行为（如访问控制、超时设置），示例配置：

conf
# /etc/shiny-server/shiny-server.conf
run_as shiny;  # 运行用户
server {
  listen 3838;
  location / {
    site_dir /srv/shiny-server;  # 应用目录
    log_dir /var/log/shiny-server;  # 日志目录
    directory_index on;  # 启用目录浏览（无 app.R 时显示文件列表）
    app_init_timeout 60;  # 应用初始化超时（秒）
    app_idle_timeout 120;  # 应用闲置超时（秒）
  }
}

参考资料

• 镜像源码：https://github.com/rocker-org/rocker-versioned2
• Rocker 官方文档：<[***]>
• Shiny Server 文档：<[***]>
• Tidyverse 文档：<[***]>