GO-FLY 开源客服系统安装与配置指南
一、项目基础介绍
GO-FLY 是一个使用 Golang 语言开发的在线客服系统,它是一个开源的自托管私有云客服聊天软件。该项目旨在为用户提供一个易于部署和维护的客服解决方案,适用于个人学习和测试使用。
二、项目使用的关键技术和框架
- 编程语言:Golang
- Web 框架:Gin
- 身份验证:JWT(JSON Web Tokens)
- WebSocket:用于客服之间的即时通讯
- 数据库:GORM(用于操作 MySQL)
- 前端框架:VueJS 和 ElementUI
- 命令行工具: Cobra
三、项目安装和配置的准备工作
在开始安装之前,请确保您的系统中已安装以下软件:
- Golang:建议版本 1.20.2 或以上
- MySQL:建议版本 5.5 或以上
- Git:用于克隆项目代码
安装 Golang
-
下载 Golang 安装包:
wget https://studygolang.com/dl/golang/go1.20.2.linux-amd64.tar.gz
-
解压安装包到
/usr/local
目录:tar -C /usr/local -xvf go1.20.2.linux-amd64.tar.gz
-
移动安装包到
/tmp
目录(可选):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
安装 MySQL
请根据您的操作系统下载并安装 MySQL。确保在安装过程中设置了 root 密码。
安装 Git
如果您的系统中尚未安装 Git,请使用系统的包管理器进行安装。
克隆项目代码
在任意目录下执行以下命令克隆项目代码:
git clone https://github.com/taoshihan1991/go-fly.git
配置 MySQL
-
登录 MySQL 数据库:
mysql -u root -p
-
创建新的数据库
gofly
:create database gofly charset utf8mb4;
-
退出 MySQL。
配置项目数据库连接
打开 config
目录下的 mysql.json
文件,根据您的 MySQL 安装情况填写相关信息:
{
"Server": "127.0.0.1",
"Port": "3306",
"Database": "gofly",
"Username": "root",
"Password": "your_mysql_password"
}
安装项目依赖
进入项目目录,执行以下命令安装项目依赖:
go mod tidy
初始化数据库
运行以下命令导入数据库结构:
go run go-fly.go install
启动项目
运行以下命令启动项目:
go run go-fly.go server
项目将默认监听 8081 端口,可以通过浏览器访问 http://localhost:8081
来查看运行状态。
以上步骤为基本的安装和配置过程,实际部署时可能需要根据具体环境进行调整。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考