简介：这份资源是2021年12月修复版的PHPlivechat在线客服系统源码包，面向需要自建客服渠道的中小企业、站长及PHP开发者，解决第三方客服平台坐席受限、数据不可控的问题。系统支持无限坐席，并附带安卓手机APP客服端，方便客服人员脱离电脑随时接待访客。压缩包共451个文件，约133.83MB，以100个php核心程序、122个js交互脚本、110个png界面素材为主，另含html模板、css样式、mp3提示音、字体图标及sql数据库文件，并附有apk安装包，结构完整可直接部署。目前已有1104人学习下载。资源内含宝塔Linux与Windows环境搭建教程，覆盖Apache2.4.41与PHP5.6以上配置、站点创建、源码上传解压及安装向导，无需手动修改数据库信息；同时提供APP扫码绑定后台QR码、添加服务器与登录表单的完整说明，并附客服专属聊天链接，便于快速上线与二次开发。

1. PHPlivechat 这套无限坐席客服系统，到底适合谁上手

如果你正在找一个能自己部署、不按坐席数收费、还带安卓客服端 APP 的在线客服系统，PHPlivechat 这套 2021 年 12 月修复版值得花半小时试一遍。它的核心卖点很直接：源码部署在你自己服务器上，坐席数量不设上限，访客端通过一个专属链接就能发起对话，客服除了在网页后台接待，还能装一个安卓 APK 在手机上扫码绑定、随时接管会话。整套东西不依赖第三方 SaaS，数据落在自己库里，对预算敏感又想掌控数据的中小团队、外包建站公司、以及需要给客户交付独立客服模块的开发者来说，落地成本比买商业授权低得多。

适合的人群很明确：会用宝塔面板建站、能配 Apache 和 PHP 环境、看得懂安装向导填数据库信息的人。不适合完全没碰过服务器、指望一键解压就能跑起来的新手——它虽然号称免改数据库配置，但环境版本、目录权限、伪静态这几处该踩的坑一个不少。下面按「环境怎么搭 → 源码怎么装 → APP 怎么绑 → 坑在哪 → 怎么验证」的顺序拆开讲，每一步都落到能直接抄的参数和命令上。

2. 环境与部署：Apache 2.4 + PHP 5.6 的宝塔落地参数

2.1 为什么锁定 Apache 2.4.41 和 PHP 5.6 以上

这套源码是典型的 PHP 5.x 时代产物，目录里那堆gumby.css、jquery-ui-1.10.3.custom.css、font-awesome.min.css说明前端用的是老一代 UI 框架，后端对 PHP 版本有隐性依赖。PHP 7.x 虽然多数语法能跑，但部分老函数（比如某些mysql_*风格调用或ereg残留）在 7.0 之后被移除，直接白屏。所以环境选型上，PHP 5.6 是最稳的基线，Apache 2.4.41 是官方教程里点名的版本，配合 mod_rewrite 处理伪静态。

宝塔面板里装环境很快，但要注意：宝塔默认可能给你装 PHP 7.4 或 8.0，装完这套系统大概率报错。正确做法是在「软件商店」里单独装一个 PHP 5.6，然后在站点设置里把 PHP 版本切过去。Apache 也要确认是 2.4 系列，Nginx 不是不能跑，但伪静态规则要自己转，官方教程只给了 Apache 的，用 Nginx 属于给自己加活。

2.2 宝塔建站与数据库配置的具体步骤

先建站点，再建数据库，顺序别反。宝塔里「网站 → 添加站点」，域名填你自己的，PHP 版本选 5.6，数据库选 MySQL 5.6 或 5.7 都行，别上 8.0（认证插件变了，老代码连不上）。

# 宝塔 SSH 里确认 PHP 5.6 和 Apache 都在跑 bt default # 查看宝塔面板默认信息 systemctl status httpd # 确认 Apache 运行 php -v # 如果多版本，用 /www/server/php/56/bin/php -v 指定

建站完成后，宝塔会给你数据库名、用户名、密码，这三样记下来，安装向导要填。源码上传到站点根目录后解压，注意解压出来的目录层级——有些包解压后多套一层文件夹，要把里面的内容挪到根目录，否则访问域名会看到目录列表而不是安装页。

