fundocker/ashley

OpenEdx LTI讨论论坛镜像文档

镜像概述

本镜像是一个基于LTI（学习工具互操作性）协议的自托管讨论论坛解决方案，专为OpenEdx平台设计。作为OpenEdx内置讨论功能的替代方案，它提供独立部署的课程讨论环境，支持教育机构通过自托管方式管理课程讨论数据，确保数据隐私与自主控制。

核心功能与特性

核心功能

• LTI协议集成：与OpenEdx平台无缝对接，支持通过LTI 1.1/1.3协议实现单点登录和课程数据同步
• 讨论论坛基础功能：支持帖子发布、回复、点赞、标签分类、搜索等标准讨论功能
• 自托管架构：数据存储在用户自有服务器，避免第三方平台数据依赖

主要特性

• 数据私有化：所有讨论数据本地存储，符合教育机构数据合规要求
• 轻量化部署：基于Docker容器化设计，部署流程简单，资源占用低
• 灵活配置：支持自定义界面样式、权限控制、讨论区规则等
• 跨平台兼容：理论上支持所有兼容LTI协议的学习管理系统（LMS），优先适配OpenEdx

使用场景与适用范围

适用场景

• OpenEdx平台用户需要替代内置讨论功能的场景
• 教育机构对讨论数据隐私有严格要求，需自托管的场景
• 课程讨论量较大，需要独立扩展资源的OpenEdx部署环境
• 需定制讨论区功能（如特殊权限、审核流程）的教育平台

适用范围

• 高等教育机构的在线课程平台
• 企业内部培训系统（基于OpenEdx构建）
• 慕课（MOOC）平台运营商
• 其他使用OpenEdx或兼容LTI协议的LMS系统的组织

使用方法与配置说明

前提条件

• 已部署OpenEdx平台（如Ironwood、Juniper或更高版本）
• 服务器需支持Docker及Docker Compose
• 网络环境需开放LTI通信端口（通常为443或自定义端口）

快速部署（Docker Run）

bash
docker run -d \
  --name openedx-lti-discussion \
  -p 8080:80 \
  -e LTI_CLIENT_KEY="your_lti_key" \
  -e LTI_CLIENT_SECRET="your_lti_secret" \
  -e OPENEDX_BASE_URL="https://your-openedx-instance.com" \
  -e DATABASE_URL="sqlite:///data/discussion.db" \
  -v ./discussion-data:/data \
  your-registry/openedx-lti-discussion:latest

Docker Compose配置示例

yaml
version: '3'
services:
  discussion-forum:
    image: your-registry/openedx-lti-discussion:latest
    container_name: openedx-lti-discussion
    ports:
      - "8080:80"
    environment:
      - LTI_CLIENT_KEY=your_lti_key
      - LTI_CLIENT_SECRET=your_lti_secret
      - OPENEDX_BASE_URL=https://your-openedx-instance.com
      - DATABASE_URL=postgres://user:password@db:5432/discussion
      - LOG_LEVEL=info
    volumes:
      - ./discussion-data:/data
    depends_on:
      - db

  db:
    image: postgres:13
    volumes:
      - postgres-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=discussion

volumes:
  postgres-data:
  discussion-data:

环境变量配置说明

OpenEdx平台LTI配置步骤

1. 登录OpenEdx管理员后台，进入站点管理 > 高级设置 > LTI消费者
2. 点击添加LTI消费者，填写以下信息：
   • 消费者密钥：与容器环境变量LTI_CLIENT_KEY一致
   • 消费者密钥：与容器环境变量LTI_CLIENT_SECRET一致
   • LTI启动URL：http://<容器IP>:<映射端口>/lti/launch（如https://discussion.your-institution.com/lti/launch）
   • LTI内容URL：http://<容器IP>:<映射端口>/
3. 启用允许评分和允许深度学习分析（可选）
4. 保存配置后，在课程中添加LTI组件，选择刚配置的LTI消费者即可访问讨论论坛

注意事项

• 生产环境建议使用HTTPS协议，可配合Nginx反向代理实现SSL终止
• 数据库推荐使用PostgreSQL（而非默认SQLite）以提高性能和可靠性
• 定期备份挂载的discussion-data目录，防止数据丢失
• LTI密钥和密钥需妥善保管，避免泄露导致未授权访问