简介：云豹直播系统开源版是一套以PHP为核心的完整直播平台源码，面向希望搭建、运营直播平台或进行二次开发的个人开发者与中小企业。ZIP压缩包共121.37MB，包含2001个文件，其中JavaScript文件868个、Java文件278个、XML文件237个、HTML文件212个，另有SQL、Shell、Python等类型；JS文件支撑前端交互与流媒体播放逻辑，Java文件对应安卓端功能，XML与JSON负责配置与数据交换，便于对照学习多语言协作的工程结构。系统由专业团队研发，支持全球服务器部署，提供引流、互动直播、流量变现等运营级能力，覆盖Web端与安卓端。源码目录结构清晰、文件完备，可直接用于环境搭建与功能调试，也可作为学习PHP服务端开发、安卓直播客户端或大型Web项目的参考范本。目前已有214人学习下载。
1. 云豹直播系统开源版：先搞清楚它到底能不能用
做直播产品最怕的不是功能复杂，而是花了几个月把客户端写完，才发现后台根本撑不起运营。这套云豹直播系统开源版把 PHP 后端、Web 管理台和安卓端一次性打包，用户注册、主播认证、房间上下播、礼物打赏、提现审核整条链路完整跑通，不是网上常见的残缺单页或空壳后台。它适合两类人：一类是手里有现成主播资源、想快速搭出可运营平台雏形的团队，另一类是打算拿 PHP 直播源码深入研究三端数据流的开发者。先说结论：开源版不等于开箱即用，PHP 版本、Redis 扩展、播放器参数三个地方最容易翻车。下面从拆目录开始，把部署和二开的全部关键点讲清楚。
2. 三端架构拆解：PHP 后端、Web 管理台与安卓端的职责边界
拿到源码包第一步不是改配置，而是先把目录结构看明白。这套系统按功能可以拆成三个工程、两个入口：PHP 端是主工程，里面同时包含 api、admin、home 三个应用模块；Web 端入口在 public 目录，管理后台默认路径是 /admin；安卓端是一个独立的 Android Studio 工程，Java 为主，网络层、播放器、弹幕 Socket 服务全在这个包里。
拆过几十套直播源码之后，我最大的感受是：很多人卡住不是因为代码难，而是不知道代码在哪、接口从哪个文件进、数据库表之间怎么关联。所以这一章不罗列全部文件，只挑你能用得上的路径和模块讲清楚。
2.1 先看目录结构：一分钟定位三端代码入口
我拆这套源码的习惯是按固定顺序扫目录，照这个顺序来基本不会迷路：
- 先找 SQL 文件，确认数据库脚本位置和表结构设计。
- 再进 application 目录，看 api、admin、home 三个模块各自有什么 controller。
- 最后打开安卓工程，找到网络层封装的包，确认请求地址和字段定义。
用下面的命令可以快速看到这套源码用的 PHP 框架类型：
ls -la /path/to/cloud_live grep -o "topthink/framework" composer.json 2>/dev/null || find . -maxdepth 2 -name "ThinkPHP.php"第一条命令看根目录结构，第二条命令判断是不是 ThinkPHP 及大致版本。这套云豹直播开源版常见的是 ThinkPHP 5.x 系，如果你看到 vendor 目录里是 topthink/framework，那基本就没跑。判断框架版本的意义在于决定后面调试方式，TP5 的报错信息比 TP3.2 友好得多，而且数据库配置文件的写法完全不一样，网上搜解决方案时关键词也不能用错。
数据库这块，直播系统的核心表一般就六类，我整理了一张表方便你对照看结构：
| 表名 | 职责 | 关键字段 |
|---|---|---|
| 用户表 | 注册账号、身份、余额 | uid、user_type、coin |
| 主播认证表 | 主播实名与房间绑定 | uid、room_id、status |
| 房间表 | 直播房间信息 | pull_url、push_url、title |
| 礼物表 | 礼物配置与价格 | gift_id、price、icon |
| 订单流水表 | 充值、送礼记录 | order_no、uid、amount |
| 提现表 | 主播提现申请 | uid、amount、status |
先看这几张表的关联关系，后面的登录、开播、收礼物流程就能串起来了。不用急着每个字段都搞懂，重点记住房间表里的 push_url 和 pull_url，直播流的推拉地址就存在这里。
2.2 api 模块：整条业务链路的连接点
api 模块是手机端和 Web 端的数据来源，controller 按业务拆分，用户、房间、直播、礼物、支付、提现各占一个文件。每个 controller 对应一组接口，返回格式基本统一，长这样：
{ "code": 0, "msg": "ok", "data": { "uid": 10001, "nickname": "主播小明", "room_id": 202401 } }code 是业务状态码，0 代表成功，非 0 是各种错误；msg 是给客户端提示文案；data 是真正的业务数据。安卓端网络层一般会统一解析这个外壳，所以你在增加新接口时，返回格式必须沿用这个三段式，否则前端拿不到数据。
鉴权方式也值得留意。登录成功之后后端会签一个 token，存到 Redis 里，客户端每次请求都在 Header 里带上。后面的操作，比如送礼、发弹幕、申请提现，都需要先走这个 token 校验。这个机制的好处是接口无状态，服务端重启也不会踢掉在线用户，坏处是如果 Redis 没配好，所有需要登录的接口全部会挂。我见过有人折腾了半天说接口报错，最后发现是 Redis 没启动。
2.3 直播流与弹幕：三端怎么协作的
直播流这部分是整套系统的核心。主播端推流、观众端拉流，都是通过房间表里的推拉流地址完成的。后端做的事情是调用云厂商接口申请推流地址和拉流地址，然后把地址写回房间表。常见做法是接入腾讯云直播或阿里云直播的服务，或者自己搭 SRS 服务端，这套源码里具体接哪家，看配置文件中直播服务商的 key 就能确定。
拉流协议的选择有讲究。RTMP 延迟低但浏览器原生不支持，FLV 可以用 HTTP 协议传输并且能配合 flv.js 在 web 端直接播放，所以大多数 PHP 直播系统都会同时生成 RTMP 和 FLV 两条地址。安卓端一般用 IJKPlayer 播放 RTMP 或 FLV，Web 端则用 flv.js 播放 HTTP-FLV 流。你如果想让 web 端看实时视频，重点检查的就是 FLV 地址能不能正常访问。
弹幕是另一个容易藏坑的地方。这类 PHP 源码弹幕实现有两种：一种是前端轮询，每隔几秒请求一次弹幕接口；另一种是 WebSocket 长连接，服务端用 Swoole 或 Workerman 做消息推送。判断源码用的是哪种，就看两个地方：PHP 端有没有装 swoole 扩展，安卓端的 socket 模块是普通 HTTP 请求还是 TCP 长连接封装。判断清楚之后再动手改，不然方案直接选错。
3. 本地跑通全流程：环境版本、数据库导入与三端联调
部署这套源码的第一步是环境，而环境选型决定你接下来是省心还是折腾。云豹直播系统属于典型的老 PHP 项目，对版本极其敏感，我在 PHP 8.0 刚出那年踩过大坑，代码直接白屏，翻了大半天日志才发现是框架不兼容。所以这一章把环境准备、数据库导入、三端联调一次讲完。
3.1 环境选型：PHP 7.4 是这条链路的安全线
这套源码的 PHP 版本我建议锁死在 7.4，不要一上来就装 PHP 8 配新版 MySQL。原因不复杂：ThinkPHP 5 时代的老代码大量使用了 PHP 7 的写法，而在 PHP 8 下，each() 函数被直接移除、count() 传入 null 会抛异常，老代码会连环报错。真要迁移到 PHP 8，你得先把代码里所有兼容性问题清一遍，工作量大且没有直接收益。
用 PhpStorm 打开项目时也要注意，把 PHP 解释器指到 7.4 版本，避免 IDE 按 8.x 语法做兼容检查误报。本地开发我一般用 phpstudy 或宝塔面板，Nginx、MySQL、Redis 一键启动，省去手工编译的折腾，推荐版本组合如下：
| 组件 | 推荐版本 | 原因 |
|---|---|---|
| PHP | 7.4.x | 兼容 ThinkPHP 5 老代码 |
| MySQL | 5.7.x | 5.7 对 utf8mb4 支持稳定 |
| Redis | 5.x 及以上 | token、在线状态、弹幕缓存的依赖 |
| Nginx | 1.18+ | 配置简单，rewrite 规则友好 |
PHP 7.4 另一个好处是性能还在可接受范围内，配合 Redis 和 opcache 扩展，单机撑几百主播问题不大。MySQL 不要上 8.0，老代码里有些 SQL 写法在 8.0 下会触发 only_full_group_by 报错，改起来非常烦。
3.2 数据库导入与数据库配置修改
SQL 文件一般在根目录或 install 目录下，名字类似 install.sql 或 live.sql。先用命令行建库，再导入数据：
mysql -u root -p -e "CREATE DATABASE cloud_live DEFAULT CHARACTER SET utf8mb4;" mysql -u root -p cloud_live < install.sql导入之前有个坑必须提醒：检查 SQL 文件编码。Windows 下用记事本打开过再保存，很可能会变成 UTF-8 with BOM，导入后表注释全是乱码，更严重的是 BOM 字符可能导致第一张表创建失败。用 VS Code 或 Notepad++ 把编码切成 UTF-8 无 BOM 再导。另外导入成功后随便进一张表看几条数据，确认数据没丢再继续。
数据库连接配置在 application/database.php 里，把数据库名、账号、密码改成你自己的：
// application/database.php return [ 'type' => 'mysql', 'hostname' => '127.0.0.1', 'database' => 'cloud_live', 'username' => 'root', 'password' => '你的密码', 'hostport' => '3306', 'prefix' => 'tb_', ];这里要特别强调 prefix 这个参数。表前缀默认是 tb_，如果你导入的是别人备份出来的库，前缀可能不一样，那所有 SQL 查询都会报“表不存在”。所以导入之后第一件事是确认前缀，再看代码里的 Db::name() 调用，两者必须一致。Redis 的配置一般在 config.php 里，找到 redis 数组，把 host、port、auth 三项核对一遍。auth 是 Redis 密码，如果你本地 Redis 没设密码，这里就留空字符串，不要乱填。
3.3 Web 端和安卓端联调：先通接口再调 UI
PHP 端配置完成之后，用 Nginx 把 root 指向 public 目录：
server { listen 80; server_name localhost; root /path/to/cloud_live/public; index index.php index.html; location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }这里的关键是 root 一定指向 public，而不是项目根目录。ThinkPHP 的入口文件在 public/index.php，如果把 root 指到根目录就会出现访问不了控制器的情况，页面能打开但路由全部 404。配好后访问 http://localhost，能看到首页或直播大厅页面；再访问 http://localhost/admin，应该能出管理后台登录页。
安卓端联调的核心是把接口地址改成能访问到你电脑的地址。Android Studio 打开安卓工程，找到 ApiConfig 或类似的配置类，把 baseUrl 改掉：
// ApiConfig.java public class ApiConfig { // 模拟器访问宿主机固定用 10.0.2.2，真机改成电脑局域网 IP public static final String BASE_URL = "http://10.0.2.2:80"; public static final String IMG_URL = "http://10.0.2.2:80/upload"; }10.0.2.2 是 Android 模拟器内置的宿主机虚拟地址，真机调试时记得改成电脑的局域网 IP，而且手机和电脑必须同一个网段，否则连不上。改完配置后先不急着看界面，直接跑一次登录接口，确认接口层通了再继续做 UI 上的事。
这里还容易遇到一个跨域问题：如果你把 web 后台跑在 8080 端口，而 PHP 接口在 80 端口，浏览器的 ajax 请求会被跨域拦截。常见做法是在 Nginx 里给接口加跨域头，或者用本地反向代理把 /api 路径转发到后端。这套源码的接口如果和 web 前端同域名就没这个问题，分开部署才需要处理。
4. 二次开发实战：新接口、弹幕推送与播放器参数改造
源码跑通之后才是真正的开始。直播系统的二次开发需求一般集中在三个方向：加业务接口、改弹幕推送方案、调播放器参数。这一章按这三个方向分别给出一套可执行的方案和参数说明。
4.1 新增一个带鉴权的接口：别绕过 Token 校验
最常见的需求是加一个“最近直播列表”或者“关注的主播开播状态”接口。以 ThinkPHP 5 为例，在 api 模块的 controller 里新增一个方法：
public function recentList() { $token = $this->request->header('token'); $uid = $this->checkToken($token); $list = Db::name('live_room') ->where('status', 1) ->order('start_time desc') ->limit(20) ->select() ->toArray(); return json(['code' => 0, 'msg' => 'ok', 'data' => $list]); }checkToken 是在 base controller 里定义的标准动作，内部逻辑一般是拿着 token 去 Redis 查 uid，查不到就抛异常返回 code 非 0。这里要注意两个细节：第一，每个新增接口必须走 checkToken，不要因为嫌麻烦就不鉴权，不然接口就裸奔了；第二，limit 值不要写死太大，20 到 50 之间是常见做法，直播列表需要的是实时性，不是一次拉全量。
返回格式必须保持 code、msg、data 三段式，不要自己发明一个新的 JSON 结构。安卓端的网络层拿到响应后是统一解析外层再分发到业务层的，格式变了会导致整个端拿不到数据。如果是给 Web 端用，还要注意 controller 千万别忘了 return，ThinkPHP 的返回值会自动做 json 编码，你手动 echo 反而会把 header 弄乱。
4.2 弹幕改造：从轮询到 WebSocket 的升级路径
弹幕是直播系统的实时性门面。这套源码如果用的是轮询，那在人数上来之后问题会很明显：每 5 秒拉一次接口，一万观众同时在线，每秒就是两千次请求，接口响应越来越慢。我在一个百人直播间就见过轮询把 PHP 进程打满的情况，弹幕卡成 PPT，血泪经验。
升级方案我推荐用 Workerman，不用装 Swoole 扩展，纯 PHP 就能跑长连接。部署逻辑是单独起一个 GatewayWorker 服务，安卓端通过 TCP 长连接连上来，发注册包绑定 uid 和房间号。发送弹幕时，PHP 接口收到消息后调用 Gateway 的推送方法：
// 发送弹幕接口内部，调用 Gateway 推送给房间内所有连接 Gateway::sendToGroup($roomId, json_encode([ 'type' => 'barrage', 'uid' => $uid, 'content' => $content, 'time' => time(), ]));sendToGroup 是按分组广播，房间号就是分组名。这里有两个关键参数要设置好：心跳间隔和断线重连。GatewayWorker 配置里把心跳检测间隔设在 30 秒左右，客户端每 30 秒发一个 ping 包，超过 60 秒没收到就判定掉线；客户端收到断线通知后要做指数退避重连，第一次等 1 秒，第二次等 2 秒，最长间隔 30 秒，这样弹幕服务才稳。
另一个容易被忽略的点是弹幕消息要不要入库。建议先推给客户端、再异步写数据库，不要在推送逻辑里同步写库，否则发送方会感觉到明显卡顿。异步可以用 ThinkPHP 的队列或者直接 Redis 列表，简单点就起一个定时任务批量落库。
4.3 播放器调优：IJKPlayer 硬解参数与 RTSP 流的取舍
安卓端播放器一般封装的是 IJKPlayer，支持 RTMP 和 HTTP-FLV 拉流。很多人遇到画面黑屏、播放一会儿就卡住的情况，问题往往在参数没配对。我贴一组在真机上稳定运行的参数：
IJKFFOptions options = new IJKFFOptions(); options.setPlayerOptionValue("infbuf", 1); // 无限缓冲，适合直播场景 options.setPlayerOptionValue("rw_timeout", 20000000); // 读超时 20 秒，单位微秒 options.setPlayerOptionValue("reconnect", 1); // 自动重连开关 options.setPlayerOptionValue("mediacodec", 1); // 开启硬解 options.setPlayerOptionValue("mediacodec-auto-rotate", 1); // 硬解自动旋转infbuf 这个参数很关键，设成 1 是按直播模式做无限缓冲，设成 0 则按文件播放模式缓冲，直播流很容易因为缓冲不足被掐断。rw_timeout 单位是微秒，默认值太小会导致弱网环境下播放器频繁退出，我一般调到 20 秒，让播放器在弱网下多等一下也别直接断开。reconnect 设为 1 可以让播放器在拉流断开后自动重连，主播端闪断恢复后观众能自己续上。
mediacodec 这一组是硬解开关。硬解效率高、功耗低，但兼容性不如软解，遇到主播用 HEVC 推流而手机硬解不支持的情况，画面就是黑的但声音正常。所以生产环境我一般开着硬解但保留自动回退软解的配置，加上 mediacodec-auto-rotate 让旋转画面正常显示。如果你是把直播流缓存下来做回放，类似安卓缓存 RTSP 流那种需求，IJKPlayer 这块支持有限，我建议直接换 ExoPlayer 或者 Vitamio，专门处理本地缓存和 RTSP 源会更顺手。这套源码里如果同时封装了 ExoPlayer 的选项，优先用 ExoPlayer，兼容性省心很多。
5. 部署避坑指南：从白屏到闪退的五个真实案例
这一章写的全是实战里翻过车的问题。每一条都是现象、原因、解决完整列出来，你照着比对排查就行，能少走很多弯路。
5.1 部署完成访问首页白屏：先把 PHP 版本降下来
现象：Web 首页打开是空白，浏览器控制台报 500，后端日志里堆着大量语法错误。
原因：最常见的是 PHP 版本太高。老代码在 PHP 8 下运行，each() 被移除、count() 传 null 报错，整个控制器直接崩掉。其次是 runtime 目录没有写权限，ThinkPHP 的编译缓存文件写不进去，框架无法生成路由和模板缓存。
解决：先看 PHP error log 里的具体报错。如果是语法兼容问题，把 PHP 切到 7.4 基本就解决了；如果是写入失败，把 runtime 目录权限改成 755 并确认 PHP 进程用户有写入权限。注意权限不要给 777，出于 web 服务器安全考虑，777 属于危险权限，755 加属主写权限足够。
5.2 安卓端能编译但登录一直网络错误：分清模拟器和真机
现象：APK 装上了，点登录按钮，提示网络错误，但 web 端一切正常。
原因：两种情况最常见。一是真机调试时 baseUrl 还是模拟器专用的 10.0.2.2，手机访问不到；二是 Android 9 及以上默认禁止明文 HTTP 请求，就算 IP 正确，请求也被系统直接拦截。
解决：真机调试把 baseUrl 改成电脑的局域网 IP，确保手机和电脑同一个 Wi-Fi。然后在 AndroidManifest.xml 的 application 标签里加一行 android:usesCleartextTraffic="true"，允许 HTTP 明文流量。这两个地方改完再试，登录基本就通了。
5.3 弹幕发着发着就断线：检查心跳和重连逻辑
现象：观众端弹幕发一段时间就收不到了，退出房间重新进又恢复。
原因：WebSocket 连接断开后客户端没有自动重连，或者服务端心跳超时时间设得太短，网络稍微波动就被踢下线。很多直播源码自带的弹幕模块没有实现完整的断线重连机制，接入真实网络环境后问题就暴露出来。
解决：客户端加心跳，每 30 秒发一次 ping 包，服务端收到后重置连接计时。断线后走指数退避重连，1 秒、2 秒、4 秒，最多间隔 30 秒。这样短时间的网络抖动不会导致用户被永久断开。
5.4 直播画面黑屏但声音正常：硬解兼容性回退
现象：观众能看到主播的直播画面是黑的，但能正常听到声音。
原因：主播端用 HEVC 编码推流，观众手机硬解不支持这个格式，解码失败后没有自动回退软解，导致只有音频播放、视频渲染不出来。
解决：在 IJKPlayer 初始化时把硬解参数打开，同时设置 medciacodec-auto-rotate 和分辨率自动切换参数，让播放器在硬解失败时自动换软解。我一般建议在播放器初始化后做一个解码器探测逻辑，跑不通就降级，比等用户反馈再改代码靠谱。
5.5 主播上传头像和房间封面一直失败：检查上传目录
现象：主播端上传头像、设置房间封面时，接口返回上传失败。
原因：上传目录不存在或者没有写权限。很多直播源码的上传路径是 public/upload，这个目录在代码仓库里是空的，部署时不会自动创建，PHP 进程往不存在的目录写文件自然报错。
解决：检查 public/upload 目录是否存在并给写权限。这个目录必须放在 public 下，否则生成的上传 URL 无法通过浏览器直接访问。改完权限后顺手测一张图片上传，确认 URL 能从浏览器打开再继续下一步。
6. 上线前 30 分钟：全链路验收清单与安全快检
部署完成后不要急着对外推广，先用 30 分钟按真实用户路径走一遍全流程。不要登录管理后台看数据，那不能发现问题。我每次部署直播源码都会强制自己走下面这份验收清单：
| 步骤 | 操作 | 预期结果 |
|---|---|---|
| 1 | 注册一个新账号 | 收到验证消息，能登录 |
| 2 | 申请成为主播 | 后台出现待审核记录 |
| 3 | 管理后台通过审核 | 主播端出现开播入口 |
| 4 | 手机端开播 | 推流成功，房间状态变为直播中 |
| 5 | 另一台设备观看 | 画面流畅，声音正常，弹幕可发 |
| 6 | 观众送礼 | 礼物流水生成，主播余额增加 |
| 7 | 主播申请提现 | 后台生成提现单，审核后状态流转 |
这一条链路走完，业务核心功能就算过了。如果中间任何一步卡住，优先看 PHP 日志和 Redis 状态，别一头扎进代码里猜。链路通后再做安全快检：管理后台路径改掉，别用默认的 /admin，改成一个复杂路径；接口全量检查是否都走了 token 鉴权；Redis 加上密码，别裸奔在公网上。
从那以后，我每次拿到这类 PHP 直播源码，部署完第一件事不是改功能，而是强制自己把这份验收清单从头到尾走一遍，顺手把管理后台路径和 Redis 密码换掉。这两件事做完，项目才敢交给运营去试播。这套云豹直播系统开源版的完整源码包我已经跑通，下载入口就在资源页，建议先按第三章的流程完整部署一遍再开始改代码。希望帮到你。
本文还有配套的精品资源，点击获取
