项目简介
本项目是基于Golang语言和MySQL数据库构建的实时在线客服系统,为访客和客服提供了实时通讯的平台。采用Gin框架进行Web开发,并集成了gorilla websocket库处理WebSocket通信,具备访客登录、聊天、客服管理、系统通知等一系列功能。
项目的主要特性和功能
- 访客管理:支持访客登录、注销和在线状态更新,保障访客信息安全与实时性。
- 客服管理:包含客服注册、登录及管理功能,可对客服信息进行添加、修改、删除和查询。
- 实时通讯:运用WebSocket技术实现访客与客服间的实时聊天,支持文字、图片等消息的收发。
- 系统通知:能向访客和客服发送系统通知,如客服上线通知、访客消息通知等。
- 权限管理:通过角色和权限管理,控制不同角色(超级管理员、客服、访客)的访问和操作权限。
- 安全性:采用JWT进行身份验证和授权,确保系统安全和数据保密。
- 自动回复:客服端和访客端均支持关键词自动回复,访客端还有自助服务自动回复功能。
- 界面优化:不断优化访客端和客服端的界面样式,修复界面问题,提升用户体验。
- 性能优化:后端增加定时清理频限,防止内存泄露,增加通知频限和访客输入频限防止死锁。
安装使用步骤
前提条件
已安装和运行mysql >=5.5版本,安装Golang开发环境,确保已经安装了Git。
数据库配置
- 创建gofly数据库:
create database gofly charset utf8;
- 在config目录mysql.json中配置数据库
php { "Server":"127.0.0.1", "Port":"3306", "Database":"gofly", "Username":"go-fly", "Password":"go-fly" }
二进制文件运行
- 文件解压缩
- windows系统下,在cmd命令行,进入项目解压后目录。
- linux系统下创建目录执行如下:
bash mkdir go-fly cd go-fly wget xxxxxxxxxxx.zip unzip xxxx.zip chmod 0777 -R./
- 导入数据库(注意:会删除表并且清空数据)
- windows:
go-fly.exe install
- linux:
./go-fly install
- windows:
- 运行项目
- linux:
./go-fly server [可选 -p 8082 -d]
- windows:
go-fly.exe server [可选 -p 8082]
- linux:
- 参数说明
-p
:指定端口-d
:linux下是否以daemon守护进程运行-h
:查看帮助
源码运行
- 基于go module使用
bash go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct 进入go-fly 目录
- 源码运行:
go run go-fly.go server
- 源码打包:
go build go-fly.go
会生成go-fly可以执行文件 - 导入数据库(会删除表清空数据):
./go-fly install
- 二进制文件运行
- linux:
./go-fly server [可选 -p 8082 -d]
- windows:
go-fly.exe server [可选 -p 8082 -d]
- linux:
- 关闭程序
./go-fly stop
- linux下使用ps命令结合kill命令杀掉进程
bash ps -ef|grep go-fly 看到父子进程id kill 进程父进程id ; kill 进程子进程id
网页使用
- 服务端安装成功后可把域名换成自己的域名或IP。
- 默认访问本地http://127.0.0.1:8081 ```php //下面js路径和GOFLY_URL 都要改成自己的
```
nginx部署
访问:https://gofly.sopans.com
1. 参考支持https的部署示例,注意反向代理的端口号和证书地址,不使用https也可以访问,只是不会有浏览器通知弹窗。
2. 尽量按照下面的配置处理,配置独立域名或者二级域名,不建议在主域名加端口访问,不建议主域名加目录访问。
3. 如果遇到域名跨域错误问题,检查下面配置中add_header Access-Control-Allow-Origin这俩header头是否添加。
php
server {
listen 443 ssl http2;
ssl on;
ssl_certificate conf.d/cert/4263285_gofly.sopans.com.pem;
ssl_certificate_key conf.d/cert/4263285_gofly.sopans.com.key;
ssl_session_timeout 5m;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_prefer_server_ciphers on;
#listen 80;
server_name gofly.sopans.com;
access_log /var/log/nginx/gofly.sopans.com.access.log main;
location /static {
root /var/www/html/go-fly;//自己的部署路径,静态文件直接nginx响应
}
location / {
proxy_pass http://127.0.0.1:8081;
proxy_http_version 1.1;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Origin "";
}
}
server{
listen 80;
server_name gofly.sopans.com;
access_log /var/log/nginx/gofly.sopans.com.access.log main;
location /static {
root /var/www/html/go-fly;//自己的部署路径,静态文件直接nginx响应
}
location / {
proxy_pass http://127.0.0.1:8081;
proxy_http_version 1.1;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Origin "";
}
}
宝塔部署
原文地址:https://www.zqcnc.cn/post/99.html
宝塔环境
- 创建一个静态站点,地址为想要访问的域名。
- 为该站点配置证书。
- 设置反向代理。
- 修改反代配置,按照图示,将对应代码加入到配置文件中。 ```shell
PROXY-START/
location ~ .(php|jsp|cgi|asp|aspx)$ { add_header Access-Control-Allow-Origin ; add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS'; proxy_pass http://127.0.0.1:8081; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header REMOTE-HOST $remote_addr;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Origin "";
} location / { add_header Access-Control-Allow-Origin *; add_header Access-Control-Allow-Methods 'GET, POST, OPTIONS'; proxy_pass http://127.0.0.1:8081; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header REMOTE-HOST $remote_addr;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Origin "";
add_header X-Cache $upstream_cache_status;
#Set Nginx Cache
add_header Cache-Control no-cache;
expires 12h;
} ```
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】