简介万岳开源网校源码是面向教培机构、院校及个人开发者的在线教育系统完整源码包基于原生语言开发支持多端互通覆盖教学、学习、管理、互动、营销等模块。可快速搭建大班课、小班课、公开课、双师教学等场景也支持视频直播、语音直播、PPT直播及内容付费适合有二次开发需求或希望低成本落地网校业务的团队。资源共2000个文件压缩包约52.57MB。其中前端以1015个JS、368个HTML、111个CSS为主包含管理后台、学生端、讲师端等界面另有129个JSON、23个XML及8个SQL用于配置与数据库初始化184个MD和154个TXT提供部署与说明文档便于直接浏览、修改和二次开发。资源包含web学生端、App学生端、web管理后台、web讲师端四端源码无需从零搭建注册即可使用。已有281人学习下载适合希望快速获得一套可运营、可扩展的网校系统源码或参考其直播与课程管理实现逻辑的开发者与机构。1. 拿到万岳开源网校源码不等于部署完成真正的工程量在后半段对机构和独立开发者来说“2024最新万岳开源网校源码”的吸引力不只是代码齐全而是它把学生端、讲师端、管理后台和移动端统一到了同一套业务模型里课程、订单、题库、直播课堂全部有对应的后台配置入口。但开源项目交付到你手里时往往是一份完整的 PHP 工程加一串部署步骤真正决定系统能不能上线的是环境适配、直播对齐和二次开发这几个环节任何一步有偏差都会直接表现为前台打不开、播放器黑屏或者支付回调不触发。这篇文章按在线教育平台最常见的 LNMP 部署路径展开从架构拆分、数据库初始化、Nginx 伪静态到多种直播课堂形式大班课、小班互动、点播回放的实现方式都过一遍最后补上生产环境里最容易踩的优化与排错清单。适合做网校系统外包的团队、想自建平台的机构技术负责人以及需要在开源网校系统基础上做二次开发的人。2. 系统架构与工程目录多端复用同一套业务内核2.1 先看懂四端分离的源码布局网校源码刚解压出来第一眼看到的通常不是单一入口而是一套按“端”划分的目录结构。管理者后台、PC 端用户中心、讲师工作台、移动端小程序是四个独立入口但真正负责业务逻辑的只有 PHP 侧的 application 目录和 API 接口层。界面层用 Vue 或 uni-app 构建通过 JWT 或 Token 请求统一接口不做数据直连。这种多端结构的优势很明显课程上下架、价格调整、直播状态变更只需要在后端操作一次四个端看到的数据立刻一致。比如讲师在教师端把某节课标记为“开始直播”学生端实时刷新出直播中状态后台同时落一条直播记录靠的都是共享数据表而不是各自维护状态。提示部署时不要把整个源码目录设为站点根目录。把 public 目录作为运行入口源码中的 config、application 等目录保留在上级避免 PHP 文件和敏感配置被直接通过 URL 访问到。我一般会在拿到源码后先列一个目录盘点把以下几个位置找出来再动手 application 下的控制器层、config 下的数据库与缓存配置、public 下的静态资源入口、install 或 upgrade 目录里的安装脚本。这样后面改路由和配环境时不需要临时翻文件。2.2 核心数据表结构与实践含义网校系统的数据模型虽然各家命名有差异但“用户—课程—章节—订单”这条主链路是固定的。万岳这类开源网校系统里最值得先看的是章节表和直播配置表因为它们直接决定后续直播课堂形式怎么扩展。表/模块承载内容关键字段示例用户表学生、讲师、助教账号user_type、status课程表课程基础信息、售卖配置title、price、status章节表章节课时、直播/录播类型is_live、live_form、start_time订单表订单、支付流水pay_status、pay_time直播记录表直播场次、回放地址room_id、stream_url、replay_url其中“章节表”里的 live_form 类型字段最值得留意它通常用数字区分课堂形式比如 1 表示录播点播、2 表示大班直播、3 表示小班互动。想要在项目里新增一种直播课堂形式只需要扩展这一层数据结构并让前端按类型渲染对应组件。2.3 为什么这么多网校源码选择 PHP 技术栈看到 ThinkPHP 或 Laravel 这类 PHP 框架有些人会觉得不够新但这恰恰是网校类系统的务实选择。PHP 生态对虚拟主机和宝塔面板这类自助运维工具的兼容性极好代码改完上传即可生效不像 Java 或 Go 项目需要先编译打包同时 PHP 的异步任务、队列处理和直播回调都能通过简单脚本完成配合 MySQL 和 Redis 就能支撑包括课程售卖、直播签到、互动消息在内的完整业务闭环。3. 用 LNMP 环境把开源网校源码跑通的最小步骤3.1 环境检查清单与 PHP 扩展无论你在本地用 phpstudy 还是在云服务器上用宝塔面板第一步都是确认环境匹配。比较通行的条件是 PHP 7.4 及以上、MySQL 5.7 及以上、Redis 6.x、Nginx 1.20 及以上。先跑一条命令检查版本php -v mysql --version redis-cli --version nginx -v如果输出版本正常接下来重点是 PHP 扩展是否齐全。网校系统这类开源项目在安装时会校验 fileinfo、redis、opcache、gd、curl 等扩展缺了其中一个就可能卡在安装界面或者后台图片上传失败。提示生产环境通常安全配置会禁用 shell_exec、proc_open 等函数但直播转码、FFmpeg 生成缩略图等功能依赖它们。建议根据实际功能按需放行而不是全部禁用或全部放开。3.2 创建数据库并导入初始化 SQL初始化数据通常放在源码包根目录的 .sql 文件或 install 目录内。先在 MySQL 里创建专用库和账号避免沿用 root 连接CREATE DATABASE edu_course DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; GRANT ALL PRIVILEGES ON edu_course.* TO edulocalhost IDENTIFIED BY YourPass#2024; FLUSH PRIVILEGES;然后命令行导入数据文件把 sql 文件里的表结构和默认配置一次性写入mysql -u edu -p edu_course course.sql导入完成后建议查一下核心表数量确认没有半途中断USE edu_course; SHOW TABLES;3.3 修改 .env 配置文件并生成数据表连接多数 PHP 网校项目会在 .env 文件里维护数据库、Redis、支付等配置项。更改以下关键项DB_HOST127.0.0.1 DB_PORT3306 DB_NAMEedu_course DB_USERedu DB_PASSWORDYourPass#2024 REDIS_HOST127.0.0.1 REDIS_PORT6379 REDIS_PASSWORD这里参数的对应关系是DB_HOST 指 MySQL 所在服务器地址云服务器上如果数据库单独部署需要改成内网 IPDB_NAME 必须和上面 CREATE DATABASE 的名称一致REDIS_PASSWORD 留空表示本机 Redis 未设置认证。任何一项不匹配后台登录或首页读取配置时都会直接报 500。3.4 Nginx 伪静态规则与站点根目录配置PHP 框架的 URL 路由依赖伪静态规则。如果不加这段配置访问首页可能正常但进入课程详情页或直播课堂页面时全部 404。我一般会在 Nginx 站点配置中加入server { listen 80; server_name your-domain.com; root /www/wwwroot/edu/public; index index.php index.html; location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; break; } } location ~ \.php(.*)$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_split_path_info ^(.\.php)(.*)$; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } access_log /www/wwwlogs/your-domain.com.log; error_log /www/wwwlogs/your-domain.com.error.log; }配置要点有两个 root 指向 public 目录不要把入口文件暴露成直接可下载location / 里的 rewrite 规则把不含实际文件的请求全部转给 index.php 处理。下面的 fastcgi 段负责把 .php 请求交给 PHP-FPM 解析PATH_INFO 参数用于兼容框架的路由模式。3.5 目录权限与计划任务源码解压上传后runtime、uploads、backup 这类目录需要写入权限。在 Linux 下用一行命令完成归属变更chown -R www:www /www/wwwroot/edu chmod -R 755 /www/wwwroot/edu同时还需要把计划任务写进 crontab网校系统通常要求每分钟执行一次定时任务用于处理直播状态过期、订单超时关闭等逻辑* * * * * php /www/wwwroot/edu/think schedule:run /dev/null 21这条命令通过 ThinkPHP 的定时器统一触发后台脚本可以避免为每一个定时功能单独写 crontab。部署后测试方式是修改一个订单的过期时间字段看能否在一分钟内被自动关闭。4. 多种直播课堂形式的技术实现与参数选型4.1 大班直播用 RTMP 推流配合 HLS/HTTP-FLV 分发大班直播是最常见的直播课堂形式场景是单讲师向大量学生单向授课不需要频繁连麦互动。技术上通常走“RTMP 推流 播放端多协议分发”路线。讲师端使用 OBS 或移动端推流工具推流地址带上串流密钥服务端用 SRS 或 ZLMediaKit 接收后在转成多种拉流协议。关键参数是推流地址的完整结构rtmp://your-domain.com/live/{stream_id}?token{token}其中 stream_id 对应后台创建直播课堂时生成的房间号token 用于防止推流地址被其他人盗用。播放端用 HTTP-FLV 或 HLS。FLV 延迟低一般在 1 到 3 秒适合互动感要求高的场景HLS 延迟在 5 到 10 秒之间但胜在兼容性和 CDN 分发能力强。我会用前者做主线路后者做兼容降级。4.2 小班互动课堂走 RTC 方案实现连麦与音视频通话小班课、一对一辅导这类直播课堂形式对双向音视频有硬性要求单纯靠 RTMP 推流做不了连麦或白板互动需要引入 WebRTC 或第三方 RTC SDK。开源自建方案偏重 Mesh 架构适合 4 到 6 人的小规模房间超过这个量级就建议用云厂商的 RTC 服务由服务端做合流转码与全网分发。接入方式是在前端初始化 SDK 并加入房间import RTC from some-rtc-sdk; const client RTC.createClient({ mode: rtc, codec: vp8 }); client.init(appId); client.join(roomToken, live-classroom-id).then(() { // 本地采集并发布音视频 return client.createStream({ video: true, audio: true }); }).then(stream { stream.play(local-player); client.publish(stream); });这段代码里的 mode 表示 RTC 模式codec 选择 vp8 是为了兼容大多数浏览器createStream 后调用 publish 把自己的音视频推到房间内其他成员通过 client.subscribe 接收。实际项目中还需要监听远端流的加入和离开事件动态更新画面布局否则可能出现学生进了房间但画面不出现的问题。4.3 直播回调开播、关播、转存回放的接口约定网校平台必须在直播开始和结束时知道状态变化以便前端切换“直播中”到“回放可看”。这个动作依赖直播服务商的回调通知机制。假设回调地址配置为 https://your-domain.com/api/live/callback回调通知处理大致如下public function handleCallback(Request $request) { $data $request-post(); if ($data[event_type] live_start) { // 更新章节状态为直播中 Lesson::where(id, $data[lesson_id])-update([live_status 1]); } elseif ($data[event_type] live_end) { // 回放地址写入 Lesson::where(id, $data[lesson_id])-update([ live_status 2, replay_url $data[replay_url] ]); } return json([code 0]); }要注意的是回放地址字段。大班直播关播后服务商通常需要几秒到几分钟的时间生成回放文件如果回调里没返回 replay_url就需要前端轮询查询或者后端在队列里延迟拉取。4.4 课堂互动聊天室、签到与白板的选型直播课堂形式的完整体验还需要配合互动组件。聊天室一般走 WebSocket 或长连接处理消息的上行广播与进入房间者的历史消息拉取签到和答题可以复用同一套消息通道后台预设签到秒数前端倒计时结束后统计参与人数白板则需要 Canvas 或 SVG 层叠加在视频区域外配合 WebSocket 同步绘制事件由于白板的频繁事件容易造成抖动常见做法是对事件做批量压缩上传每 50 毫秒合并一次。5. 二次开发在开源网校系统上扩展支付、题库和直播管理5.1 控制器与 API 接口的扩展方式开源网校系统的二次开发通常不涉及改框架底层而是在 application 目录下的控制器层新增模块。比如要增加一个“课程顾问”模块在控制器目录中写对应的控制器方法通过路由前缀映射到 URL?php namespace app\api\controller; use think\Request; use think\facade\Db; class Consultant extends Base { public function assign(Request $request) { $userId $request-param(user_id); $referee $request-param(referee_id); // 更新用户的归属顾问影响后续课程佣金分成 Db::name(user)-where(id, $userId)-update([ consultant_id $referee ]); return json([code 0, msg 绑定成功]); } }控制器继承 Base 后自动获得 JWT 登录校验、跨域头、操作日志等公共能力。新方法绑定到对应路由后前端即可通过 POST 请求调用不需要改动现有接口。5.2 支付模块二开把固定商品改成订阅制续费默认网校的订单流程是“选择课程→生成订单→扫码支付”。机构如果要做会员订阅需要在订单表中扩展 plan_id 和 expire_time 字段并在支付成功回调里写入会员到期时间。回调处理中需要先校验订单状态是否是未支付防止重复回调导致用户时长被叠加。5.3 题库和在线考试的二开思路题库模块常见的需求是支持题目批量导入和随机组卷。批量导入用表格模板上传后端解析时逐行校验题目类型和答案格式随机组卷则需要在考试开始时读取题库配置按知识点权重抽题并生成考试记录。这里要注意的是获取答题明细不要全量加载一定要做分页或按试题 ID 范围分段查询。5.4 自定义直播课堂形式的接入如果机构现有直播跨能力来源于自建 SRS 服务而不是用平台默认的云直播需要在后台的直播配置中改推流和拉流地址模板。常见做法是把推流地址和播流地址都做成可配置项用大括号作为占位符push_url rtmp://your-srs-server.com/live/{stream_id} push_key {token} play_url https://your-srs-server.com/live/{stream_id}.flv后台创建直播课堂时不直接生成最终地址而是保存替换后的 URL。前端拿到后拼装播放器地址完成对接。这样替换底层直播服务时只需要后台改配置不用重新发版。6. 直播卡顿、白屏与回调失效的排查方法先看最常见的播放白屏。前端播放器初始化时浏览器自动播放策略要求音频必须由用户交互触发如果初始化代码把播放器放在页面 onload 里执行大概率被浏览器拦截。排查方法是在初始化播放器同时调用 resume并给页面加一个“点击进入课堂”的开始按钮用这个事件去触发播放而不是等页面渲染完毕自动播。直播卡顿优先排查网络链路而不是缓存。用 curl 分别测一下推流域名和播流域名的 TCP 连接时间与首包耗时如果播放端到 CDN 边缘节点的延迟在 100 毫秒以上就要考虑加一层 CDN 动态加速或切换播放协议为 HTTP-FLV。再看回调失效。回调不触发时先到直播服务商后台查看回调记录确认请求是否发到了指定地址如果发了但接收失败检查目标服务器的安全组或防火墙放行策略同时确认回调地址不能被强制跳转 HTTPS。调试阶段可以在回调方法入口写一条日志error_log(json_encode($request-post(), 256), 3, runtime_path() . /callback.log);最后验证部署成果的一个技巧开启课堂后在后台把章节状态从“未开播”改成“直播中”再刷新学生端看状态同步直播结束后主动调用一次回调接口模拟关播数据确认回放地址能写入数据库并在前端展示。整个链路通了网校系统的直播课堂形式才算真正完成闭环。本文还有配套的精品资源点击获取 开源网校LNMP部署实战：直播课堂与二次开发全解析
简介万岳开源网校源码是面向教培机构、院校及个人开发者的在线教育系统完整源码包基于原生语言开发支持多端互通覆盖教学、学习、管理、互动、营销等模块。可快速搭建大班课、小班课、公开课、双师教学等场景也支持视频直播、语音直播、PPT直播及内容付费适合有二次开发需求或希望低成本落地网校业务的团队。资源共2000个文件压缩包约52.57MB。其中前端以1015个JS、368个HTML、111个CSS为主包含管理后台、学生端、讲师端等界面另有129个JSON、23个XML及8个SQL用于配置与数据库初始化184个MD和154个TXT提供部署与说明文档便于直接浏览、修改和二次开发。资源包含web学生端、App学生端、web管理后台、web讲师端四端源码无需从零搭建注册即可使用。已有281人学习下载适合希望快速获得一套可运营、可扩展的网校系统源码或参考其直播与课程管理实现逻辑的开发者与机构。1. 拿到万岳开源网校源码不等于部署完成真正的工程量在后半段对机构和独立开发者来说“2024最新万岳开源网校源码”的吸引力不只是代码齐全而是它把学生端、讲师端、管理后台和移动端统一到了同一套业务模型里课程、订单、题库、直播课堂全部有对应的后台配置入口。但开源项目交付到你手里时往往是一份完整的 PHP 工程加一串部署步骤真正决定系统能不能上线的是环境适配、直播对齐和二次开发这几个环节任何一步有偏差都会直接表现为前台打不开、播放器黑屏或者支付回调不触发。这篇文章按在线教育平台最常见的 LNMP 部署路径展开从架构拆分、数据库初始化、Nginx 伪静态到多种直播课堂形式大班课、小班互动、点播回放的实现方式都过一遍最后补上生产环境里最容易踩的优化与排错清单。适合做网校系统外包的团队、想自建平台的机构技术负责人以及需要在开源网校系统基础上做二次开发的人。2. 系统架构与工程目录多端复用同一套业务内核2.1 先看懂四端分离的源码布局网校源码刚解压出来第一眼看到的通常不是单一入口而是一套按“端”划分的目录结构。管理者后台、PC 端用户中心、讲师工作台、移动端小程序是四个独立入口但真正负责业务逻辑的只有 PHP 侧的 application 目录和 API 接口层。界面层用 Vue 或 uni-app 构建通过 JWT 或 Token 请求统一接口不做数据直连。这种多端结构的优势很明显课程上下架、价格调整、直播状态变更只需要在后端操作一次四个端看到的数据立刻一致。比如讲师在教师端把某节课标记为“开始直播”学生端实时刷新出直播中状态后台同时落一条直播记录靠的都是共享数据表而不是各自维护状态。提示部署时不要把整个源码目录设为站点根目录。把 public 目录作为运行入口源码中的 config、application 等目录保留在上级避免 PHP 文件和敏感配置被直接通过 URL 访问到。我一般会在拿到源码后先列一个目录盘点把以下几个位置找出来再动手 application 下的控制器层、config 下的数据库与缓存配置、public 下的静态资源入口、install 或 upgrade 目录里的安装脚本。这样后面改路由和配环境时不需要临时翻文件。2.2 核心数据表结构与实践含义网校系统的数据模型虽然各家命名有差异但“用户—课程—章节—订单”这条主链路是固定的。万岳这类开源网校系统里最值得先看的是章节表和直播配置表因为它们直接决定后续直播课堂形式怎么扩展。表/模块承载内容关键字段示例用户表学生、讲师、助教账号user_type、status课程表课程基础信息、售卖配置title、price、status章节表章节课时、直播/录播类型is_live、live_form、start_time订单表订单、支付流水pay_status、pay_time直播记录表直播场次、回放地址room_id、stream_url、replay_url其中“章节表”里的 live_form 类型字段最值得留意它通常用数字区分课堂形式比如 1 表示录播点播、2 表示大班直播、3 表示小班互动。想要在项目里新增一种直播课堂形式只需要扩展这一层数据结构并让前端按类型渲染对应组件。2.3 为什么这么多网校源码选择 PHP 技术栈看到 ThinkPHP 或 Laravel 这类 PHP 框架有些人会觉得不够新但这恰恰是网校类系统的务实选择。PHP 生态对虚拟主机和宝塔面板这类自助运维工具的兼容性极好代码改完上传即可生效不像 Java 或 Go 项目需要先编译打包同时 PHP 的异步任务、队列处理和直播回调都能通过简单脚本完成配合 MySQL 和 Redis 就能支撑包括课程售卖、直播签到、互动消息在内的完整业务闭环。3. 用 LNMP 环境把开源网校源码跑通的最小步骤3.1 环境检查清单与 PHP 扩展无论你在本地用 phpstudy 还是在云服务器上用宝塔面板第一步都是确认环境匹配。比较通行的条件是 PHP 7.4 及以上、MySQL 5.7 及以上、Redis 6.x、Nginx 1.20 及以上。先跑一条命令检查版本php -v mysql --version redis-cli --version nginx -v如果输出版本正常接下来重点是 PHP 扩展是否齐全。网校系统这类开源项目在安装时会校验 fileinfo、redis、opcache、gd、curl 等扩展缺了其中一个就可能卡在安装界面或者后台图片上传失败。提示生产环境通常安全配置会禁用 shell_exec、proc_open 等函数但直播转码、FFmpeg 生成缩略图等功能依赖它们。建议根据实际功能按需放行而不是全部禁用或全部放开。3.2 创建数据库并导入初始化 SQL初始化数据通常放在源码包根目录的 .sql 文件或 install 目录内。先在 MySQL 里创建专用库和账号避免沿用 root 连接CREATE DATABASE edu_course DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; GRANT ALL PRIVILEGES ON edu_course.* TO edulocalhost IDENTIFIED BY YourPass#2024; FLUSH PRIVILEGES;然后命令行导入数据文件把 sql 文件里的表结构和默认配置一次性写入mysql -u edu -p edu_course course.sql导入完成后建议查一下核心表数量确认没有半途中断USE edu_course; SHOW TABLES;3.3 修改 .env 配置文件并生成数据表连接多数 PHP 网校项目会在 .env 文件里维护数据库、Redis、支付等配置项。更改以下关键项DB_HOST127.0.0.1 DB_PORT3306 DB_NAMEedu_course DB_USERedu DB_PASSWORDYourPass#2024 REDIS_HOST127.0.0.1 REDIS_PORT6379 REDIS_PASSWORD这里参数的对应关系是DB_HOST 指 MySQL 所在服务器地址云服务器上如果数据库单独部署需要改成内网 IPDB_NAME 必须和上面 CREATE DATABASE 的名称一致REDIS_PASSWORD 留空表示本机 Redis 未设置认证。任何一项不匹配后台登录或首页读取配置时都会直接报 500。3.4 Nginx 伪静态规则与站点根目录配置PHP 框架的 URL 路由依赖伪静态规则。如果不加这段配置访问首页可能正常但进入课程详情页或直播课堂页面时全部 404。我一般会在 Nginx 站点配置中加入server { listen 80; server_name your-domain.com; root /www/wwwroot/edu/public; index index.php index.html; location / { if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; break; } } location ~ \.php(.*)$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_split_path_info ^(.\.php)(.*)$; fastcgi_param PATH_INFO $fastcgi_path_info; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } access_log /www/wwwlogs/your-domain.com.log; error_log /www/wwwlogs/your-domain.com.error.log; }配置要点有两个 root 指向 public 目录不要把入口文件暴露成直接可下载location / 里的 rewrite 规则把不含实际文件的请求全部转给 index.php 处理。下面的 fastcgi 段负责把 .php 请求交给 PHP-FPM 解析PATH_INFO 参数用于兼容框架的路由模式。3.5 目录权限与计划任务源码解压上传后runtime、uploads、backup 这类目录需要写入权限。在 Linux 下用一行命令完成归属变更chown -R www:www /www/wwwroot/edu chmod -R 755 /www/wwwroot/edu同时还需要把计划任务写进 crontab网校系统通常要求每分钟执行一次定时任务用于处理直播状态过期、订单超时关闭等逻辑* * * * * php /www/wwwroot/edu/think schedule:run /dev/null 21这条命令通过 ThinkPHP 的定时器统一触发后台脚本可以避免为每一个定时功能单独写 crontab。部署后测试方式是修改一个订单的过期时间字段看能否在一分钟内被自动关闭。4. 多种直播课堂形式的技术实现与参数选型4.1 大班直播用 RTMP 推流配合 HLS/HTTP-FLV 分发大班直播是最常见的直播课堂形式场景是单讲师向大量学生单向授课不需要频繁连麦互动。技术上通常走“RTMP 推流 播放端多协议分发”路线。讲师端使用 OBS 或移动端推流工具推流地址带上串流密钥服务端用 SRS 或 ZLMediaKit 接收后在转成多种拉流协议。关键参数是推流地址的完整结构rtmp://your-domain.com/live/{stream_id}?token{token}其中 stream_id 对应后台创建直播课堂时生成的房间号token 用于防止推流地址被其他人盗用。播放端用 HTTP-FLV 或 HLS。FLV 延迟低一般在 1 到 3 秒适合互动感要求高的场景HLS 延迟在 5 到 10 秒之间但胜在兼容性和 CDN 分发能力强。我会用前者做主线路后者做兼容降级。4.2 小班互动课堂走 RTC 方案实现连麦与音视频通话小班课、一对一辅导这类直播课堂形式对双向音视频有硬性要求单纯靠 RTMP 推流做不了连麦或白板互动需要引入 WebRTC 或第三方 RTC SDK。开源自建方案偏重 Mesh 架构适合 4 到 6 人的小规模房间超过这个量级就建议用云厂商的 RTC 服务由服务端做合流转码与全网分发。接入方式是在前端初始化 SDK 并加入房间import RTC from some-rtc-sdk; const client RTC.createClient({ mode: rtc, codec: vp8 }); client.init(appId); client.join(roomToken, live-classroom-id).then(() { // 本地采集并发布音视频 return client.createStream({ video: true, audio: true }); }).then(stream { stream.play(local-player); client.publish(stream); });这段代码里的 mode 表示 RTC 模式codec 选择 vp8 是为了兼容大多数浏览器createStream 后调用 publish 把自己的音视频推到房间内其他成员通过 client.subscribe 接收。实际项目中还需要监听远端流的加入和离开事件动态更新画面布局否则可能出现学生进了房间但画面不出现的问题。4.3 直播回调开播、关播、转存回放的接口约定网校平台必须在直播开始和结束时知道状态变化以便前端切换“直播中”到“回放可看”。这个动作依赖直播服务商的回调通知机制。假设回调地址配置为 https://your-domain.com/api/live/callback回调通知处理大致如下public function handleCallback(Request $request) { $data $request-post(); if ($data[event_type] live_start) { // 更新章节状态为直播中 Lesson::where(id, $data[lesson_id])-update([live_status 1]); } elseif ($data[event_type] live_end) { // 回放地址写入 Lesson::where(id, $data[lesson_id])-update([ live_status 2, replay_url $data[replay_url] ]); } return json([code 0]); }要注意的是回放地址字段。大班直播关播后服务商通常需要几秒到几分钟的时间生成回放文件如果回调里没返回 replay_url就需要前端轮询查询或者后端在队列里延迟拉取。4.4 课堂互动聊天室、签到与白板的选型直播课堂形式的完整体验还需要配合互动组件。聊天室一般走 WebSocket 或长连接处理消息的上行广播与进入房间者的历史消息拉取签到和答题可以复用同一套消息通道后台预设签到秒数前端倒计时结束后统计参与人数白板则需要 Canvas 或 SVG 层叠加在视频区域外配合 WebSocket 同步绘制事件由于白板的频繁事件容易造成抖动常见做法是对事件做批量压缩上传每 50 毫秒合并一次。5. 二次开发在开源网校系统上扩展支付、题库和直播管理5.1 控制器与 API 接口的扩展方式开源网校系统的二次开发通常不涉及改框架底层而是在 application 目录下的控制器层新增模块。比如要增加一个“课程顾问”模块在控制器目录中写对应的控制器方法通过路由前缀映射到 URL?php namespace app\api\controller; use think\Request; use think\facade\Db; class Consultant extends Base { public function assign(Request $request) { $userId $request-param(user_id); $referee $request-param(referee_id); // 更新用户的归属顾问影响后续课程佣金分成 Db::name(user)-where(id, $userId)-update([ consultant_id $referee ]); return json([code 0, msg 绑定成功]); } }控制器继承 Base 后自动获得 JWT 登录校验、跨域头、操作日志等公共能力。新方法绑定到对应路由后前端即可通过 POST 请求调用不需要改动现有接口。5.2 支付模块二开把固定商品改成订阅制续费默认网校的订单流程是“选择课程→生成订单→扫码支付”。机构如果要做会员订阅需要在订单表中扩展 plan_id 和 expire_time 字段并在支付成功回调里写入会员到期时间。回调处理中需要先校验订单状态是否是未支付防止重复回调导致用户时长被叠加。5.3 题库和在线考试的二开思路题库模块常见的需求是支持题目批量导入和随机组卷。批量导入用表格模板上传后端解析时逐行校验题目类型和答案格式随机组卷则需要在考试开始时读取题库配置按知识点权重抽题并生成考试记录。这里要注意的是获取答题明细不要全量加载一定要做分页或按试题 ID 范围分段查询。5.4 自定义直播课堂形式的接入如果机构现有直播跨能力来源于自建 SRS 服务而不是用平台默认的云直播需要在后台的直播配置中改推流和拉流地址模板。常见做法是把推流地址和播流地址都做成可配置项用大括号作为占位符push_url rtmp://your-srs-server.com/live/{stream_id} push_key {token} play_url https://your-srs-server.com/live/{stream_id}.flv后台创建直播课堂时不直接生成最终地址而是保存替换后的 URL。前端拿到后拼装播放器地址完成对接。这样替换底层直播服务时只需要后台改配置不用重新发版。6. 直播卡顿、白屏与回调失效的排查方法先看最常见的播放白屏。前端播放器初始化时浏览器自动播放策略要求音频必须由用户交互触发如果初始化代码把播放器放在页面 onload 里执行大概率被浏览器拦截。排查方法是在初始化播放器同时调用 resume并给页面加一个“点击进入课堂”的开始按钮用这个事件去触发播放而不是等页面渲染完毕自动播。直播卡顿优先排查网络链路而不是缓存。用 curl 分别测一下推流域名和播流域名的 TCP 连接时间与首包耗时如果播放端到 CDN 边缘节点的延迟在 100 毫秒以上就要考虑加一层 CDN 动态加速或切换播放协议为 HTTP-FLV。再看回调失效。回调不触发时先到直播服务商后台查看回调记录确认请求是否发到了指定地址如果发了但接收失败检查目标服务器的安全组或防火墙放行策略同时确认回调地址不能被强制跳转 HTTPS。调试阶段可以在回调方法入口写一条日志error_log(json_encode($request-post(), 256), 3, runtime_path() . /callback.log);最后验证部署成果的一个技巧开启课堂后在后台把章节状态从“未开播”改成“直播中”再刷新学生端看状态同步直播结束后主动调用一次回调接口模拟关播数据确认回放地址能写入数据库并在前端展示。整个链路通了网校系统的直播课堂形式才算真正完成闭环。本文还有配套的精品资源点击获取