goflylivechat

环境要求

• MySQL ≥ 5.5 并已启动运行
• Go 语言环境（README 使用 go1.20.2.linux-amd64）
• Linux 或 Windows 操作系统
• 服务器需开放 8081 端口
• 可访问 GitHub 与 goproxy.cn 的网络环境

安装与启动步骤

1. 1创建 MySQL 数据库

   先安装并启动 MySQL（版本 ≥ 5.5），然后在 MySQL 中新建名为 goflychat 的库，字符集使用 utf8mb4。

   CREATE DATABASE goflychat CHARSET utf8mb4;

   复制

2. 2配置数据库连接

   编辑 config 目录下的 mysql.json，把 Server、Port、Database、Username、Password 改成你自己的 MySQL 连接信息。

3. 3安装配置 Golang

   下载并解压 go1.20.2，写入 PATH 后验证版本，并设置 GO111MODULE 与国内 GOPROXY 代理。

   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

   复制

4. 4下载源代码

   在任意目录克隆仓库并进入项目目录，后续所有命令都在该目录下执行。

   git clone https://github.com/taoshihan1991/goflylivechat.git
   cd goflylivechat

   复制

5. 5初始化数据库

   执行 install 子命令，让程序按 mysql.json 的配置建表并写入初始数据，必须成功后再启动服务。

   go run main.go install

   复制

6. 6启动应用

   运行 server 子命令启动客服系统，服务默认监听 8081 端口，前台保持运行即可。

   go run main.go server

   复制

7. 7编译可执行文件

   如需长期部署，可先编译为 gochat 二进制，再带参数启动，例如 -p 8082 指定端口、-d 后台运行。

   go build -o gochat
   ./gochat server -p 8082 -d

   复制

8. 8停止进程

   需要重启或下线服务时，用 killall 结束 gochat 进程，注意会终止该名称下的全部进程。

   killall gochat

   复制

关键配置

如何确认成功

启动后服务监听 8081 端口，浏览器访问 http://[your-ip]:8081 能看到客服系统页面即部署成功。

常见问题

注意事项

• README 中数据库连接文件的示例值为 Server=127.0.0.1、Port=3306、Database=goflychat、Username=goflychat、Password=goflychat，请替换为真实值。
• 服务默认端口为 8081，使用 -p 参数可改为其他端口（README 示例为 8082）。
• 生产环境建议用反向代理把域名指向 8081 端口，避免直接暴露端口号。
• killall gochat 会结束所有同名进程，操作前请确认没有其他服务受影响。