# 晴玖客服系统

**Repository Path**: QtCodeCreators/customer-service

## Basic Information

- **Project Name**: 晴玖客服系统
- **Description**: 晴玖客服系统-单商户版
- **Primary Language**: Go
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: https://www.79tian.com
- **GVP Project**: No

## Statistics

- **Stars**: 6
- **Forks**: 2
- **Created**: 2025-07-30
- **Last Updated**: 2025-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 客服系统, Go语言, 客服分配

## README

<div align="center">

# 晴玖客服系统

![Go Version](https://img.shields.io/badge/Go-1.19+-blue.svg)
![License](https://img.shields.io/badge/License-MIT-green.svg)
![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen.svg)
![Version](https://img.shields.io/badge/Version-1.0.0-orange.svg)

一个现代化、高性能的网页客服系统，采用Go语言开发，支持实时聊天、管理后台、智能回复等功能。

[功能特性](#功能特性) • [技术栈](#技术栈) • [快速开始](#快速开始) • [项目地址](https://gitee.com/QtCodeCreators/customer-service/) • [下载地址](https://gitee.com/QtCodeCreators/customer-service/releases)

</div>

---

## 📋 项目概述

**晴玖客服系统** 是一个简单易用的网页客服系统，支持实时聊天功能。

程序详细介绍：【安装教程，图文介绍】
https://docs.qq.com/doc/DTmNLRmpLeWZRQmtZ

**主要功能：**
- 💬 实时在线聊天
- 👥 多客服管理
- 📱 手机电脑都能用
- 🔧 宝塔面板一键安装

### 🎯 核心特性

- **💬 实时聊天**: 客户和客服可以实时对话
- **👥 多客服**: 可以添加多个客服账号
- **📝 消息记录**: 自动保存聊天记录
- **📱 简单易用**: 界面简洁，操作方便

## 🛠 技术栈

- **后端**: Go语言
- **数据库**: MySQL
- **前端**: JavaScript + HTML + CSS
- **部署**: 宝塔面板

## 🚀 快速开始

### 📦 推荐安装方式：宝塔面板部署（适合生产环境）

#### 1. 安装宝塔面板

**宝塔通用安装脚本：**
```bash
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh ed8484bec
```

#### 2. 安装必要组件

登录宝塔面板后，在「软件商店」中安装以下组件：
- **Nginx 1.28+** - Web服务器
- **MySQL 5.7+** - 数据库服务
- **Redis** - 缓存服务（应用商店安装最新版）

#### 3. 创建项目目录

在宝塔面板中：
1. 点击「文件」菜单
2. 进入 `/www/wwwroot` 目录
3. 创建新文件夹：`chat`

#### 4. 下载并部署程序

1. **创建项目目录并下载安装包**：
   ```bash
   # 创建项目目录（如果不存在）
   mkdir -p /www/wwwroot/chat
   cd /www/wwwroot/chat
   
   # 下载并解压程序安装包
   wget https://gitee.com/QtCodeCreators/customer-service/releases/download/v1.3.0/v1.3.0.zip
   unzip -j v1.3.0.zip -d /www/wwwroot/chat
   ```
   
   解压后会得到多个安装脚本（直接在`/www/wwwroot/chat`目录下）：
    - Linux系统：`download-linux.sh`
    - Windows系统：`download-windows.bat` 
    - macOS系统：`download-macos.sh`
    
    > 💡 **本教程以Linux系统为主**，Windows/macOS用户请使用对应脚本，使用方法与Linux类似。

2. **清理并执行安装脚本**：
   ```bash
   # 进入安装目录
   cd /www/wwwroot/chat
   # 清理其他脚本，只保留download-linux.sh
   rm -f download-windows.bat download-macos.sh
   
   # 赋予执行权限并执行
   chmod +x download-linux.sh
   ./download-linux.sh
   ```
   脚本会自动：
   - 检测系统架构
   - 下载对应的程序安装包
   - 自动解压到当前目录（/www/wwwroot/chat）

#### 5. 配置Go项目

在宝塔面板中：
1. 点击「网站」菜单
2. 选择「Go项目」
3. 点击「添加项目」
4. 填写以下信息：
   - **项目可执行程序**：选择解压后的程序文件 `customer-service`
   - **端口**：填写 `8180`
   - **勾选「放行端口」**（如果不勾选，需要配置域名访问）
   - **勾选「开机启动」**
5. 点击「确定」完成项目添加

#### 6. 配置数据库

1. 在宝塔面板「数据库」中创建新数据库：
   - 数据库名：`chat`
   - 用户名：`chat`
   - 密码：自定义强密码

2. 修改程序配置文件：
   ```bash
   cd /www/wwwroot/chat
   vim config.yaml
   ```
   
   更新数据库配置：
   ```yaml
   database:
     host: "127.0.0.1"
     port: 3306
     user: "chat"
     password: "你的数据库密码"
     dbname: "chat"
   ```

#### 7. 启动服务

在宝塔面板的「Go项目」中找到刚添加的项目，点击「启动」按钮。

#### 8. 访问系统

- **客户端访问**：`http://你的服务器IP:8180`
- **客服后台**：`http://你的服务器IP:8180/admin`
- **超级管理员后台**：`http://你的服务器IP:8180/super-admin`

#### 9. 默认账号密码

**超级管理员账号**（用于系统管理和配置）：
- 访问地址：`/super-admin`
- 用户名：`admin`
- 密码：`123456`

**客服账号**（用于日常客服工作）：
- 访问地址：`/admin`
- 用户名：`service`
- 密码：`123456`

⚠️ **安全提醒**：首次登录后请立即修改默认密码，确保系统安全！

#### 9. 配置域名访问（可选）

**推荐方案：宝塔面板一键配置**

如果你有域名，宝塔面板提供了最简单的域名绑定方式：
1. 在宝塔面板「网站」→「Go项目」中，找到你的项目
2. 点击「设置」→「域名管理」，添加你的域名
3. 系统会自动配置反向代理，无需手动操作，SSL证书的话也可以一键申请

**其他部署方式参考**

如果你使用其他部署方式：
- **Supervisor部署**：需手动配置Nginx反向代理到 `127.0.0.1:8180`
- **Docker部署**：推荐使用1Panel面板，支持一键域名绑定

💡 **提示**：宝塔面板的域名配置最简便，建议优先使用宝塔方案。

---

## 📞 联系我们

如有问题或建议，请联系我们：
- **客服QQ**: 1186258278
- **反馈邮箱**: keh5@vip.qq.com
- **反馈微信**: CodeCreator
- **项目地址**: https://gitee.com/QtCodeCreators/customer-service/
- **下载地址**: https://gitee.com/QtCodeCreators/customer-service/releases

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！