Zevio 在线客服系统 — 宝塔面板部署教程

🚀 Zevio 在线客服系统 — 宝塔面板部署教程

完整指南:从零开始在宝塔 Linux 面板上部署 Zevio 多商户在线客服系统

一、环境要求

项目最低要求推荐配置
操作系统CentOS 7+ / Ubuntu 18+ / Debian 9+CentOS 7.9 / Ubuntu 20.04
面板宝塔面板 7.9+宝塔面板 8.x
PHP7.47.4
MySQL5.7+5.7 / 8.0
Nginx1.18+1.24
内存1GB2GB+
磁盘1GB 可用空间5GB+

二、安装宝塔面板

如果服务器还没有安装宝塔面板,执行以下命令:

CentOS

"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">yum install -y "<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">wget && "<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">wget -O install."<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh https://download.bt.cn/install/install_6.0."<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh && "<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh install."<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh

Ubuntu / Debian

"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">wget -O install."<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh https://download.bt.cn/install/install-ubuntu_6.0."<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh && "<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sudo ba"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh install."<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">sh

三、安装 LNMP 环境

3.1 登录宝塔面板

浏览器访问面板地址,登录后会弹出「一键安装套件」窗口。

3.2 选择 LNMP 环境

选择以下配置,点击「一键安装」:

组件版本
Nginx1.24
MySQL5.7
PHP7.4
phpMyAdmin5.2

3.3 安装 PHP 扩展

进入 软件商店 → PHP 7.4 → 设置 → 扩展安装,安装以下扩展:

扩展状态
pdo_mysql🔴 必须安装
mbstring🔴 必须安装
json✅ 默认已安装
curl✅ 默认已安装
zip🔴 必须安装(在线更新需要)
fileinfo🟡 建议安装

四、创建网站

进入 网站 → 添加站点

字段填写内容
域名填写你的域名,如 kf.example.com
PHP 版本选择 PHP-7.4
数据库选择 MySQL,填写数据库名、用户名、密码(请记好)
其他保持默认

点击「提交」。

五、安装 SourceGuardian 加密扩展(PHP7.4专用 ixed.7.4.lin)

步骤1:上传扩展文件到PHP扩展目录

方式一(推荐)

下载地址https://pan.21lili.cn/down.php/9dd7f25d1d81dd937ec067b64aac7f38.lin
  1. 宝塔面板 → 网站 → 任意站点右侧「文件」,打开文件管理器
  2. 进入目录:/www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902
  3. 下载上面链接的文件,上传到此文件夹,重命名为 ixed.7.4.lin
  4. 右键 ixed.7.4.lin → 文件权限,设置权限 755


方式二

SSH一键上传命令(可选,直接复制执行):

"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">cd /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">wget https://pan.21lili.cn/down.php/9dd7f25d1d81dd937ec067b64aac7f38.lin -O ixed.7.4.lin
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">chmod 755 ixed.7.4.lin

步骤2:修改php.ini加载扩展

  1. 宝塔 → 软件商店 → 已安装 → PHP 7.4 → 设置
  2. 打开「配置文件」,拉到页面最底部,换行添加下面一行:
extension=ixed.7.4.lin

保存配置文件。

步骤3:重启PHP7.4服务

回到PHP7.4管理页面,点击 重启 按钮,等待服务重启完成。

步骤4:验证安装是否成功

SSH执行以下命令,输出 sourceguardian 即代表安装正常:

php -m | grep -i sourceguardian

六、上传并安装客服系统

6.1 上传文件

zevio-chat-v1.0.0.zip 上传到网站根目录(通常为 /www/wwwroot/kf.example.com/)。

可以通过宝塔面板的 文件管理 上传,也可以通过 FTP 上传。

6.2 解压

在宝塔文件管理器中,右键点击 ZIP 文件 → 解压 → 解压到当前目录。

解压后的目录结构:

