系统视频介绍:
莱播直播系统功能全解析:一套可自部署的开源直播间平台
莱播(LaiboLive)是一套前后端一体、单端口部署的自托管直播互动平台:OBS 推流走自建 MediaMTX(RTMP 进、HLS 出),弹幕、礼物、红包、抽奖通过 Socket.IO 全房实时广播,数据统一存 Redis,内置「星币(StarCoin)」虚拟货币经济与完整的 RBAC 管理后台。本文站在开发工程师视角,基于真实部署环境逐模块讲解它的功能、业务流程与技术设计。
一、这套系统适合拿来做什么
从功能边界看,莱播的核心能力是「直播互动 + 虚拟货币经济 + 内容治理」,适合以下场景快速搭建自己的直播业务:
二、系统架构概述
莱播采用一体化服务设计:React 前端构建产物由 NestJS 后端统一托管,对外只暴露一个 3000 端口(网页、/api、/socket.io、/hls 同源),部署与反向代理都因此大幅简化。
技术栈组成
| 层次 | 技术选型 | 说明 |
|---|---|---|
| 后端 | Node 20 · NestJS 10 · TypeScript | 15 个业务模块(auth/rooms/danmaku/gift/redpacket/lottery/payment/wallet/moderation/realtime/recording/stream/system/admin/common) |
| 实时通讯 | Socket.IO 4 | 按 room:{roomId} 房间维度广播:danmaku / gift / redpacket.* / lottery.* / presence / room.status / mute |
| 数据存储 | Redis(ioredis) | 唯一数据库,支持自托管与 Upstash,Hash/ZSET/String 按 Key 约定划分 |
| 推流分发 | MediaMTX(默认)/ Mux(云端可选) | RTMP 推流入、HLS 播放出;鉴权钩子兼容 SRS |
| 前端 | React 18 · Vite 5 · TailwindCSS · hls.js | 深色/浅色主题、骨架屏、移动端自适应 |
| 认证 | JWT(jose, HS256)+ bcrypt | HttpOnly Cookie 会话,REST 与 WebSocket 共用同一 JWT |
| 支付 | PaymentProvider 适配器 | 易支付 / 支付宝 / 微信 APIv3 Native / Stripe / mock,可插拔 |
| 构建 | pnpm workspaces monorepo | apps/server + apps/web + apps/worker + packages/shared 共享类型契约 |
三、前台功能模块详解
3.1 一体化首页:创建直播间与开播引导
登录后首页即是「开播工作台」:左侧直接创建直播间(标题、分类、可选私密密码、公开开关),右侧聚合我的房间、充值、提现快捷入口;「开播三步走」把创建房间 → 复制推流密钥 → OBS 推流的路径交代清楚,主播零培训上手。
3.2 账号体系:注册、登录与安全基线
注册支持用户名 + 可选邮箱(2–20 位用户名、6 位起密码),登录支持用户名或邮箱任一匹配。接口层内置速率限制(如登录 10 次/分钟),配合 bcrypt 密码散列与 HttpOnly 会话 Cookie 构成基础安全面;后续可在后台一键开启第三方 OAuth 登录。
3.3 直播广场:分类发现
直播广场按分类(全部/游戏/音乐/闲聊/户外/学习)筛选直播间,配合「在线人数心跳」展示活跃房间;后台可一键关闭公开列表(开放注册、抽奖等功能同样由后台功能开关控制)。
3.4 直播间:播放器 + 推流信息 + 实时互动区
直播间页面由三块组成:hls.js 播放器(直播标签、静音、小窗、全屏,等待信号时显示占位提示);主播控制面板(自建 MediaMTX 推流信息、服务器地址 rtmp://host:1935、串流密钥复制/重置、分享、独立弹幕弹窗、录播入口);弹幕互动区(Socket.IO 实时广播,底部集成礼物面板与观众贡献榜)。私密房间在 WebSocket 层做密码校验,未授权连接无法进入。
3.5 主播工作台:收益看板
主播中心提供 14 天礼物收益图表、金主榜(打赏 TOP 观众)、最近打赏流水,以及「我的房间」管理(进入/设置/录播/删除),主播经营数据一目了然。
3.6 星币充值:多支付网关
充值页提供快捷档位(10–1000 星币)与自定义金额,支付方式下拉由后台已启用的支付网关动态生成(易支付/支付宝/微信 APIv3 Native/Stripe,另有 mock 网关供沙箱联调)。订单创建后走对应网关支付,回调入账。充值比例由后台「经济配置」统一控制(默认 1 元 = 1 星币)。
3.7 提现:手续费与资金冻结
提现页展示可提现余额与累计已提现,用户维护收款账户后发起提现申请;系统按后台配置的提现手续费率(默认 20%)计算实付金额,申请提交后资金进入冻结状态,由管理员在后台审核放行或拒绝,形成完整的资金安全闭环。
3.8 个人中心:资料、密码与资产总览
个人中心聚合个人资料(昵称/邮箱/头像 URL)、修改密码、我的关注,以及星币资产总览(余额/累计充值/累计提现),并支持绑定第三方 OAuth 账号。
3.9 社交主页:关注与粉丝
每个用户拥有公开主页(/user/:id),展示头像、加入时间、粉丝/关注数与「Ta 的直播间」列表;关注主播后可在个人中心快捷回访,构成最基本的社交关系链。
四、管理后台功能详解
后台 /admin 以侧边栏组织 10 个管理模块,全部基于 RBAC 权限点控制可见性,关键列表均支持分页与 CSV 导出。
4.1 数据概览:平台运营驾驶舱
顶部为全局功能开关组(维护模式、开放注册、录播、转码、抽奖、公开列表,改动即时生效),中部为四项核心指标(用户总数、房间总数、公开房间、待处理提现)与三张 14 天趋势图(新增用户、新增房间、充值收入),底部展示最近注册用户与最近创建房间,维护模式切换还会强制刷新所有在线页面。
4.2 用户管理
用户表格列出用户、邮箱、星币余额、状态、注册时间,支持搜索、编辑资料、封禁、禁言与 CSV 导出——封禁用户会被导向独立拦截页,禁言在直播间实时生效。
4.3 房间管理
列出全部房间(标题/房主/分类/可见性/直播状态),管理员可编辑房间信息、封禁违规房间、删除房间,支持按标题/分类/房主搜索。
4.4 订单管理
充值订单按「全部/已支付/待支付」筛选,字段含订单号、用户、金额(元)、星币、支付网关、状态、时间,支持搜索与 CSV 导出,顶部汇总已支付合计金额——与前台充值流程一一对应。
4.5 提现管理
提现申请按「待处理/处理中/已完成/已拒绝」四态流转,字段含单号、用户、金额、手续费、实付、时间;管理员审核通过即放行,拒绝则解冻退回用户余额。
4.6 权限管理(RBAC)
内置基于权限点的角色体系:权限点按模块通配(system.*、users.*、rooms.*、moderation.*、recordings.*、withdrawals.*、orders.read、audit.read、stats.read),支持创建自定义角色、勾选权限保存、按用户 ID 分配角色,实现细粒度的后台访问控制。
4.7 内容治理:敏感词与举报
敏感词库支持即时增删(弹幕发送侧实时过滤生效),举报处理队列汇总观众举报(原因/状态/操作),配合用户封禁、禁言能力形成内容安全闭环。
4.8 操作日志(审计)
记录管理员的关键操作(时间/管理员/操作/详情),为后台治理行为提供可追溯的审计依据。
4.9 系统设置:业务配置中心
系统设置分三组:功能开关(维护模式/开放注册/录播/转码/抽奖/直播广场 + 一键强制刷新在线页面);经济配置(提现手续费率、最低提现星币、充值比例);站点与 OAuth 登录(站点对外地址——支付回调与 HLS 地址生成基准,及第三方 OAuth 凭据)。所有配置存 Redis、即时生效、优先于环境变量,改配置不需要重启服务。
4.10 录播管理
开启录播功能后(需同时启动 FFmpeg Worker),直播内容自动转码落盘,录播列表展示房间、时长、录制时间,支持分享回放(免登录/限时/永久 token),可作为课程回看与内容沉淀。
五、核心业务流程
5.1 开播流程
5.2 实时互动流程
5.3 充值—打赏—结算流程
5.4 提现流程
六、关键特性展示
七、总结
莱播系统把「能跑起来的直播平台」所需的最小完整集合——推流、播放、实时互动、虚拟经济、内容治理、运营后台——收敛在一个单端口可部署的工程里:前端 React 18 + Vite 5 保证交互体验,后端 NestJS 15 个模块按领域划分、共享类型契约统一事件与 DTO,Redis 作为唯一持久层让部署门槛降到最低。对于需要数据自持、快速上线、并预留二开空间的直播业务(秀场、游戏、培训、私域运营),它是一个值得作为基座起步的开源方案。







暂无评论内容