开源客服系统GO-FLY使用指南

【核心功能解析】开源客服系统5大核心模块

开源客服系统是企业与客户在线沟通的重要工具，GO-FLY基于Golang开发，具备轻量化部署、实时通信等特点。

核心模块

• 通信模块：基于WebSocket（实时双向通信技术）实现客服与访客的即时消息交互
• 用户管理：支持多客服账号、角色权限分配及在线状态监控
• 消息处理：包含消息存储、历史记录查询和离线消息推送功能
• 访客跟踪：记录访客IP、来源页面及会话轨迹分析
• 系统配置：提供数据库连接、安全策略等个性化设置

支撑组件

• 中间件：包含跨域处理、JWT认证（JSON Web Token，一种身份验证机制）等功能
• 工具集：提供IP解析、文件处理等实用工具函数
• 前端资源：内置Element UI、Vue等前端框架支持

配置文件

• config/mysql.json：数据库连接配置文件
• common/config.go：系统全局配置定义
• controller/setting.go：管理后台配置接口

【环境准备】4步搭建开源客服系统运行环境

前置检查清单

1. 确保已安装Go 1.15+环境
2. 准备MySQL 5.7+数据库服务
3. 检查8080端口是否被占用
4. 网络环境需支持WebSocket通信

获取源码

# Linux/macOS
git clone https://gitcode.com/gh_mirrors/gof/goflylivechat
cd goflylivechat

# Windows
git clone https://gitcode.com/gh_mirrors/gof/goflylivechat
cd goflylivechat

依赖安装

# 安装Go依赖包
go mod download

数据库准备

# 导入初始化SQL
mysql -u root -p < import.sql

注意：首次运行需确保数据库用户有创建表的权限

【快速上手】3步启动开源客服系统服务

📌 步骤1：配置数据库连接

// 修改 config/mysql.json 文件
{
  "Server": "127.0.0.1",    // 数据库地址
  "Port": "3306",           // 数据库端口
  "Database": "gofly",      // 数据库名称
  "Username": "root",       // 数据库用户名
  "Password": "yourpass"    // 数据库密码
}

📌 步骤2：启动服务

# Linux/macOS
go run main.go server

# Windows
go run main.go server

📌 步骤3：访问系统

• 管理端：http://localhost:8080/login
• 默认账号：admin 密码：123456
• 访客端：http://localhost:8080

故障排查提示

• 服务启动失败：检查数据库连接配置和MySQL服务状态
• 无法访问页面：确认8080端口未被占用，关闭防火墙重试
• 登录失败：检查数据库中users表是否有管理员账号

【深度配置】5分钟配置指南优化开源客服系统

基础参数配置

// common/config.go 核心配置
const (
  AppName = "GO-FLY"           // 应用名称
  Version = "v2.2"             // 系统版本
  HttpPort = ":8080"           // HTTP服务端口
  WsPath = "/ws"               // WebSocket路径
  MaxOnline = 1000             // 最大在线人数限制
)

安全设置

• 设置IP黑名单：通过controller/ip.go配置恶意IP拦截
• 会话超时配置：在middleware/session.go调整会话过期时间
• 跨域设置：修改middleware/cross.go配置允许的域名

常见误区：不要将生产环境的JWT密钥保持默认值，需在tools/jwt.go中修改密钥

个性化设置

• 修改客服欢迎语：编辑models/welcomes.go中的默认欢迎消息
• 更换系统logo：替换static/images/logo.png文件
• 调整界面主题：修改static/css/gofly-front.css自定义样式

通过以上配置，您可以快速搭建并定制属于自己的开源客服系统，满足企业在线客服需求。系统采用模块化设计，便于后续功能扩展和二次开发。