# 上传源码后解压，假设压缩包在 /www/wwwroot/你的域名/ cd /www/wwwroot/你的域名/ unzip phplivechat.zip # 如果解压后是 phplivechat/ 子目录，把内容移上来 mv phplivechat/* . && mv phplivechat/.* . 2>/dev/null rmdir phplivechat # 给目录写权限，安装向导要写配置文件 chown -R www:www /www/wwwroot/你的域名/ chmod -R 755 /www/wwwroot/你的域名/

这几条命令的逻辑：unzip解压，mv把子目录内容提到根目录（.*处理隐藏文件），chown把属主改成 www 用户（Apache 运行身份），chmod 755保证目录可读可执行、文件可写。参数上，755 是目录权限的常见值，如果安装时提示「无法写入配置文件」，临时给 777 排查，装完再改回 755。

2.3 安装向导与伪静态规则

访问你的域名，正常会跳到安装页面。填数据库地址（一般 localhost）、库名、用户名、密码，然后设后台管理员账号密码，点安装。这一步源码里不需要你手动改数据库配置文件，安装向导会自己写——这是这套修复版相比老版本省事的地方。

Apache 的伪静态规则要在宝塔站点设置里贴进去，否则客服链接和后台路由会 404：

<IfModule mod_rewrite.c> RewriteEngine On RewriteBase / RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php?$1 [L,QSA] </IfModule>

RewriteEngine On开启重写，两个RewriteCond表示「请求的不是真实文件、也不是真实目录」才走重写，RewriteRule把请求交给 index.php 处理。[L,QSA]里 L 是最后一条规则、QSA 是保留原始查询串。这段规则解决的是「除首页外其他页面打不开」的典型问题，装完不配伪静态，后台登录后点任何菜单都可能 404。

3. 手机 APP 客服端绑定：扫码流程与后台 QR 码位置

3.1 安卓 APK 的安装与服务器添加逻辑

资源里带的客服管理APP.apk是安卓客服端，装到手机上后不是直接登录，而是先「添加服务器」再绑定。这个设计的好处是：一个 APP 可以管多个部署了 PHPlivechat 的站点，适合同时给多个客户维护系统的开发者。

安装 APK 时安卓会提示「未知来源」，允许即可。打开 APP 后界面里有个「添加新的服务器」入口，点进去会让你扫码或手动填地址。这里的关键是：必须用 APP 自带的扫码功能，不要用手机系统相机扫，因为系统相机只会识别成文本，不会触发 APP 的绑定逻辑。

3.2 后台 QR 码在哪、怎么扫、绑定后怎么登录

QR 码在「在线客服系统 WEB 管理端后台」里，登录网页后台后找绑定/移动端相关的入口，页面上会显示一个二维码。用 APP 扫这个码，APP 会自动把服务器地址、绑定令牌写进去。

APP 绑定流程（照着点）： 1. 打开客服管理 APP 2. 点「添加新的服务器」 3. 点扫码按钮，对准后台的 QR 码 4. 扫描成功后给服务器起个名字（中英文都行，比如「公司客服」） 5. 点保存 6. 点进这个服务器，填「登录表单」——就是你的客服账号密码 7. 登录后即可在手机上接待访客

第 4 步起名字是纯本地标识，不影响服务端。第 6 步的登录表单用的是你在网页后台建的客服账号，不是管理员账号（除非你把管理员也设成客服）。如果扫码后提示「绑定失败」，九成是后台地址用了内网 IP 或带端口，APP 在外网访问不到——确保 QR 码里的地址是公网可访问的域名。

3.3 访客端专属链接的用法

访客发起对话的入口是你的域名/php/app.php?widget-mobile，这个链接可以直接嵌到网站里做浮动客服按钮，也可以单独发给客户。widget-mobile这个参数说明它是移动端优化的 widget 样式，PC 端访客访问同一个链接也能用，只是布局偏移动。

<!-- 嵌到网站里的浮动客服按钮示例 --> <script> (function(){ var iframe = document.createElement('iframe'); iframe.src = 'https://你的域名/php/app.php?widget-mobile'; iframe.style.cssText = 'position:fixed;right:20px;bottom:20px;width:60px;height:60px;border:none;z-index:9999;'; document.body.appendChild(iframe); })(); </script>

