部署指南：用 Tutor 安装 Open edX

Tutor 是官方维护的 Open edX 安装与运维工具，基于 Docker，大幅降低了部署门槛。本文覆盖从裸机到可访问平台的完整流程。

1. 系统要求

• 操作系统：Ubuntu 22.04 / Debian 12 等 Linux 发行版（推荐）
• 内存：最低 4GB，推荐 8GB 及以上（平台组件较多，内存不足会明显卡顿）
• 磁盘：至少 30GB（含 Docker 镜像与媒体文件）
• 软件：Python 3.8+、Docker 与 Docker Compose
• 域名：生产部署需要域名并正确解析（LMS / CMS / PREVIEW 三个子域）

2. 安装 Docker 与 Tutor

# 安装 Docker（Ubuntu 为例）
curl -fsSL https://get.docker.com | sh

# 安装 Tutor（独立 Python 环境，避免污染系统）
python3 -m venv ~/.tutor
~/.tutor/bin/pip install "tutor[full]"
sudo ln -s ~/.tutor/bin/tutor /usr/local/bin/tutor

# 验证
tutor --version

3. 启动平台

# 交互式启动：设置平台名、域名、语言等
tutor local launch

# 常用管理命令
tutor local status        # 查看各组件状态
tutor local stop          # 停止
tutor local logs -f lms   # 跟踪 LMS 日志

首次启动会拉取全部镜像并初始化数据库，视网络情况需要 20 分钟到 1 小时。完成后访问 http://你的域名（或服务器 IP）即可看到 LMS 首页。

4. 创建管理员账号

tutor local do createuser --staff --superuser admin your@email.com

5. HTTPS 证书

Tutor 集成了 Caddy 反向代理，默认支持自动申请 Let's Encrypt 证书：

# 在 tutor local launch 时启用 HTTPS，或修改配置
tutor config save --set ENABLE_HTTPS=true
tutor local launch

6. 常见问题

6.1 启动时拉取镜像超时

国内服务器访问 Docker Hub 可能很慢，可配置镜像加速器，或使用代理；镜像拉取不完整时可用 docker pull 重试对应镜像。

6.2 内存不足导致组件频繁重启

检查 free -h 与 docker stats，4GB 以下机器建议加 swap（4-8GB）缓解，正式使用建议升配。

6.3 修改域名 / 平台名称后不生效

配置修改后需要重新生成并重启：tutor config save 之后执行 tutor local launch。

6.4 想做开发调试

改代码热更新用 Dev 启动模式：tutor dev start -d，配合 tutor dev runserver lms。

平台跑起来之后，下一步阅读课程制作开始建课。