Moodle 界面介绍+安装教程
背景:Moodle是全球开源学习平台LMS,仓库为官方镜像,采用PHP开发,遵循GPL-3.0协议;本次介绍以Moodle 5.3beta版本(开发版,仅用于测试,不建议生产环境)
一、界面介绍
Moodle采用角色权限驱动界面,不同账号(管理员/教师/学生)看到的菜单、功能完全不同,整体分为仪表盘主页、课程页面、站点管理、侧边导航四大区域,支持电脑+移动端自适应。
1. 仪表盘(Dashboard / 我的主页,登录后首页)
所有人登录默认进入仪表盘,是个性化首页:
- 我的课程:展示已加入的课程,分为进行中、历史课程;
- 时间线/日程:作业截止、测验时间、课程活动提醒;
- 消息通知:论坛回复、教师批改提醒、系统公告;
- 自定义区块:待办任务、日历、最新公告,管理员可配置区块布局。
2. 学生视角界面
学生只能浏览课程资源、提交作业、参与活动,无编辑权限
- 课程主页:章节化展示课件、视频、文档资源;
- 活动模块:作业提交、在线测验、论坛讨论、问卷、互评任务;
- 成绩页:查看个人得分、教师评语(教师开启才可见);
- 消息:私信、课程论坛互动。
3. 教师视角界面
教师拥有课程内全部编辑权限,在学生界面基础上增加编辑模式开关
- 打开「编辑模式」:可以新增章节、上传资源、添加活动(作业/考试/论坛);
- 参与者管理:添加/移除学生、分配助教角色;
- 成绩簿:批量阅卷、设置评分标准、导出全班成绩;
- 活动管理:设置测验时间、截止日期、作业提交规则、开启学生互评。
4. 管理员界面(站点管理员)
拥有整个平台最高权限,多出【站点管理】菜单
- 用户管理:批量新建账号、导入用户、角色分配;
- 课程管理:新建课程分类、管理全部课程;
- 插件管理:安装/卸载第三方插件、主题;
- 服务器配置:邮件、安全设置、PHP环境检查、站点全局参数;
- 备份与恢复:全站备份、课程备份。
5. 通用导航结构
- 顶部导航栏:站点名称、通知、个人头像、设置、退出登录;
- 侧边抽屉菜单:我的课程、个人资料、成绩、消息;
- 课程内:章节列表 + 课程资源与活动;
- 支持多语言包,可以切换中文界面。
核心特点:模块化,所有教学功能都是独立活动模块,可按需开启,支持插件扩展。
二、安装教程
⚠️ 重要提醒:5.3beta是开发测试版本,不要用于正式生产教学环境;生产环境请下载稳定版。 源码来源:GitHub moodle/moodle 镜像仓库,镜像源 git://git.moodle.org/moodle.git
✅ 1. 环境前置要求(5.3beta)
- Web服务器:Apache / Nginx
- PHP:PHP 8.3,必须开启扩展:intl、zip、gd、curl、mbstring、xml、soap、opcache、exif
- 数据库三选一:
- 目录:moodledata 数据目录(存放上传课件、作业,不能放在网站根目录,给予读写权限)
- 内存建议 ≥1GB,磁盘预留至少5GB空间
✅ 2. 获取Moodle源码(两种方式)
方式A:Git拉取源码(推荐,方便后续更新,对应GitHub仓库)
# 克隆官方镜像仓库
git clone [https://github.com/moodle/moodle.git](https://github.com/moodle/moodle.git)
cd moodle
# 切换到main分支(5.3beta开发分支)
git checkout main
网页访问根目录为 moodle/public 文件夹(新版本入口变更)
方式B:下载zip压缩包
访问仓库下载源码压缩包,解压到网站目录。
✅3. 服务器目录与权限配置(Linux示例)
- 将源码放到网站目录,例如
/var/www/moodle - 创建独立数据目录(禁止放在public网页目录)
mkdir /var/www/moodledata
# 设置所属用户为web服务用户,赋予读写权限
chown www-data:www-data /var/www/moodledata
chmod 770 /var/www/moodledata安全要点:moodle程序源码仅给web服务器读权限,只有moodledata目录需要读写权限。
✅4. 创建数据库
以PostgreSQL17 / MariaDB为例:
- 创建数据库(推荐字符集
utf8mb4) - 创建数据库用户,并授予该库全部权限
✅5. 浏览器网页安装(可视化向导)
- 浏览器访问
http://你的域名/public,自动进入安装向导 - 选择语言(可下载中文语言包)
- 环境自检页面:自动检测PHP版本、扩展、目录权限,全部通过才能下一步;缺少扩展需要先安装PHP扩展并重启web服务
- 数据库配置:填写数据库类型、地址、库名、账号密码
- 设置站点名称、管理员账号密码(记住管理员账号)
- 确认版权协议 GPLv3,等待数据库表自动创建
- 安装完成,进入登录页面,使用管理员账号登录
安装成功后,根目录自动生成 config.php 配置文件(复制模板 config-dist.php 生成)
✅ 备选:命令行CLI安装(仓库内 admin/cli/install.php,适合服务器无人值守)
php /var/www/moodle/admin/cli/install.php按提示填写站点、数据库、管理员信息,无需浏览器。
✅6. 安装后基础配置
- 登录管理员账号,进入【站点管理】
- 安装中文语言包,切换站点为中文
- 配置SMTP邮件服务器(通知、重置密码需要邮件)
- 调整PHP参数(
php.ini)
memory_limit = 512M
upload_max_filesize = 128M
post_max_size = 128M
max_execution_time = 600
max_input_vars = 5000修改后重启Apache/Nginx。
三、常见安装报错排查
- PHP版本过低/缺少扩展:环境检查页面直接提示,安装对应PHP扩展,重启web服务
- moodledata权限错误:目录不可写,检查目录所有者与chmod权限
- 数据库连接失败:核对数据库地址、账号密码,确认用户有该库权限
- 500错误:查看web服务器日志,多半是PHP配置、目录权限问题
- 安装完成后不要删除config.php,这是核心配置文件
四、部署方案补充(二选一)
- 自建服务器部署(上面教程):私有化部署,数据自主可控,适合学校、企业;
- MoodleCloud托管:无需自己搭建服务器,官方提供SaaS托管,开箱即用。