客服系统搭建教程

📦 推荐安装方式：宝塔面板部署（适合生产环境）

1. 安装宝塔面板

宝塔通用安装脚本：

if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec

2. 安装必要组件

登录宝塔面板后，在「软件商店」中安装以下组件：

Nginx 1.28+ – Web服务器

MySQL 5.7+ – 数据库服务

Redis – 缓存服务（应用商店安装最新版）

3. 创建项目目录

在宝塔面板中：

点击「文件」菜单

进入 /www/wwwroot 目录

创建新文件夹：chat

4. 下载并部署程序

创建项目目录并下载安装包：

# 创建项目目录（如果不存在）

mkdir -p /www/wwwroot/chat

cd /www/wwwroot/chat

# 下载并解压程序安装包

wget https://gitee.com/QtCodeCreators/customer-service/releases/download/v3.1.0/v3.1.0.zip

unzip -j v3.1.0.zip -d /www/wwwroot/chat

解压后会得到多个安装脚本（直接在/www/wwwroot/chat目录下）：

Linux系统：download-linux.sh

Windows系统：download-windows.bat

macOS系统：download-macos.sh

💡 本教程以Linux系统为主，Windows/macOS用户请使用对应脚本，使用方法与Linux类似。

清理并执行安装脚本：

# 进入安装目录

cd /www/wwwroot/chat

# 清理其他脚本，只保留download-linux.sh

rm -f download-windows.bat download-macos.sh

# 赋予执行权限并执行

chmod +x download-linux.sh

./download-linux.sh

脚本会自动：

检测系统架构

下载对应的程序安装包

自动解压到当前目录（/www/wwwroot/chat）

设置程序文件执行权限

5. 配置Go项目

在宝塔面板中：

点击「网站」菜单

选择「Go项目」

点击「添加项目」

填写以下信息：

项目可执行程序：选择解压后的程序文件 customer-service

端口：填写 8180

勾选「放行端口」（如果不勾选，需要配置域名访问）

勾选「开机启动」

点击「确定」完成项目添加

6. 配置数据库

在宝塔面板「数据库」中创建新数据库：

数据库名：chat

用户名：chat

密码：自定义强密码

修改程序配置文件：

cd /www/wwwroot/chat

vim config.yaml

更新数据库配置：

database:

  host: “127.0.0.1”

  port: 3306

  user: “chat”

  password: “你的数据库密码”

  dbname: “chat”

7. 启动服务

在宝塔面板的「Go项目」中找到刚添加的项目，点击「启动」按钮。

8. 访问系统

客户端访问：http://你的服务器IP:8180

客服后台：http://你的服务器IP:8180/admin

超级管理员后台：http://你的服务器IP:8180/super-admin

商户后台：http://你的服务器IP:8180/merchant

9. 默认账号密码

超级管理员账号（用于系统管理和配置）：

访问地址：/super-admin

用户名：admin

密码：123456

商户后台账号（用于商户测试）：

访问地址：/merchant

用户名：test

密码：123456

客服账号（用于日常客服工作）：

访问地址：/admin

用户名：service

密码：123456

⚠️ 安全提醒：首次登录后请立即修改默认密码，确保系统安全！