这段 JS 动态创建一个 iframe 指向客服链接，固定在右下角。参数right/bottom控制位置，width/height控制大小，z-index保证不被其他元素盖住。实际用时建议把 iframe 尺寸调大或改成点击展开，60x60 只是个入口图标的大小。注意跨域问题：如果客服系统和你的主站不同域，iframe 通信会受限，常见做法是把客服系统部署在同域的子目录下。

4. 避坑与排查：装完打不开、扫码绑不上的五类翻车

4.1 访问域名显示目录列表或源码被下载

现象：打开域名看到文件列表，或者浏览器直接下载了 php 文件。原因：Apache 没正确解析 PHP，或者站点根目录指错了。解决：宝塔站点设置里确认「运行目录」是源码所在目录，PHP 版本选的是 5.6，然后重启 Apache。如果还是下载文件，检查 Apache 的 PHP 模块有没有加载，httpd.conf里应该有LoadModule php5_module之类的行。

4.2 安装向导填完数据库点安装没反应

现象：填了库名密码，点安装按钮页面刷新但没进展，或者报 500。原因：数据库连接信息错、目录没写权限、PHP 版本过高。解决：先用宝塔的 phpMyAdmin 确认库能连上；再chmod -R 777临时放开权限试一次；最后确认 PHP 是 5.6 不是 7.x。血泪经验是 PHP 版本这一条，很多人卡半天最后发现是宝塔默认给了 7.4。

4.3 后台能登录但点菜单全 404

现象：登录后台成功，点任何功能都跳 404。原因：伪静态没配。解决：把 2.3 节那段 Apache 规则贴到站点伪静态设置里，保存后清浏览器缓存重试。用 Nginx 的话要自己转规则，核心是把非真实文件/目录的请求转发给 index.php。

4.4 APP 扫码提示绑定失败

现象：APP 扫码后转圈然后报错。原因：QR 码里的地址是内网 IP、带非标准端口、或 HTTPS 证书有问题。解决：确保后台用公网域名访问，QR 码生成的就是这个域名；如果用了 HTTPS，证书要有效，自签证书 APP 可能拒绝。常见做法是先用 HTTP 域名绑一次确认流程通，再上 HTTPS。

4.5 手机 APP 登录后收不到访客消息

现象：APP 绑定成功、登录成功，但访客发消息手机没提醒。原因：APP 后台被杀、推送权限没给、或服务端消息轮询间隔问题。解决：给 APP 开自启动和通知权限，安卓省电策略里把它设为「不优化」。这套系统的移动端消息机制偏轮询，不是长连接推送，所以 APP 必须保持后台存活，这是它的边界，不是 bug。

5. 验证部署是否真的可用：三条自检命令与一个压测习惯

装完别急着交付，先跑一遍自检。第一条，确认 PHP 版本和关键扩展：

/www/server/php/56/bin/php -m | grep -E 'mysql|curl|gd|mbstring'

mysql是数据库连接、curl用于外部请求、gd处理图形验证码、mbstring处理中文。缺哪个就在宝塔 PHP 5.6 的设置里装哪个扩展，装完重启 PHP。

第二条，确认伪静态生效：

curl -I https://你的域名/php/app.php?widget-mobile

返回 200 说明访客链接可达；返回 404 说明伪静态或文件路径有问题；返回 500 说明 PHP 报错，去宝塔的网站日志里看具体错误行。

第三条，确认数据库写入正常。在后台随便改一个设置保存，然后查库：

SELECT * FROM 你的配置表 ORDER BY id DESC LIMIT 1;

能查到刚改的记录，说明安装向导写的配置和数据库连接都正常。查不到就是权限或连接问题，回到 4.2 排查。

我自己的习惯是：每次部署完这套系统，先用手机 APP 发一条测试消息、再用访客链接回一条，确认双向通。从那以后我每次交付前都强制走一遍「PHP 扩展 → 伪静态 → 双向消息」这三步，比装完就交省心得多。这套 PHPlivechat 修复版的价值在于免改配置、带移动端、坐席不限，边界在于它是个老架构、依赖 PHP 5.6、移动端靠轮询，接受这两点，它就是个能长期跑的独立客服方案。希望帮到你。

本文还有配套的精品资源，点击获取