简介：这份资源是一份针对Moodle在线学习平台的系统使用说明，面向需要搭建和管理在线课程的教师、培训师及课程管理员，帮助读者快速掌握在课程中添加文本页、编写网页、链接到文件或站点、插入标签等核心资源功能。资源共包含1个doc文档，整体大小约9.02MB，采用分章节图文编排，目录清晰，适合按需查阅。文档从基础的资源添加与呈现讲起，逐步深入程序教学与测验、BBS与投票、WIKI等特色模块，对各项功能的界面入口、编辑方式、格式设置及保存修改均给出详细说明，并配有大量界面截图和示例步骤。内容覆盖了资源管理的关键场景，无论初次接触Moodle的教师，还是希望系统梳理资源功能的使用者，都能从中获得可落地的操作指引，有效提升在线课程建设效率。已有358人学习浏览。
1. 别把 Moodle 当网站装：先搞清它到底解决什么问题
很多团队第一次接触 Moodle，是把它当成“搭个在线学习网站”来立项的。装上、跑通、放几门课，以为事情就结束了。等真正用起来才发现，课程归档、作业提交、成绩导入、权限隔离、定时任务，每一个环节都在等着填坑。Moodle 的定位不是内容展示站，而是一套带完整教学流程的学习管理系统，课程、用户、角色、活动、评分、日志是一体的。只有从“教学管理闭环”的角度去理解它，后续的部署参数和配置选项才有了判断依据。
这篇说明面向两类人：一类是负责部署和运维的工程师，需要在半天内把环境搭好并交付给业务方；另一类是教学管理员或老师，需要建课、批量导入学生、发布作业和测验。两边的诉求可以在一套系统里共存，但各自的入口、权限和操作路径完全不同，搞清楚这个分工，才是“使用说明”的第一步。
2. 最小可用部署：从空服务器到登录页的完整链路
2.1 部署方式怎么选：源码手动装还是容器编排
Moodle 本质是一套 PHP 应用，核心依赖是 Web 服务器、PHP 扩展和数据库。官方支持的组合很多，但常见的生产路径基本收敛成两种：传统 LNMP 手动部署，以及 Docker Compose 方式编排。前者适合需要精细控制 PHP 参数和目录权限的团队，后者适合快速起环境、便于整体迁移的团队。我在实际项目里两种都试过，结论是：如果只是内部培训用、机器不多，手动部署反而更好排错；一旦涉及多节点或频繁迁移，容器方案省心得多。
手动部署的常见做法是 nginx + PHP-FPM + MariaDB。Moodle 对 PHP 版本有明确要求，太低跑不动最新版，太高又会触发弃用警告，建议先确认你下载的 Moodle 版本对应的 PHP 兼容范围，再决定系统里的 PHP 版本。数据库方面，MariaDB 和 MySQL 都可以，字符集要固定为 utf8mb4，否则中文内容可能出现乱码。Web 服务器选 nginx 还是 Apache 没有本质差别，关键在 PHP 的max_input_vars、post_max_size、upload_max_filesize三个参数，直接决定批量导入用户和上传大文件会不会翻车。
2.2 手动部署的命令序列：依赖、建库、解压、改权限
下面这套命令基于 Debian/Ubuntu 系的系统，按顺序执行即可得到一个可安装的 Moodle 环境。先把基础依赖装齐，再建数据库和专用系统用户，最后解压源码并修正目录权限。
# 安装 PHP 及 Moodle 运行所需的扩展 apt update apt install -y nginx mariadb-server php-fpm php-mysql \ php-xml php-mbstring php-curl php-zip php-gd \ php-intl php-soap php-ldap php-apcu # 启动 MariaDB 并创建 Moodle 专用库和账号 systemctl start mariadb mysql -e "CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;" mysql -e "CREATE USER 'moodle_user'@'localhost' IDENTIFIED BY 'your_strong_password';" mysql -e "GRANT ALL PRIVILEGES ON moodle.* TO 'moodle_user'@'localhost';" mysql -e "FLUSH PRIVILEGES;" # 下载并解压 Moodle 源码 cd /var/www wget https://download.moodle.org/download.php/direct/stable401/moodle-latest-401.tgz tar -xzf moodle-latest-401.tgz # 创建数据目录并调整属主，Web 用户必须能写 mkdir -p /var/moodledata chown -R www-data:www-data /var/www/moodle /var/moodledata chmod -R 755 /var/www/moodle这套命令里有两个细节容易踩坑。数据库的utf8mb4_unicode_ci排序规则必须指定，否则安装向导可能直接报字符集错误；/var/moodledata目录不要放在 Web 可访问的根目录下，否则用户上传的作业和头像可能被直接下载，属于严重的安全隐患。www-data是 nginx 和 PHP-FPM 默认的运行用户，目录属主和 Web 用户不一致会导致安装向导无法生成config.php。
参数说明：数据库账号的密码强度建议至少 16 位混合字符；moodle_user的权限只需要这个库的全部权限，不需要全局权限；moodle-latest-401.tgz中的401对应 Moodle 4.1 版本系列，如果你要用其他版本，把 URL 里的版本号换掉即可。
2.3 Web 服务器配置和 PHP 参数：没有这些，安装向导会半路罢工
Moodle 安装向导对 PHP 环境的敏感程度远高于普通 Web 应用。最典型的问题是文件上传大小限制：默认upload_max_filesize只有 2M，后续上传课程备份或批量导入 CSV 时基本必挂。post_max_size至少要大于upload_max_filesize，max_input_vars默认 1000 对 Moodle 的课程设置表单来说也不够用，建议直接调到 5000 以上。
; /etc/php/8.1/fpm/php.ini 中需要改动的参数 memory_limit = 256M max_execution_time = 300 post_max_size = 128M upload_max_filesize = 64M max_input_vars = 5000 ; 开启 opcache 对 PHP 性能提升明显 opcache.enable = 1 opcache.memory_consumption = 128 opcache.max_accelerated_files = 10000max_execution_time在安装阶段尤其关键，Moodle 初始化数据库表结构时会执行大量 SQL，超过 30 秒就可能超时中断。memory_limit不能低于 128M，否则安装向导在加载语言包时会白屏。改完 PHP 参数后记得重启 PHP-FPM 服务，否则配置不生效。
nginx 站点配置里还需要额外处理两个逻辑：一是把请求统一转发到index.php，二是对/var/moodledata做显式拒绝访问。前者是 Moodle 路由正常工作的前提，后者是安全底线。我习惯在 server 块里加一条location ^~ /moodledata { deny all; }之类的规则，具体路径按你的实际部署目录调整。
2.4 安装向导：填三项配置，创建管理员
浏览器里访问服务器 IP 或域名，会自动跳转到/install.php。安装向导第一步是选择语言，中文在列表里可以直接找到。接下来需要确认的只有三类信息：数据目录路径/var/moodledata、数据库类型和连接信息、管理员账号。
数据库连接信息要和 2.2 节创建的一致：数据库名moodle、用户名moodle_user、密码填设好的强密码。如果填错，向导会给出明确的连接错误提示，不需要额外排查。管理员账号是系统的最高权限入口，用户名建议不用默认的admin，用moodle_admin之类的业务名，降低被暴力猜测的风险。密码要求至少 8 位且包含大小写和数字，这是 Moodle 的硬性校验。
安装过程会持续数分钟，期间页面会显示正在安装的插件列表。这个阶段最容易翻车的不是数据库写入，而是 PHP 扩展缺失导致的中途报错。前面 2.1 节列出的扩展一个都不要省，特别是php-intl和php-soap，前者影响多语言排序，后者是某些外部认证插件的前置依赖。
3. 把权限和课程结构理清楚：建课、批量导人与角色分配的三件套
3.1 角色模型：管理员、教师、学生不是写死的三种人
Moodle 的角色机制是“上下文 + 角色”两层嵌套。同一个用户可以在这个课程里是教师，在另一个课程里是学生，同一门课里对不同活动模块还可能有不同权限。理解这一点，就不会在配置权限时到处找“全局开关”。
系统内置了几种基础角色：管理员（Administrator）、课程创建者（Course creator）、教师（Teacher）、无编辑权限教师（Non-editing teacher）、学生（Student）、访客（Guest）。实际使用中我一般只改两类设置：一类是“课程创建者”默认允许哪些用户类别的人建课，另一类是教师在课程里的权限范围（比如是否允许上传自己的课程备份）。大多数教学场景不需要自定义角色，直接用内置角色加“系统-权限”覆盖就能解决。
3.2 创建课程：格式选得好，老师少吵架
课程格式直接决定老师每天看到的界面结构。Moodle 提供了星期格式、话题格式、社区格式、单活动格式四种默认选项。星期格式按每周一个板块自动生成，适合开课周期明确的学期制课程；话题格式是一组独立主题，适合自学或培训项目；单活动格式更像任务入口，适合考试或作业发布。多数内部培训项目我用话题格式，因为培训内容不见得每周固定推进，按模块排布更灵活。
创建路径：“网站管理 → 课程 → 添加新课程”。需要重点填写的字段包括：课程全称、课程简称、课程分类、课程格式、完成追踪。课程全称是老师搜索时的关键词来源，建议按“项目名 + 批次 + 培训主题”的规律命名；课程简称会在导航栏和成绩册里显示，越短越好。完成追踪默认关闭，如果后续要用到活动完成和徽章功能，必须在创建时就开启，课程建成后改这个东西会比较绕。
课程名称：产品交付流程培训-2025Q1 课程简称：deliver-q1 课程分类：内部培训/产品线 课程格式：话题格式 完成追踪：开启 隐藏状态：显示3.3 批量导入用户：CSV 的列名和行格式有严格约定
小规模使用可以手动逐个创建用户，一旦超过三十人就必须走批量导入，否则建账号就能耗掉一个下午。Moodle 的批量导入入口在“网站管理 → 用户 → 上传用户”，支持 CSV 格式。CSV 的第一行必须是列名，列名有约定俗成的标准字段，不能用中文替代。最关键的三列是username、email、profile_field_xxx，其中profile_field_前缀用于自定义资料字段。
username,password,firstname,lastname,email,cohort1,role1 zhangsan,Passw0rd!,张三,李四,zhangsan@example.com,2025新人培训,student lisi,Passw0rd!,李四,王五,lisi@example.com,2025新人培训,teacher wangwu,Passw0rd!,王五,赵六,wangwu@example.com,2025新人培训,student密码列如果留空，Moodle 会生成随机密码并通过邮件发送。这个机制在实际项目里经常导致新用户收不到邮件，原因多半是邮件配置没做。所以内部培训我建议直接填统一初始密码，首次登录时强制修改。cohort1列用于把用户加入某个全局用户群，role1用于指定在群组里的角色，两列可以同时存在。CSV 上传后第一步只是预检，会返回问题列表，比如邮箱格式错误、用户名重复，必须把问题清零后再执行导入。
3.4 分组和小组：小组作业与讨论区的隔离基础
课程创建后，第一节课前要做的不是传课件，而是把学生分组。分组功能在“课程管理 → 用户 → 分组”里配置。两种分组模式需要分清：一种是“可见分组”，学生能看到其他小组的存在但内容隔离；另一种是“分隔小组”，小组之间完全看不到彼此，适用于班级内部按项目分组提交作业的场景。
小组作业的配置路径在作业活动里，“小组提交”模式打开后可以指定“每个小组成员提交一份作业，小组评分共享”或“每个小组提交一份，评分后所有成员可见”。这个设置课堂里极易混淆，教师以为开了分组就算完，结果学生进了作业页面看不到“提交”按钮，实际原因就是“可见分组”模式限制了跨组内容。
4. 教学活动的核心操作：作业、测验、评分册的完整配置链路
4.1 作业模块：提交类型、截止时间、开启条件三个必调参数
Moodle 的作业活动支持在线文本、文件提交、文本和文件混用等多种模式。教师创建作业时，最常忽略的是“开启条件”和“尝试次数”这对组合。默认情况下作业创建后立即接受提交，如果希望学生在某个时间点之前不能提交，必须设置“开启时间”和“截止时间”双约束。
我习惯帮老师在作业配置页里把参数固定成一套模板：允许提交次数设为 3 次，学生可以覆盖旧版本；截止时间设为课程结束前一天的 23:55；反馈类型同时开启文件和文本反馈。这套模板的好处是：多次提交降低学生误传文件的概率，文本反馈让学生能直接在站内看到批改意见，不用回邮件。作业批改完成后，成绩自动进入成绩册，不需要老师手动登记。
提交类型：文件提交 最大文件数：3 最大文件大小：20MB 开启时间：2025-03-01 08:00 截止时间：2025-03-31 23:55 允许尝试次数：3 反馈类型：文件反馈 + 文本反馈文件大小超过 20MB 的作业（比如设计稿、演示视频）建议拆成多文件提交，或者在课程级设置里单列一个“大文件作业”分类，单独调高限制。全局调高上传限制会影响服务器存储压力，不值得为少数大文件拉高全站上限。
4.2 测验模块：题库搭建与试卷生成的两层结构
测验模块的逻辑先于操作：先建题库，再从题库里抽题组卷。题库在课程管理里有独立入口，支持选择题、判断题、填空题、匹配题、简答题等多种题型。最效率的方式不是一道一道在页面里点，而是用 GIFT 格式批量导入。GIFT 是 Moodle 原生支持的文本格式，可以一条一条写在纯文本文件里，上传后自动解析入库。
::第一题::单选：Moodle 的数据库兼容以下哪种？{=MariaDB ~SQL Server ~Oracle} ::第二题::对错题：Moodle 支持自主开发的插件模板。{TRUE} ::第三题::填空：Moodle 默认的数据目录名称是____。{#moodledata}GIFT 格式的语法规则：题目用::包裹标题，题干紧接其后，选项用{...}包裹。单选正确项前用=，干扰项用~；对错题用{TRUE}或{FALSE}；填空题用{#答案}。导入时页面会提示解析结果，有语法错误会在第几行明确标出，修正后重新导入即可，不会留下重复数据。
试卷生成时，关键设置在“随机抽题”。从分类里抽取随机题可以保证每个学生拿到的题目顺序和个别题不同，但抽题数量不要超过题库中该类型题目的总数，否则会报“题目不足”。我一般建议题库容量至少是试卷题量的 3 倍，否则随机效果体现不出来。
4.3 评分册：类别权重与显示格式决定了成绩的最终形态
评分册是一个常被忽略但争议最大的模块。默认情况下，所有活动（作业、测验、论坛评分）都按“最高分”计入总评，这会导致随堂测验和期末考试占同样权重，任何讲得通的教学设计都受不了。正确操作是先在成绩册里开启“类别”，再为不同类别分配权重。
设置路径：“课程管理 → 成绩册设置 → 成绩类别”。常见结构是“平时作业 40%、随堂测验 20%、期末考试 40%”三栏。每建一个作业或测验时，在成绩项设置里指定它隶属的类别。类别权重的计算方式有两种：全部使用等权重、按最高分加权。选“按最高分加权”前一定要确认每个成绩项的满分设定，否则一个满分 10 分的作业会被未做归一化直接按比例放大。
成绩册的显示格式也建议在开课前定好。真实数字模式下，教师看到满分 50 和 43；百分比模式下看到 86%；推荐用“百分比 + 字母等级”组合，学生查看成绩时不用心算，也能直接对应到评价标准。成绩公示前用“学生 → 预览”角色模拟查看一遍，是最有效的验收手段。
5. 避坑清单：几个高频故障的现象、原因与处理顺序
5.1 安装向导白屏且 config.php 无法生成
现象：访问/install.php时页面一片空白，刷新无用，错误日志也没有明显输出。多数情况下是 PHP-FPM 进程崩溃或内存耗尽，而不是 nginx 的问题。原因集中在两点：PHP 版本与 Moodle 版本不兼容，或memory_limit设置达不到向导要求。处理顺序为先看/var/log/php*.log有没有 Out of memory 记录，再确认php -v的版本号。把内存上限先调到 512M、max_execution_time调到 600，重跑安装向导的通过率会高很多。另外，安装前确认php-fpm和nginx运行用户一致，否则config.php生成后目录属主不对，后续升级和插件安装也会遇到写权限问题。
5.2 用户上传 CSV 后提示“找不到列”
现象：CSV 文件第一行的列名和系统要求不符合，或者表头里混入了 UTF-8 BOM 标志。处理办法是在 Linux 上先用file users.csv查看文件编码，有 BOM 的话用sed -i '1s/^\xEF\xBB\xBF//' users.csv去干净。列名必须使用 Moodle 文档里的标准英文字段，可以多导入一列idnumber作为学号，但不要把学号写到username里，否则用户改密或合并账号时会出现匹配困难。CSV 分隔符建议统一使用英文逗号，如果文件是用 Excel 另存的，注意另存时选择“CSV UTF-8”格式，不然中文名会全部变成乱码。
5.3 作业截止了但系统不自动提醒
现象：截止时间到了，学生还能提交作业；或者截止后没有自动发送未提交通知。原因几乎都是 Cron 定时任务没配。Moodle 的大量后台逻辑依赖 Cron 触发，作业截止状态变更、邮件发送、自动评分都在这里。配置方法是在服务器 crontab 里加一条每分钟执行的命令，具体路径是 Moodle 安装目录下的admin/cli/cron.php。命令示例：* * * * * /usr/bin/php /var/www/moodle/admin/cli/cron.php > /dev/null。执行用户用www-data，优先级设置成最低，避免抢占业务进程。手动验证时用php admin/cli/cron.php --keep-alive=5能看到Cron completed字样就说明通道通了。
5.4 上传课程备份时报“压缩包格式错误”
现象：课程备份在本地导入到新环境时提示格式错误或无法识别。绝大多数情况是备份文件和 Moodle 版本不对应。Moodle 的.mbz备份文件有一个版本兼容矩阵，4.0 升到 4.1 基本没问题，但 2.x 的备份直接导进 4.x 大概率失败。处理逻辑不是强行兼容，而是先在旧版本环境里把课程备份恢复一次，再用新版本重新生成备份文件。对于长期保存的课程，建议只导出 XML 格式的课程内容，再加独立的教学资源附件，比整体.mbz存档更耐用。
5.5 页面跳到 HTTPS 后部分资源加载失败
现象：做了全站 HTTPS 改造后，登录页和课程页能打开，但用户头像、课程图片、嵌入的视频显示不出来，浏览器控制台报 Mixed Content 错误。原因有两个：一是站点 URL 还是 HTTP 地址，需要在“网站管理 → 服务器 → HTTP 安全”里把站点地址改为 HTTPS；二是反向代理或负载均衡层没有传递正确的X-Forwarded-Proto头。常规处理是同时修补两处，并把 “安全 → 请求安全” 选项打开。如果 Moodle 跑在容器里，还要检查容器对外暴露的端口是否同时绑定了 80 和 443，很多部署只映射了 80，导致 HTTPS 入口实际不可达。
6. 让备份与恢复可预期：一套手工脚本和三条验证习惯
与其依赖管理后台的图形化备份，我更推荐直接用命令行做两级备份。第一级是数据库，第二级是/var/moodledata数据目录。Moodle 源码目录不需要备份，因为可以通过官方渠道重新下载对应版本，但插件目录需要额外留意，建议把moodle/local和moodle/mod里非官方目录单独打包。
#!/bin/bash # 数据库备份：压缩并保留最近 7 天 BACKUP_BASE=/data/backups/moodle DATE=$(date +%Y%m%d_%H%M) DB_BACKUP="$BACKUP_BASE/db_$DATE.sql.gz" mkdir -p "$BACKUP_BASE" mysqldump -u moodle_user -p'your_password' --single-transaction moodle | gzip > "$DB_BACKUP" # 数据目录备份：排除缓存，因为缓存重建成本低 DATA_BACKUP="$BACKUP_BASE/moodledata_$DATE.tar.gz" tar czf "$DATA_BACKUP" \ --exclude='/var/moodledata/cache' \ --exclude='/var/moodledata/sessions' \ --exclude='/var/moodledata/temp' \ --exclude='/var/moodledata/trashdir' \ -C /var moodledata # 清理 7 天前的备份文件 find "$BACKUP_BASE" -name '*.gz' -mtime +7 -delete备份之后关键是“恢复值得信任”。我的习惯是每个月抽一次恢复演练：把sql.gz解压导进临时数据库，把moodledata.tar.gz解压到临时目录，然后刷新 Moodle 页面确认可以登录。三次有意义的验证分别是：学生能否正常看到作业和提交记录、教师能否进入课程编辑界面、成绩册里历史成绩是否完整。这三点能过，基本可以认为备份是有效的。反之，只备份不验证，真到恢复那一天才发现压缩包损坏，才是最大的翻车现场。
恢复时的顺序也固定：先恢复数据库，再恢复数据目录，最后清一遍 Moodle 缓存目录里的cache和sessions，否则新旧数据一混合，页面会异常缓慢。恢复后记得检查config.php里的$CFG->dataroot路径是否指向新解压的目录。因为多数备份恢复出错都是新版代码读到了旧缓存。备份频率按课程活跃度来定，日常课程至少每天一次数据库备份加每周一次数据目录备份，考试周或作业高峰期可以把两者都调整为每小时跑一次，数据库压力完全可以承受。
这条手工备份脚本我沿用了很长时间，它不依赖任何后台插件，也不需要图形界面，只要系统里能跑 crontab 就没问题。某次服务器迁移，新环境里只有这套脚本救回了全部课程数据，从那以后，我对“备份必须验证恢复”这条习惯格外上心。希望这篇说明能帮你把 Moodle 从“装上了”带到“能放心用”，少走一点弯路。
本文还有配套的精品资源，点击获取
