stefanfritsch/rstudio_with_latex_statup

rstudio_with_latex_statup 镜像文档

镜像概述

rstudio_with_latex_statup 是一个集成了 RStudio Server 和完整 TexLive 发行版的 Docker 镜像。该镜像旨在为用户提供一站式开发环境，既能通过 RStudio Server 进行 R 语言开发与数据分析，又能直接使用完整的 LaTeX 工具链进行学术文档、报告或论文的排版，无需额外安装 LaTeX 组件。

核心功能与特性

• RStudio Server 环境：提供基于 Web 界面的 R 语言开发平台，支持代码编辑、运行、调试及可视化，兼容 R 脚本、R Markdown 等文件格式。
• 完整 TexLive 发行版：包含全部 LaTeX 宏包、工具及字体，覆盖学术出版、技术文档所需的各类排版需求，无需手动安装额外 LaTeX 组件。
• 开箱即用：集成 RStudio 与 LaTeX 环境，启动容器后即可同时使用 R 数据分析功能和 LaTeX 文档编译功能，简化环境配置流程。

使用场景与适用范围

• 学术研究人员：需通过 R 进行数据分析，并使用 LaTeX 撰写学术论文、报告的用户。
• 数据分析师：需要在同一环境中完成 R 代码开发、数据分析及生成 LaTeX/PDF 格式分析报告的场景。
• 教学场景：用于 R 语言与 LaTeX 排版教学，提供统一、免配置的实训环境。
• 自动化工作流：构建 R 数据分析与 LaTeX 报告生成的自动化流水线（如通过 R Markdown 生成 PDF 报告）。

使用方法与配置说明

基本运行命令

通过以下命令启动容器，映射 RStudio Server 默认端口（8787）并设置登录凭据：

bash
docker run -d -p 8787:8787 -e USER=rstudio -e PASSWORD=yourpassword --name rstudio_latex rstudio_with_latex_statup

参数说明：

• -p 8787:8787：将容器内 RStudio Server 端口（8787）映射到主机的 8787 端口，可通过主机浏览器访问。
• -e USER=rstudio：设置登录 RStudio 的用户名（自定义，如 user123）。
• -e PASSWORD=yourpassword：设置登录密码（建议使用强密码）。
• --name rstudio_latex：为容器指定名称，便于管理。

访问方式

容器启动后，在浏览器中访问 http://localhost:8787，输入设置的用户名和密码即可登录 RStudio Server。

验证 LaTeX 环境

登录后，可通过 RStudio 终端执行以下命令验证 LaTeX 是否可用：

bash
pdflatex --version  # 查看 pdflatex 版本
tlmgr list          # 列出所有已安装的 LaTeX 包（完整 TexLive 包含数千个包）

数据持久化（可选）

若需持久化保存 R 代码、数据文件及 LaTeX 文档，可通过 -v 参数挂载主机目录到容器内的用户工作目录（如 /home/rstudio）：

bash
docker run -d -p 8787:8787 -e USER=rstudio -e PASSWORD=yourpassword -v /path/on/host:/home/rstudio --name rstudio_latex rstudio_with_latex_statup

其中 /path/on/host 为本地主机目录，容器内的 /home/rstudio 为 RStudio 用户的工作目录，文件将在主机与容器间双向同步。

注意事项

• 首次启动容器时，TexLive 环境已预安装完成，无需额外执行 tlmgr install 安装包。
• 若需调整 RStudio Server 配置（如端口、用户权限），可通过修改容器内 /etc/rstudio/rserver.conf 文件实现（需进入容器或通过挂载配置文件完成）。
• 建议根据实际需求调整主机端口映射（如主机 8787 端口被占用时，可改为 -p 8888:8787 使用 8888 端口访问）。