rhub/r-minimal

R的最小化Docker镜像

镜像概述与主要用途

R是一个用于统计计算和图形的自由软件环境，可在多种UNIX平台、Windows和MacOS上编译运行（详见[***]

核心功能与特性

• 最小化设计：专注于减小镜像体积，适合生产环境中作为基础镜像使用
• 基于Alpine Linux：采用轻量级Linux发行版，进一步降低基础体积
• 集成installr工具：支持从CRAN或GitHub安装R包，简化扩展流程

限制

为保持最小化，镜像不包含交互式R开发通常所需的以下功能和组件：

• 未安装推荐的R包
• 不包含文档
• 无readline库支持
• 无X11支持
• 无Java支持
• 无OpenMP支持
• 无JPEG、PNG或TIFF图像支持
• 无Cairo支持
• 无Tcl/Tk支持
• 无翻译功能，仅支持英文
• 不包含C、C++或Fortran编译器

使用场景与适用范围

适用于需要在容器中运行特定R功能的场景，尤其是作为基础镜像构建包含定制R包集合的应用镜像。不适合需要完整开发环境的交互式R开发。

详细使用方法与配置说明

Dockerfile示例

安装简单R包

通过installr命令在Dockerfile中添加CRAN或GitHub上的R包：

dockerfile
FROM rhub/r-minimal
RUN installr praise
CMD [ "R", "--slave", "-e", "cat(praise::praise())" ]

安装含编译代码的R包

dockerfile
FROM rhub/r-minimal
RUN installr -d glue

注：-d选项用于安装含编译代码的包，安装完成后会自动移除编译器以保持镜像最小化。若需保留编译器，使用installr -c。

安装需系统依赖的R包

dockerfile
FROM rhub/r-minimal
RUN installr -d -t linux-headers pingr
CMD [ "R", "-q", "-e", "pingr::is_online() || stop('offline')" ]

注：-t选项用于指定临时系统依赖包，安装完成后会自动移除。若需保留系统依赖，使用installr -a（可混合使用-a和-t）。

常用R包安装示例

注意：包及其依赖可能随时间变化，若命令失效，请参考https://github.com/r-hub/r-minimal%E3%80%82pandoc%E5%AE%89%E8%A3%85%E7%A4%BA%E4%BE%8B%E8%AF%A6%E8%A7%81%5Bexamples/rmarkdown/Dockerfile%5D%E3%80%82

已知问题

• fs包：CRAN版本（1.3.1）无法在Alpine Linux上构建（https://github.com/r-lib/fs/issues/210%EF%BC%89%EF%BC%8C%E9%9C%80%E4%BB%8EGitHub%E5%AE%89%E8%A3%85%E5%BC%80%E5%8F%91%E7%89%88%EF%BC%9A%60installr -d r-lib/fs`。若安装依赖fs的包，需先安装此开发版fs。
• xgboost包：无法在Alpine Linux上编译（https://github.com/dmlc/xgboost/issues/5131%EF%BC%89%E3%80%82

许可证

• R的许可证详见[***]
• 本Dockerfile采用MIT许可证
• (c) https://github.com/rconsortium