Node轻量级客服系统源码-开源版

本系统是一个纯 Node.js 实现的在线客服系统(访客聊天 + 客服工作台 + 管理后台),使用原生 WebSocket 通信,数据存储于 MySQL,无任何前端构建步骤。支持文字/图片聊天,会话管理,适合个人/小团队/企业用,页面简洁,PC+手机端都能用,部署简单;

核心功能
功能简介:
拉黑恶意用户
后台登录管理客服会话
固定客服链接一键复制
客户打开链接即可咨询
支持文字,图片聊天

Node轻量级客服系统源码-开源版 Node轻量级客服系统源码-开源版 Node轻量级客服系统源码-开源版 Node轻量级客服系统源码-开源版 Node轻量级客服系统源码-开源版 Node轻量级客服系统源码-开源版 Node轻量级客服系统源码-开源版

Node轻量级客服系统源码-开源版 Node轻量级客服系统源码-开源版

前端PC和手机咨询页面:

Node轻量级客服系统源码-开源版

Node轻量级客服系统源码-开源版

# 客服系统宝塔面板部署说明

本系统使用原生 WebSocket(`/ws` 路径),宝塔反向代理**必须配置 WebSocket Upgrade 头**,否则页面能打开但消息发不出去。以下为完整流程。

## 一、环境准备(宝塔面板)

1. **安装 Node 环境**:宝塔面板 → 软件商店 → 搜索安装 **「Node.js版本管理器」**,在其中安装 **Node.js 20 LTS**(需 ≥ 18)。
2. **安装 PM2**:软件商店搜索安装 **「PM2管理器」**(或装完 Node 后在终端执行 `npm install -g pm2`)。
3. **安装 MySQL**:软件商店安装 **MySQL 5.7 或 8.0**。

## 二、上传代码与安装依赖

1. 将项目上传到 `/www/wwwroot/客服系统`(或用 Git 拉取)。
2. 宝塔面板 → **终端**,执行:

```bash
cd /www/wwwroot/客服系统
npm install --no-audit --no-fund
```

> 也可直接在终端执行项目自带的 `bash install.sh`,脚本会自动完成 Node 检测、依赖安装、数据库配置校验和 PM2 启动。

## 三、配置数据库

方式一(推荐):宝塔面板 → **数据库** → 添加数据库(记下数据库名、用户名、密码),然后编辑项目根目录的 `chat-config.local.json`:

```json
{
"host": "127.0.0.1",
"port": 3306,
"user": "宝塔创建的数据库用户名",
"password": "宝塔创建的数据库密码",
"database": "宝塔创建的数据库名",
"connectionLimit": 10
}
```

方式二:终端执行 `bash install.sh`,脚本检测到数据库连接失败时会交互式提示输入并自动写入配置。

验证连接:

```bash
node chat-config.mjs check
```

> 系统首次启动会自动建表并创建初始管理员,无需手动导入 SQL。注意删除配置中 Linux 下无用的 `socketPath` 字段(如 `/tmp/mysql.sock` 不存在会导致连接失败)。

## 四、启动服务

**方式一:PM2 管理器(图形界面)**

PM2管理器 → 添加项目:

| 项目 | 值 |
| — | — |
| 项目名称 | kf-chat |
| 启动文件 | `/www/wwwroot/客服系统/chat-server.mjs` |
| 运行目录 | `/www/wwwroot/客服系统` |
| Node 版本 | 20.x |
| 端口 | 4173 |

**方式二:命令行 PM2**

```bash
cd /www/wwwroot/客服系统
CHAT_HOST=0.0.0.0 CHAT_PORT=4173 pm2 start chat-server.mjs --name kf-chat
pm2 save
pm2 startup # 开机自启
```

启动成功后,日志中会打印初始管理员账号密码(只打印一次,务必记录):

```bash
pm2 logs kf-chat --lines 50
```

## 五、添加站点并设置反向代理

1. 宝塔面板 → **网站** → 添加站点:填入域名,**不要创建 FTP/数据库**,PHP 版本选「纯静态」。
2. 打开站点设置 → **反向代理** → 添加反向代理:
– 代理名称:`kf-chat`
– 目标 URL:`http://127.0.0.1:4173`
– 发送域名:`$host`
3. **关键一步**:保存后点击反向代理列表右侧「配置文件」,确认代理配置中包含 WebSocket 相关头。宝塔默认模板不一定完整,推荐将配置改为:

```nginx
location /
{
proxy_pass http://127.0.0.1:4173;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade; # WebSocket 必须
proxy_set_header Connection "upgrade"; # WebSocket 必须
proxy_read_timeout 3600s; # 长连接保持,避免聊天频繁断开
proxy_send_timeout 3600s;
add_header X-Cache $upstream_cache_status;
}
```

4. 保存后测试:

```bash
nginx -t && nginx -s reload
```

> 提示:宝塔的代理配置文件位于 `/www/server/panel/vhost/nginx/proxy/你的域名/*.conf`,也可直接在面板「配置文件」中编辑。

## 六、配置 SSL(HTTPS)

站点设置 → **SSL** → Let’s Encrypt 申请证书 → 开启「强制 HTTPS」。

启用 HTTPS 后,浏览器会以 `wss://` 建立 WebSocket,上面的 Nginx Upgrade 配置对 `wss` 同样生效,服务端无需改动。

## 七、防火墙与安全

– **走反向代理时**:只需在 宝塔 → 安全 放行 `80/443`;`4173` 端口**不要**对外开放,避免绕过 Nginx 直连。
– **不走反向代理(临时测试)**:放行 `4173` 端口,并确保服务以 `CHAT_HOST=0.0.0.0` 启动。

## 八、验证部署

1. 打开 `https://你的域名/`,出现访客聊天窗口并收到欢迎语。
2. 打开 `/login`,用初始管理员账号登录(密码见 PM2 日志)。
3. 打开 `/service` 客服工作台,访客上线后出现在会话列表,互发文字/图片正常。
4. 重启 PM2 项目后历史消息仍在,说明 MySQL 持久化正常。

## 九、常见问题

| 现象 | 处理方法 |
| — | — |
| 页面能打开但消息发不出去 / 聊天频繁断开 | 反代配置缺少 `Upgrade`/`Connection` 头,或 `proxy_read_timeout` 过短,见第五节 |
| 反代出现 502 | 服务未启动或端口不对,执行 `pm2 logs kf-chat` 查看;确认监听 `127.0.0.1:4173` |
| 启动报 MySQL 初始化失败 | 执行 `node chat-config.mjs check` 查看具体原因;检查宝塔数据库账号密码及权限 |
| 使用 `socketPath: /tmp/mysql.sock` 报错 | 宝塔 MySQL 通常走 TCP,删除配置中的 `socketPath` 字段即可 |
| 忘记管理员密码 | 删除数据库 `agents` 表中对应行后重启服务重新生成,或设置 `CHAT_ADMIN_PASSWORD` 环境变量 |

1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是赞助,收取费用仅维持本站的日常运营所需!
7. 如遇到加密压缩包,请使用WINRAR解压,如遇到无法解压的请联系管理员!
8. 精力有限,不少源码未能详细测试(解密),不能分辨部分源码是病毒还是误报,所以没有进行任何修改,大家使用前请进行甄别
TP源码网 » Node轻量级客服系统源码-开源版

提供最优质的资源集合

立即查看 了解详情