prairielearn/workspace-jupyterlab

PrairieLearn Docker镜像文档

镜像概述和主要用途

PrairieLearn是一个在线问题驱动的学习系统，旨在为教育场景提供作业和测试创建工具。该Docker镜像提供了PrairieLearn的工作空间环境，特别适用于Jupyter Lab/Notebook，支持教育者创建互动式学习内容，学生进行在线练习，并实现自动化评分和问题随机化。通过容器化部署，确保了环境一致性和跨平台可用性。

核心功能和特性

• 灵活的问题编写：支持使用HTML/JavaScript编写自定义问题，满足多样化的教学需求，如理论题、编程题、图形交互题等。

• 自动评分与随机化：问题可实现随机化生成，动态调整参数以减少作弊风险；内置自动评分机制，支持客观题即时反馈和主观题规则化评分，减轻教师工作量。

• 多任务处理能力：集成客户端和服务器端库，支持图形绘制（如数据可视化）、符号代数运算（如公式推导）、学生代码编译与执行（如Python/Java代码评测）等复杂教学任务。

• Docker化优势：提供标准化部署方式，简化环境配置流程，支持Linux、Windows、macOS等跨平台运行，确保教学环境一致性和版本控制。

使用场景和适用范围

• 教育机构：高校、中学及培训机构用于课程作业布置、在线测试、技能评估等教学活动。

• 教师/教育工作者：创建互动式、个性化的学习问题，自定义评分规则，通过自动评分功能高效处理学生提交，聚焦教学内容优化。

• 学生：在Jupyter Lab/Notebook环境中完成作业和测试，获取即时反馈，通过随机化问题进行强化练习。

• STEM领域教学：尤其适用于计算机科学（代码评测）、数学（公式计算）、物理（图形分析）等需要复杂交互和自动评测的学科。

详细使用方法和配置说明

Docker部署示例

基本运行命令

通过以下命令快速启动PrairieLearn容器：

bash
docker run -d -p 8080:8080 --name prairielearn docker.xuanyuan.run/prairielearn/prairielearn

• -d：后台运行容器
• -p 8080:8080：端口映射，将容器内8080端口映射到主机8080端口，用于Web访问
• --name prairielearn：指定容器名称为prairielearn
• prairielearn/prairielearn：使用官方Docker镜像

数据持久化配置

为避免容器重启后数据丢失，建议挂载本地目录存储问题库和用户数据：

bash
docker run -d -p 8080:8080 \
  -v /path/to/local/questions:/app/questions \  # 挂载本地问题库目录
  -v /path/to/local/data:/app/data \          # 挂载用户数据目录
  --name prairielearn prairielearn/prairielearn

Docker Compose配置（推荐）

创建docker-compose.yml文件实现更灵活的配置：

yaml
version: '3'
services:
  prairielearn:
    image: docker.xuanyuan.run/prairielearn/prairielearn
    ports:
      - "8080:8080"  # Web访问端口
    volumes:
      - ./questions:/app/questions  # 本地问题库目录
      - ./data:/app/data            # 本地数据存储目录
    restart: always  # 容器异常退出后自动重启
    environment:
      - NODE_ENV=production  # 生产环境配置（可选）

启动服务：

bash
docker-compose up -d

访问与配置

容器启动后，通过浏览器访问 http://localhost:8080 进入PrairieLearn Web界面。首次使用需根据引导完成初始配置（如管理员账户设置、课程创建等）。

高级配置（如LDAP认证、邮件通知、负载均衡）及问题编写规范，请参考官方文档：http://prairielearn.readthedocs.io/

相关信息

• 最新版本：https://img.shields.io/github/tag/PrairieLearn/PrairieLearn.svg?label=version](https://github.com/PrairieLearn/PrairieLearn/blob/master/ChangeLog.md)

• Docker构建状态：https://img.shields.io/docker/automated/prairielearn/prairielearn.svg](https://hub.docker.com/r/prairielearn/prairielearn/builds/)

• 许可证：https://img.shields.io/github/license/PrairieLearn/PrairieLearn.svg](https://github.com/PrairieLearn/PrairieLearn/blob/master/LICENSE.md)

• 官方文档：http://prairielearn.readthedocs.io/