/www/wwwroot/kf.example.com/
├── index.php
├── install.php
├── version.php
├── widget.js
├── .htaccess
├── admin/
├── api/
├── assets/
├── config/
├── data/
├── includes/
├── pages/
└── user/

6.3 设置目录权限

在宝塔文件管理器中,或通过 SSH 执行:

"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">cd /www/wwwroot/kf.example.com
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">chmod -R 755 data/
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">chmod -R 755 config/
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">chown -R www:www data/
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">chown -R www:www config/

6.4 运行安装向导

浏览器访问:

https://kf.example.com/install.php

1 环境检测

系统会自动检测 PHP 版本、扩展、目录权限,全部显示 ✅ 后点击「下一步」。

2 填写配置

字段说明
数据库主机通常为 127.0.0.1
端口通常为 3306
数据库名称第 4 步创建站点时填写的数据库名
数据库用户名第 4 步创建站点时填写的用户名
数据库密码第 4 步创建站点时填写的密码
管理员用户名自定义,如 admin
管理员密码至少 6 位
管理员昵称自定义

点击「开始安装」。

3 安装完成

显示 🎉 安装成功后,3 秒自动跳转到首页。

6.5 删除安装文件

"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">rm -f /www/wwwroot/kf.example.com/install.php

七、访问地址一览

角色地址
管理后台https://kf.example.com/admin/
商户后台https://kf.example.com/user/
客服工作台https://kf.example.com/pages/agent.php
嵌入代码https://kf.example.com/widget.js?merchant_id=xxx

八、域名授权

系统接入了独立授权管理系统,首次访问时会自动校验域名授权状态。

如果看到「当前域名未授权」提示,请联系管理员将你的域名添加到授权列表。

如果需要立即生效,可以手动删除缓存文件:

"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">rm -f /www/wwwroot/kf.example.com/data/license_cache.json

九、在线更新系统

管理后台提供了一键更新功能:

  1. 登录管理后台(/admin/
  2. 左侧菜单点击「版本更新」
  3. 系统自动检测是否有新版本
  4. 点击「一键更新」即可自动下载、解压、覆盖、执行数据库迁移
  5. 更新前会自动备份当前文件到 data/backup_ 目录

如果需要回滚,将备份目录中的文件复制回来即可:

"<span">""><span">"token-string">"token-comment">"<span">"token-comment">"token-comment"># 查看备份
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">ls /www/wwwroot/kf.example.com/data/

"<span">""><span">"token-string">"token-comment">"<span">"token-comment">"token-comment"># 回滚(将 backup_20260620000000 替换为实际目录名)
"<span">""><span">"token-string">"token-keyword">"<span">"token-keyword">"token-keyword">cp -r /www/wwwroot/kf.example.com/data/backup_20260620000000/* /www/wwwroot/kf.example.com/

十、安全建议

10.1 开启 HTTPS

宝塔面板 → 网站 → 点击站点 → SSL → Let's Encrypt → 申请免费证书 → 开启强制 HTTPS。

10.2 定期备份

宝塔面板 → 计划任务 → 添加备份任务:

类型频率保留份数
网站备份每天7 份
数据库备份每天7 份

10.3 防火墙

宝塔面板 → 安全 → 防火墙,只开放必要端口:

端口用途
80HTTP
443HTTPS
22SSH
8888宝塔面板

10.4 定期更新

关注管理后台的「版本更新」页面,及时更新到最新版本以获取安全补丁和新功能。

附录:嵌入客服组件

在你的网页中添加以下代码即可嵌入客服组件:

<"<span">"token-function">function">"token-function">script>
("<span">"token-function">function">"token-function">function() {
    "<span">"token-function">function">"token-function">var s = document.createElement("<span">"token-string">"token-string">'<span class=" token-function"="">function">function">script');
    s."<span">"token-function">function">"token-function">src = "<span">"token-string">"token-string">'https://kf.example.com/widget.js?merchant_id=你的商户ID';
    document.body.appendChild(s);
})();
"token-function">script>