开源客服系统GO-FLY使用教程

宣昀芊

于 2025-04-09 09:40:27 发布

阅读量927

点赞数 25

本文链接：https://blog.youkuaiyun.com/gitblog_00622/article/details/147085048

版权

开源客服系统GO-FLY使用教程

go-fly 开源在线客服系统GO语言开发GO-FLY,免费在线客服系统/open source self-hosted private cloud customer support live chat software by golang 项目地址: https://gitcode.com/gh_mirrors/gof/go-fly

一、项目介绍

GO-FLY 是一个开源的在线客服系统，使用 Golang 语言开发。该系统主要采用了 gin、jwt-go、websocket、go.uuid、gorm、cobra、VueJS、ElementUI 和 MySQL 等技术。GO-FLY 旨在为用户提供一个简单易用、性能优良的私有云客服解决方案。

二、项目快速启动

1. 环境准备

安装并运行 MySQL 数据库（版本 >= 5.5），创建数据库：
```
create database gofly charset utf8mb4;
```

配置数据库连接信息，在 config 目录下的 mysql.json 文件中：

{
  "Server": "127.0.0.1",
  "Port": "3306",
  "Database": "gofly",
  "Username": "go-fly",
  "Password": "go-fly"
}

安装配置 Golang 运行环境，执行以下命令：

wget https://studygolang.com/dl/golang/go1.20.2.linux-amd64.tar.gz
tar -C /usr/local -xvf go1.20.2.linux-amd64.tar.gz
mv go1.20.2.linux-amd64.tar.gz /tmp
echo "PATH=\$PATH:/usr/local/go/bin" >> /etc/profile
echo "PATH=\$PATH:/usr/local/go/bin" >> ~/.bashrc
source /etc/profile
go version
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn,direct

2. 下载代码

在任意目录下执行以下命令下载代码：

git clone https://github.com/taoshihan1991/go-fly.git

3. 导入数据库和运行程序

进入 go-fly 目录，导入数据库：
```
go run go-fly.go install
```
源码运行：
```
go run go-fly.go server
```
源码打包（生成可执行文件）：
```
go build -o kefu
```
二进制文件运行（可选参数 -p 8082 -d）：
- Linux：./kefu server [-p 8082 -d]
- Windows：kefu.exe server [-p 8082 -d]

4. 关闭程序

killall kefu

5. 访问程序

程序正常运行后，监听端口 8081，可以直接通过 IP+端口 8081 访问，也可以配置域名访问，反向代理到 8081 端口。

三、应用案例和最佳实践

1. 客服对接

聊天链接：

http://127.0.0.1:8081/chatIndex?kefu_id=kefu2

弹窗使用示例：

<script>
(function(a, b, c, d) {
  let h = b.getElementsByTagName('head')[0];
  let s = b.createElement('script');
  s.type = 'text/javascript';
  s.src = c + "/static/js/kefu-front.js";
  s.onload = s.onreadystatechange = function() {
    if (!this.readyState || this.readyState === "loaded" || this.readyState === "complete") d(c);
  };
  h.appendChild(s);
})(window, document, "http://127.0.0.1:8081", function(u) {
  KEFU.init({
    KEFU_URL: u,
    KEFU_KEFU_ID: "kefu2",
  });
});
</script>