sr258/scorm-h5p

scorm-h5p-wrapper镜像说明

镜像概述

本镜像包含一个NodeJS应用，用于将H5P交互式内容文件打包为SCORM标准格式，解决H5P内容在不支持原生H5P模块的学习管理系统（LMS）中的兼容性问题，同时保障内容使用的隐私性与稳定性。

核心功能

打包优势

• 跨LMS兼容：支持所有SCORM标准的LMS使用H5P内容
• 成绩上报：通过SCORM协议向LMS传递学习成绩
• 隐私保障：无需依赖外部H5P服务，避免数据泄露风险
• 内容自主：可使用LMS未提供的H5P内容类型
• 版本稳定：内容不受H5P核心或库更新影响

打包劣势

• 资源重复：每个包需下载完整H5P库，可能增加加载延迟
• 编辑限制：需在外部平台（如H5P.org）修改内容，无法直接在LMS编辑
• 无自动更新：无法受益于H5P官方的功能与安全更新
• 包体积较大：包含h5p-standalone库，文件尺寸增加

使用场景

• LMS不支持原生H5P模块但兼容SCORM
• 需要离线使用H5P内容，避免依赖外部服务
• 需固定H5P内容版本，防止平台更新导致内容异常

配置说明

环境变量

• PORT：应用运行端口（默认8080）
• USE_STATISTICS：是否启用打包统计日志（true启用）
• STATISTICS_FILE：统计日志文件路径（默认./statistics.csv）

Docker部署示例

Docker Run命令

bash
docker run --name scorm-h5p \
  --env USE_STATISTICS=true \
  --env STATISTICS_FILE=/usr/src/app/logs/log.csv \
  -p 8085:80 \
  -v /home/yourname/scorm-h5p/logs:/usr/src/app/logs \
  sr258/scorm-h5p:1.0

Docker Compose配置

yaml
services:
  scorm-h5p:
    image: sr258/scorm-h5p:1.0
    ports:
      - "8085:80"
    environment:
      - USE_STATISTICS=true
      - STATISTICS_FILE=/usr/src/app/logs/log.csv
    volumes:
      - ./static:/usr/src/app/static  # 替换占位符文件（如隐私政策）
      - ./logs:/usr/src/app/logs      # 存储统计日志

注意事项

• 需替换/static目录下的imprint、隐私政策和许可证占位符文件，建议通过卷挂载实现
• 优先使用LMS原生H5P功能，仅在必要时使用本工具（如无原生支持）
• 统计日志需确保存储路径有写入权限（Docker部署时需挂载对应卷）