Banner

Moodle 界面介绍+安装教程

2026-09-18
背景:Moodle是全球开源学习平台LMS,仓库为官方镜像,采用PHP开发,遵循GPL-3.0协议;本次介绍以Moodle 5.3beta版本(开发版,仅用于测试,不建议生产环境)

一、界面介绍

Moodle采用角色权限驱动界面,不同账号(管理员/教师/学生)看到的菜单、功能完全不同,整体分为仪表盘主页、课程页面、站点管理、侧边导航四大区域,支持电脑+移动端自适应。

1. 仪表盘(Dashboard / 我的主页,登录后首页)

所有人登录默认进入仪表盘,是个性化首页:

  • 我的课程:展示已加入的课程,分为进行中、历史课程;
  • 时间线/日程:作业截止、测验时间、课程活动提醒;
  • 消息通知:论坛回复、教师批改提醒、系统公告;
  • 自定义区块:待办任务、日历、最新公告,管理员可配置区块布局。

2. 学生视角界面

学生只能浏览课程资源、提交作业、参与活动,无编辑权限

  1. 课程主页:章节化展示课件、视频、文档资源;
  2. 活动模块:作业提交、在线测验、论坛讨论、问卷、互评任务;
  3. 成绩页:查看个人得分、教师评语(教师开启才可见);
  4. 消息:私信、课程论坛互动。

3. 教师视角界面

教师拥有课程内全部编辑权限,在学生界面基础上增加编辑模式开关

  • 打开「编辑模式」:可以新增章节、上传资源、添加活动(作业/考试/论坛);
  • 参与者管理:添加/移除学生、分配助教角色;
  • 成绩簿:批量阅卷、设置评分标准、导出全班成绩;
  • 活动管理:设置测验时间、截止日期、作业提交规则、开启学生互评。

4. 管理员界面(站点管理员)

拥有整个平台最高权限,多出【站点管理】菜单

  • 用户管理:批量新建账号、导入用户、角色分配;
  • 课程管理:新建课程分类、管理全部课程;
  • 插件管理:安装/卸载第三方插件、主题;
  • 服务器配置:邮件、安全设置、PHP环境检查、站点全局参数;
  • 备份与恢复:全站备份、课程备份。

5. 通用导航结构

  1. 顶部导航栏:站点名称、通知、个人头像、设置、退出登录;
  2. 侧边抽屉菜单:我的课程、个人资料、成绩、消息;
  3. 课程内:章节列表 + 课程资源与活动;
  4. 支持多语言包,可以切换中文界面。
核心特点:模块化,所有教学功能都是独立活动模块,可按需开启,支持插件扩展。

二、安装教程

⚠️ 重要提醒: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示例)

  1. 将源码放到网站目录,例如 /var/www/moodle
  2. 创建独立数据目录(禁止放在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为例:

  1. 创建数据库(推荐字符集 utf8mb4)
  2. 创建数据库用户,并授予该库全部权限

✅5. 浏览器网页安装(可视化向导)

  1. 浏览器访问 http://你的域名/public,自动进入安装向导
  2. 选择语言(可下载中文语言包)
  3. 环境自检页面:自动检测PHP版本、扩展、目录权限,全部通过才能下一步;缺少扩展需要先安装PHP扩展并重启web服务
  4. 数据库配置:填写数据库类型、地址、库名、账号密码
  5. 设置站点名称、管理员账号密码(记住管理员账号)
  6. 确认版权协议 GPLv3,等待数据库表自动创建
  7. 安装完成,进入登录页面,使用管理员账号登录
安装成功后,根目录自动生成 config.php 配置文件(复制模板 config-dist.php 生成)

✅ 备选:命令行CLI安装(仓库内 admin/cli/install.php,适合服务器无人值守)

php /var/www/moodle/admin/cli/install.php

按提示填写站点、数据库、管理员信息,无需浏览器。

✅6. 安装后基础配置

  1. 登录管理员账号,进入【站点管理】
  2. 安装中文语言包,切换站点为中文
  3. 配置SMTP邮件服务器(通知、重置密码需要邮件)
  4. 调整PHP参数(php.ini)
memory_limit = 512M
upload_max_filesize = 128M
post_max_size = 128M
max_execution_time = 600
max_input_vars = 5000

修改后重启Apache/Nginx。

三、常见安装报错排查

  1. PHP版本过低/缺少扩展:环境检查页面直接提示,安装对应PHP扩展,重启web服务
  2. moodledata权限错误:目录不可写,检查目录所有者与chmod权限
  3. 数据库连接失败:核对数据库地址、账号密码,确认用户有该库权限
  4. 500错误:查看web服务器日志,多半是PHP配置、目录权限问题
  5. 安装完成后不要删除config.php,这是核心配置文件

四、部署方案补充(二选一)

  1. 自建服务器部署(上面教程):私有化部署,数据自主可控,适合学校、企业;
  2. MoodleCloud托管:无需自己搭建服务器,官方提供SaaS托管,开箱即用。
19