拿到一套私域直播源码，从上传到第一场直播上线，中间要经历什么？这篇文章以业内常见的"ThinkPHP后端 + Vue管理端/H5 + Workerman即时通信"架构为例，把完整流程走一遍。你手里的源码栈可能略有不同，但思路和坑是相通的。
一、环境准备
一台干净的Linux服务器（Ubuntu/CentOS均可），需要装好：Nginx、PHP 7.4~8.x（注意开启fileinfo、redis、event等扩展）、MySQL 5.7或8.0、Redis 6+、Composer，以及Node 16+（用于构建Vue管理端和H5前端）。云直播的推流/拉流地址提前在云厂商控制台开通。
二、部署七步走
- 第1步，上传代码、设目录权限。源码上传到服务器，runtime、upload等目录给写权限。
- 第2步，建库导入。创建数据库，导入源码包里的SQL文件，注意字符集用utf8mb4。
- 第3步，改配置。填写数据库、Redis、对象存储、短信等配置项，多数系统集中在.env或配置目录里。
- 第4步，配Nginx与域名。绑定域名、配置伪静态、申请并部署SSL证书——直播和微信支付都强制HTTPS，这步不能省。
- 第5步，构建前端。 Vue管理端和H5执行构建命令，把dist目录部署到对应站点。注意：部署的是构建产物，不是源码目录。
- 第6步，启动IM服务。 Workerman以守护进程方式启动（用systemd或supervisor托管），防火墙和安全组放行IM端口。
- 第7步，接通直播链路。后台填入云直播的推流/拉流/回调地址，走一遍"开播—观看—下单—弹幕"全链路测试，再对外开放。
三、六个最常见的坑
1. PHP扩展没装全：redis扩展没装，登录时验证码或会话莫名失败，排查半天才发现是扩展问题；
2. Workerman没用守护模式：终端一关服务就停，半夜直播掉线；
3. 安全组没开端口：本地测试一切正常，外网连不上IM，忘了云厂商安全组是独立于系统防火墙的；
4. 伪静态没配：管理端一刷新就404，典型的单页应用路由问题；
5. PHP禁用函数：部分面板默认禁用putenv、proc_open，导致Composer和框架报错；
6. 直接上传了前端源码：没构建就把Vue源码目录挂上去，页面一片空白。
这六个坑，有文档的话十分钟绕过，没文档的话每个都能耗掉你半天。
四、所以，选源码厂商时多看一眼
部署只是第一步，后面还有二开、升级、运维。判断一家源码厂商靠不靠谱，就看三样东西给不给：部署文档、接口与数据库文档、一对一技术培训。给全了的，你的团队两天就能独立运维；给不全的，你买的不是源码，是一个需要自己考古的黑盒。
这套流程我们在自己的交付里打磨了上百次：智辉云源码交付含完整代码注释、部署文档、接口说明和一对一技术培训，客户技术员跟着文档通常两小时内完成首部署。想先看一份部署文档长什么样，可以联系一下我们。