源码系统概览
文章正文
星播 StarLive 是一套可自部署的直播互动平台,采用 NestJS 后端加 React 前端的一体化架构,支持自托管推流与云端推流两种模式切换。
项目内置星币虚拟货币体系,覆盖充值、提现、礼物、红包与抽奖等直播场景常见玩法,并提供完整的管理后台与内容治理能力。
源码简介
从目录结构看,项目采用 pnpm workspaces 组织的 monorepo,分为 apps 与 packages 两部分。apps 下含 server、web、worker 三个应用,packages 下是共享代码,infra 目录提供 docker-compose 与 MediaMTX 配置。
后端使用 NestJS 10 与 TypeScript 编写,实时通信基于 Socket.IO,数据存储在 Redis。推流默认走自托管的 MediaMTX,也可在后台一键切换到 Mux 云端服务,存量房间沿用原 Provider。
前端为 React 18 配合 Vite 5 与 TailwindCSS 构建,播放器使用 hls.js 拉取 HLS 流;转码与录播由独立的 FFmpeg Worker 处理,默认关闭可按需开启。
认证使用 JWT 加 bcrypt,支付层抽象出 PaymentProvider 适配器,支持易支付、支付宝、微信 Native 与 Stripe 等多种网关。
适用场景
想自建直播平台、不希望依赖第三方直播 SaaS 的技术团队,可用它搭建带互动与打赏功能的直播站。
需要私有化部署直播能力的教育机构与企业,可利用自托管推流与录播功能做内部培训或公开课。
用于学习 NestJS 与 Socket.IO 实时通信、Redis 数据建模与视频流处理的开发者。
功能亮点
直播链路完整:OBS 通过 RTMP 推流到 MediaMTX,服务端转出 HLS 供浏览器播放,也可选配 WebRTC 实现更低延迟。
实时互动覆盖弹幕、礼物特效、红包(随机或均分)、抽奖与在线人数广播,全部通过 Socket.IO 在房间内广播。
经济系统包含星币充值、提现(带手续费与资金冻结)与完整交易流水,账目可追溯。
治理能力较全:房管任命、禁言与实时反馈、敏感词过滤即时生效、举报处理与审计日志。
后台提供十四天趋势概览、用户与房间管理、提现与订单管理并支持 CSV 导出,另有 RBAC 权限与系统设置。
部署体验好:前后端一体化单端口部署,首次访问有网页向导创建管理员,附带 Docker 与 CI 配置。
技术架构与部署指南
技术栈与运行环境
后端为 Node 20 加 NestJS 10 与 TypeScript,实时层用 Socket.IO 4,数据层为 Redis(ioredis),可自托管也可用 Upstash。
推流分发支持自托管 MediaMTX 或云端 Mux,推流鉴权钩子兼容 SRS;转码录播使用独立 FFmpeg Worker。
前端为 React 18、Vite 5、TailwindCSS、React Router 与 hls.js,构建工具链使用 pnpm workspaces。
安装与部署提示
第一步安装 Node 20 与 pnpm,在根目录执行 pnpm install 安装全部依赖。
第二步复制 .env.example 为 .env,填写 Redis 连接串、JWT 密钥与推流配置,云端模式还需填 Mux 的凭据。
第三步执行构建命令打包前端与后端,随后启动 server 应用,默认单端口对外提供页面与接口。
第四步首次访问站点会进入向导,按提示创建管理员账号并完成基础设置。
第五步如需自托管推流,用 infra 目录下的 docker-compose 启动 MediaMTX,并在后台把推流 Provider 设为自托管。
第六步按需开启 FFmpeg Worker 处理录播转码,注意对象存储与磁盘容量规划。
截图与演示说明

首页展示平台定位与入口,含直播广场、充值、提现与登录注册导航。

直播广场按游戏与分类筛选房间,列表自动刷新展示正在进行的直播。

登录页支持账号密码登录,是用户进入平台的主入口。

注册页用于创建新账号,填写基本信息即可加入平台。

充值页展示当前星币余额与充值面额,对接多支付网关。

主播中心可创建房间并查看近十四天礼物收益,体现创作者侧功能。
源码包内没有演示截图,以下页面可依据文件路径自行截图核对。
前台直播间页面是主要画面,包含播放器、弹幕区、礼物面板与在线人数,适合作为产品主图。
管理后台的数据概览页展示十四天趋势图表,用户与房间列表页体现运营管理能力。
提现审核与订单管理页面能展示资金链路,配合审计日志页可体现治理完整度。
infra 目录的 docker-compose 与 MediaMTX 配置文件适合作为架构部署示意图。
常见问题
问:必须用 Mux 吗?答:不必,默认走自托管 MediaMTX,Mux 只是可选的云端 Provider,可在后台切换。
问:需要什么数据库?答:使用 Redis 存储业务数据,不依赖 MySQL 等关系型数据库。
问:能录制直播回放吗?答:可以,开启独立 FFmpeg Worker 即可转码落盘,默认关闭。
问:支持哪些支付方式?答:内置易支付、支付宝、微信 Native 与 Stripe 适配器,也可自行扩展。
安全风险提示
特别提示:源码未经过安全审计,建议先在测试环境部署核查后再用于正式站点。
项目涉及资金与虚拟货币,Redis 与 JWT 密钥必须使用强随机值并妥善保管,泄露会导致会话伪造与资金风险。
直播平台需落实内容审核义务,敏感词过滤只是基础手段,正式运营还应接入人工或第三方内容安全服务。
提现功能涉及真实资金流出,务必核对审核流程与对账机制,并保留完整交易流水以备核查。
自托管推流服务需限制推流密钥与端口暴露范围,避免被他人盗用带宽或注入非法流。
相关源码推荐
同属实时交互与后台管理方向的还有《跑腿小程序源码 全开源智能派单系统》,适合对照学习订单派发与实时状态推送的实现思路。
如果更关注自托管服务的运维与监控,可以参考《UptimeKuma自托管监控管理源码》,两者都强调私有化部署与可视化后台。
涉及资金拆分逻辑时,《PHP交易拆分组件源码 订单分账结算管理系统》可与本项目的星币充值提现模块对照阅读。
下载说明
源码仅供学习研究与技术参考,请在下载后二十四小时内自行决定保留或删除,请勿用于任何违法用途。
本资源为 Apache-2.0 协议开源的直播平台源码,含前后端与部署配置,解压后按说明安装依赖即可运行。
使用过程中请自行承担部署、数据与合规责任,遵守开源协议保留版权声明,并落实直播内容管理义务。
更新日期:2026-10-18。