learnr部署指南：将R交互式教程发布到RStudio Connect和Shiny Server的完整教程

learnr部署指南：将R交互式教程发布到RStudio Connect和Shiny Server的完整教程

【免费下载链接】learnrInteractive Tutorials with R Markdown项目地址: https://gitcode.com/gh_mirrors/le/learnr

想要将您的R Markdown交互式教程分享给学生或团队吗？learnr是一个强大的R包，可以将R Markdown文档转换为交互式教程，但如何将这些教程部署到生产环境可能令人困惑。本指南将详细介绍如何将learnr教程发布到RStudio Connect和Shiny Server，让您的教学材料能够轻松地在网络上运行。

为什么选择learnr进行交互式教学？

learnr是RStudio开发的一个创新性R包，它允许您将普通的R Markdown文档转换为包含代码练习、测验问题和交互式组件的完整教程。与传统静态文档不同，learnr教程能够：

• 自动保存学生的进度和答案
• 提供实时代码反馈和错误检查
• 支持视频嵌入和交互式可视化
• 收集学习数据用于教学分析

learnr教程示例展示交互式学习界面

部署learnr教程的三种主要方法

1. 打包为R包发布

最简单的部署方式是将教程打包到R包中。这种方法适合技术能力较强的用户：

1. 在您的R包中创建inst/tutorials/目录
2. 将教程Rmd文件放入相应子目录（如inst/tutorials/hello/）
3. 学生通过learnr::run_tutorial("hello", package = "mypackage")运行教程

这种方法的好处是完全免费，但要求学生安装R和相关依赖包。

2. 一键发布到shinyapps.io

对于希望快速上线的教育工作者，shinyapps.io提供了最简单的一键部署方案：

1. 在RStudio中打开您的learnr教程Rmd文件
2. 点击"发布"按钮（通常位于右上角）
3. 选择shinyapps.io作为目标平台
4. 配置应用设置后立即发布

RStudio的一键发布界面让部署变得简单

注意：免费版shinyapps.io仅支持3-5个并发用户。对于课堂使用，建议升级到付费计划。

3. 部署到RStudio Connect服务器

对于企业或教育机构，RStudio Connect是最专业的解决方案：

1. 确保您有RStudio Connect服务器的访问权限
2. 在RStudio中使用相同的"发布"按钮
3. 选择RStudio Connect作为目标
4. 设置访问权限和元数据

RStudio Connect提供了企业级功能，包括用户认证、访问控制和高级监控。

优化shinyapps.io配置的最佳实践

如果您选择使用shinyapps.io托管learnr教程，以下配置建议可以确保最佳性能：

课堂使用优化配置

当60名学生同时访问您的教程时，这些设置至关重要：

• 实例数量：增加到允许的最大值，处理"突发流量"
• 实例大小：选择最大可用内存（如8GB）
• 工作进程数：减少到2以提高内存效率
• 最大连接数：设置为20左右
• 启动数量：设置为最大值，确保所有实例在第一个学生访问时启动

shinyapps.io实例大小配置界面

成本优化策略

shinyapps.io按活跃小时计费，以下方法可以控制成本：

1. 降低启动数量，仅在需要时启动实例
2. 增加最大连接数，让更多学生共享同一实例
3. 减少连接超时时间，释放不活跃的实例
4. 根据实际使用情况调整实例大小

建议的工作流程是：先设置较高配置，然后根据使用指标逐步优化。

使用Shiny Server开源版部署

如果您有自己的服务器，Shiny Server开源版是完全免费的部署方案：

1. 在服务器上安装Shiny Server
2. 确保所有用户都能访问rmarkdown包：

   sudo su - -c "R -e \"install.packages('rmarkdown')\""

3. 将learnr教程Rmd文件放入托管目录
4. 通过http://服务器地址/教程目录/教程.Rmd访问

Shiny Server会自动检测目录中的.Rmd文件并在"R Markdown模式"下运行它们。

安全性和资源管理考虑

由于learnr教程允许用户执行任意R代码，部署时需要考虑：

资源限制设置

在Rprofile.site或教程配置中设置资源限制：

options( tutorial.exercise.timelimit = 30, # 设置30秒执行时间限制 tutorial.exercise.evaluator = "forked_evaluator" # 使用子进程执行 )

安全沙箱配置

对于生产环境，建议使用容器化或Linux命名空间来限制访问权限。UNIX系统默认使用forked子进程，防止用户代码修改主服务器进程状态。

性能监控和优化

使用指标分析

shinyapps.io提供了详细的性能监控仪表板，帮助您了解：

• 活跃小时使用情况
• 内存和CPU使用率
• 并发用户数量
• 响应时间统计

shinyapps.io的性能监控仪表板

实际课堂部署经验

根据一位教育工作者的实际经验，在5周统计编程研讨会中：

• 第一个月使用Standard订阅（2000活跃小时）
• 配置5个8GB实例，2个工作进程，10个最大连接
• 第二个月降级到Basic订阅（500活跃小时）
• 根据实际使用调整配置，最终每月仅使用300活跃小时

故障排除和常见问题

依赖包安装问题

如果教程包含需要修复的"错误"代码练习，可能需要安装开发版本的packrat：

devtools::install_github("rstudio/packrat")

并发访问问题

对于连续课程，前一个班级的连接可能会影响后续班级。解决方案：

1. 发布相同教程的不同版本（如"tutorial-2"）
2. 为不同班级提供不同的访问链接
3. 在课程间隙重启应用实例

存储和状态管理

learnr自动保存用户进度，但在服务器部署时需要考虑：

• 浏览器本地存储：默认使用浏览器localStorage
• 自定义存储提供程序：可通过tutorial.storage选项配置
• 用户标识管理：支持HTTP头自定义用户ID

进阶部署选项

自定义事件记录

learnr提供事件系统，可以记录用户交互数据：

options(tutorial.event_recorder = function(tutorial_id, tutorial_version, user_id, event, data) { # 自定义事件记录逻辑 print(paste("事件:", event, "用户:", user_id)) })

外部评估器支持

对于高负载环境，可以使用外部评估器将代码执行分发到专用服务器：

options(tutorial.external.host = "http://evaluator-server:8080")

总结：选择适合您的部署方案

无论选择哪种方案，learnr都能将您的R Markdown文档转化为强大的交互式学习工具。从简单的本地包部署到企业级的RStudio Connect，总有一种方案能满足您的需求。

关键建议：从最简单的方案开始，根据实际需求逐步升级。大多数教育场景可以从shinyapps.io开始，随着用户增长再考虑更复杂的部署方案。

通过本指南，您现在应该能够自信地将learnr教程部署到适合您需求的环境中，让学生和团队成员能够随时随地访问这些交互式学习资源。记住，良好的部署配置不仅能提供流畅的用户体验，还能有效控制成本，让您的教学材料发挥最大价值。

【免费下载链接】learnrInteractive Tutorials with R Markdown项目地址: https://gitcode.com/gh_mirrors/le/learnr