Open edX 部署从依赖装不上到生产上线的 6 个卡点【免费下载链接】openedx-platformThe Open edX LMS Studio, powering education sites around the world!项目地址: https://gitcode.com/GitHub_Trending/ed/openedx-platformOpen edX 是一个开源在线教育平台由两个独立 Django 工程组成LMS 面向学生提供课程与学习管理CMSStudio面向教师提供课程内容创作。它不是单进程应用而是一套包含 MySQL、Mongo、Memcached、Meilisearch 和若干前端资源的组合所以跑起来和能上线之间隔着大量容易踩坑的环节。这篇文章按部署中真正会把人卡住的点组织覆盖裸机环境、LMS/CMS 启动、性能与安全配置、故障排查和扩展接口适合准备落地开源学习平台的技术负责人与运维工程师。先解决依赖装不全Python 3.12、Node 与前端构建裸机部署的基线是 Python 3.12、Node.js、MySQL、Mongo、Memcached 和 Meilisearch缺一个都会在后面某个环节暴露出来。依赖分两层装顺序不能反pip install -r requirements/edx/development.txt装完 Python 依赖再编译前端依赖清单目录里的base.txt是运行时基线development.txt额外带开发工具按你实际用途选。npm clean-install npm run build-dev用npm clean-install而不是npm install是为了删掉可能过期的node_modules保证可复现不先编译 webpack bundle页面静态资源就全是 404。数据库迁移的三个坑两个库、Meilisearch 时序、重索引初始化不是两条命令就结束的事。LMS 有两个库要迁移Studio 搜索索引还依赖迁移时的钩子python manage.py lms --settingsdevelopment migrate python manage.py lms --settingsdevelopment migrate --databasestudent_module_history python manage.py cms --settingsdevelopment migrate⚠️ Meilisearch 必须在cms migrate之前起好因为索引由 post-migrate 钩子创建漏掉的后果不是迁移报错而是之后建索引时报 primary key inference failed只能重启 Meilisearch 重跑cms migrate再执行reindex_studio补救。LMS 和 CMS 起不来的排查顺序按依赖链排查不要从报错信息反推。先确认 MySQL、Mongo、Memcached 三个服务都活着再起服务python manage.py lms --settingsdevelopment runserver local.openedx.io:8000 python manage.py cms --settingsdevelopment runserver studio.local.openedx.io:8001local.openedx.io这类域名解析到 127.0.0.1但能让 cookie、CORS、CSRF 跨域行为更接近生产比localhost:端口少踩一类坑。Studio 通过 OAuth SSO 登录 LMS要建 worker 账号和应用python manage.py lms --settingsdevelopment manage_user studio_worker studio_workerexample.com --unusable-password python manage.py lms --settingsdevelopment create_dot_application studio-sso-id studio_worker \ --grant-type authorization-code --skip-authorization --scopes user_id⚠️ 带--skip-authorization的应用只在开发环境用生产照抄会让认证裸奔。开发环境DEBUG True时静态资源直接从源码目录提供不用跑collectstatic省掉一整类静态文件同步问题。生产上线前必须对齐的配置进入生产第一件事是换配置模块开发走--settingsdevelopment生产环境配置叠加在 LMS 公共配置基线 之上差异定义在 lms/envs/production.py 与 cms/envs/production.py。gunicorn worker 数等进程配置分别在 lms/docker_lms_gunicorn.py 和 cms/docker_cms_gunicorn.py不调整的话 worker 默认值撑不住真实并发。生产切换必须核对的四个配置项CACHES指向 Memcached 而不是进程内缓存否则多 worker 之间缓存互不可见重复请求照样穿透到数据库。DATABASES指向真正的 MySQL 实例开发配置里的本地库不能带到生产。SECRET_KEY与 OAuth client-secret 走环境变量注入写死在代码库里等于把密钥公开。SESSION_COOKIE_SECURE、CSRF_COOKIE_SECURE打开强制 Cookie 只走 HTTPS避免会话被中间链路窃取。Open edX 性能调优的三个落点LMS 和 CMS 是两个独立 Django 进程各自起 gunicorn worker 池互不干扰压测时也要分开打。调优优先级从高到低CACHES接 Memcached 之后重复请求不再穿透到 MySQL这是收益最大的一项。webpack-stats.json由npm run build-dev生成后前端资源可被浏览器长缓存静态资源路径不对时先查这份 manifest 是否新鲜。查页面慢先在浏览器 Network 面板区分是后端响应慢还是前端资源慢再决定动数据库还是动构建产物。想改但不知道改哪XBlock、主题与 API 扩展Open edX 提供三类扩展入口对应三种常见诉求自定义学习组件走 XBlock 标准以 XBlock 形式挂进课程docs/concepts/extension_points.rst 列了官方支持的扩展点清单改组件前先看这里能避免自己造轮子。改外观去 themes/ 目录每个主题分lms/和cms/两侧放 scss 与模板只改一侧会导致学生端和教师端风格不一致。系统间数据交互走 DRF APIdocs/lms-openapi.yaml 是 LMS 侧 API 的完整 schema可以直接拿给前端做契约联调。现在就可以做的下一步打开 lms/envs/development.py 和 cms/envs/development.py把MEILISEARCH_MASTER_KEY等变量与你本机服务对齐然后运行python manage.py lms --settingsdevelopment runserver local.openedx.io:8000用浏览器访问 8000 端口验证 LMS 是否就绪。【免费下载链接】openedx-platformThe Open edX LMS Studio, powering education sites around the world!项目地址: https://gitcode.com/GitHub_Trending/ed/openedx-platform创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考