WoLive多商户在线客服系统源码部署教程与二开分析

综合源码2026-08-22214 阅读约 1,027 字 · 大约 3 分钟

一、项目概览

本套源码是一个多商户 SaaS 架构的在线客服系统，代号 WoLive，从游戏项目中独立出来，可通用于电商、游戏、企业官网等场景。

  • 框架： ThinkPHP 5.0.24 + Workerman（WebSocket 实时推送）

  • 数据库： MySQL，库名 kefu2024，29 张表（前缀 wolive_）

  • 存储： 支持本地 / 阿里云 OSS / 七牛 / 腾讯 COS 多云切换

系统分为总后台（管理商户、全局数据）和客服工作台（接待访客、聊天记录），两套入口权限独立。

二、前端效果展示

01 总后台登录页02 客服工作台登录页

左：总后台管理登录页  |  右：客服工作台登录页


03 客服对话工作台

客服对话工作台 -- 会话预知、知识库搜索、快捷回复


04 全渠道客服总览05 数据分析报表

左：全渠道客服总览  |  右：业务分析报表

三、技术架构

访客端（PC / 移动端）─ WSS:9090 ─▶ Workerman 实时服务 ─ HTTP:2080 ─▶ ThinkPHP 5 ─▶ MySQL

层级

技术

说明

后端

ThinkPHP 5.0.24

MVC 框架

实时通信

Workerman + Pusher

WebSocket 长连接推送

前端 UI

LayUI Admin

后台管理界面

微信

overtrue/wechat v3

公众号授权 + 模板消息

四、服务器要求

  • 系统： Ubuntu 20.04 / CentOS 7+，推荐宝塔面板

  • PHP 7.3（必须，高版本不兼容 TP5）

  • MySQL 5.7 / 8.0（8.0 需修复 SQL_MODE 兼容）

  • SSL 证书（HTTPS 必须配套 WSS）

  • 端口： 80/443（Web）、9090（WSS）、2080（内部 API，仅本机）

  • 配置： 测试 1 核 1G 起步，生产建议 2 核 4G+

五、部署步骤

预计耗时 1~2 小时，熟练可 30 分钟。

  1. 装环境： 宝塔安装 Nginx + PHP 7.3 + MySQL，解除 disable_functions 中 pcntl_fork、pcntl_signal、posix_* 等函数

  2. 建库导数据： 建 kefu2024 库，MySQL 8 需将 SQL 中 ROW_FORMAT=COMPACT 替换为 DYNAMIC 再导入

  3. 上传源码 + Nginx 配置： root 指向 public/，添加 ThinkPHP 伪静态重写规则

  4. 改三个配置文件：

    • public/index.php -- wss 域名、端口（ahost 必须写 http://127.0.0.1）

    • config/database.php -- 数据库连接

    • service/config.php -- Workerman 域名和端口

  5. 配 SSL 证书： 在 service/start.php 填入 fullchain.pem / privkey.pem 路径

  6. 改 public/.user.ini： 更新 open_basedir 为新站点路径

  7. 启动 Workerman： /www/server/php/73/bin/php service/start.php start -d，运行 bash init.sh 设置自动拉起

  8. 权限 + 验收： runtime/ 设 777，清空 runtime/temp/ 和 runtime/cache/，访问总后台登录页验证

六、二次开发评估

可行性：高 -- PHP 源码全开放，无加密无混淆，标准 MVC 结构，ThinkPHP 5 社区文档齐全。

可二开方向：品牌定制（Logo/配色）、前端重构（Vue/React 替换 LayUI）、渠道扩展（Telegram/WhatsApp）、AI 客服对接（GPT/大模型）、CRM 数据同步、工单系统扩展。

注意事项：PHP 锁定 7.3、Workerman 进程数固定为 1（高并发需优化）、微信 SDK 版本偏旧。

七、核心功能

  • 实时聊天： 文字/表情/图片/文件/语音，WebSocket 毫秒级推送

  • 会话预知： 客服可见访客正在输入的内容

  • 快捷回复 + 知识库： 常用语管理，关键词自动搜索

  • AI 机器人： 关键词匹配自动应答，离线留言收集

  • 多商户隔离： 独立开户、独立客服团队、独立访客入口

  • 访客端： PC 嵌入式窗口 + 移动端自适应 + 微信公众号接入

  • 排队分配 + 转接： 智能分配客服，支持会话转接

  • 满意度评价： 访客结束对话后评分

  • 数据报表： 会话趋势、消息统计、满意度、客服排名

  • 系统管理： 客服/访客分组、敏感词过滤、黑名单、多语言、云存储配置

八、注意事项

  • 生产环境必须关闭 app_debug，否则暴露服务器路径

  • MySQL 8 需修改框架层 Connection.php 中已废弃的 NO_AUTO_CREATE_USER

  • 换域名必须同步改 3 个配置文件，漏改会导致消息延迟或 404

  • 两个后台的密码加密算法不同，维护时注意区分

九、总结

一套架构清晰的多商户客服系统源码，ThinkPHP 5 + Workerman 组合成熟度高，部署门槛低。已包含实时聊天、机器人应答、多商户隔离、数据报表等企业级功能，适合快速搭建私有化客服平台。AI 智能客服和多渠道扩展是主要的二开方向。

下载地址

会员专享

本资源为会员专享，登录后开通会员即可下载

# WePoker# 在线客服