这是春松客服系统网站源码和搭建教程，本文章主要对这个春松客服系统进行介绍还要分享这个源码和搭建教程，如果需要企业部署可能需要联系作者获得授权。
注意：本源码建议docker一键部署搭建，更方便简单，如果自己不会搭建可以网站底部获得我联系方式，付费进行搭建（只管搭建）源码下载链接如下，gitee开源链接:https://gitee.com/cskefu/cskefu
功能介绍
春松客服提供的开源代码，即CSKeFu，包含多个开箱即用的模块：
- 账号及组织机构管理：按组织、角色分配账号权限
- 坐席监控：设置坐席监控角色的人员可以看到并干预访客会话
- 联系人和客户管理：CRM 模块，管理联系人和客户，细粒度维护客户信息，自定义标签和打标签，记录来往历史等
- 网页渠道组件：一分钟接入对话窗口，支持技能组、邀请和关联联系人等
- Facebook 渠道组件：快速接入 Facebook Messenger 渠道，通过 Messenger 支持 Facebook 粉丝页、Shopify 等海外社交、电商平台
- 坐席工作台：汇聚多渠道访客请求，坐席根据策略自动分配，自动弹屏，转接等
- 机器人客服：与Chatopera 云服务集成
- 企业聊天：支持企业员工在春松客服系统中群聊和私聊
- 质检：历史会话、服务小结、服务反馈及相关报表
了解功能详细介绍，参考文档中心。
产品演示
欢迎页
展开查看更多产品截图
快速开始
春松客服用户使用指南
- 快速的了解和介绍春松客服
- 快速的查找和春松客服相关的材料
下载《春松客服用户使用指南》。
安装部署
支持云原生环境，容器化一键部署，现在使用春松客服！参考《私有部署文档》。
系统初始化
部署后，进行系统初始化，为组织设定部门、权限、账号等，参考《系统初始化文档》。
运维
备份、升级、回滚等运维工作，参考《系统维护文档》。
运营使用指南
关于产品的具体使用说明，请参考《春松客服文档》。
立即上线机器人客服
超过 85% 的春松客服企业客户通过 Chatopera 云服务上线机器人客服！7×24 小时在线，接待访客，辅助人工坐席，提升 10 倍工作效率。Chatopera 机器人平台包括知识库、多轮对话、意图识别和语音识别等组件，标准化聊天机器人开发。
展开查看更多机器人客服介绍
客服系统搭建教程
准备条件
前提
| 说明 | |
|---|---|
| 操作系统 | Linux (CentOS 7.x, Ubuntu 16.04+ 等)，推荐使用 Ubuntu LTS |
| Docker 版本 | Docker version 1.13.x 及以上 |
| Docker Compose 版本 | version 1.23.x 及以上 |
| 防火墙端口 | 8035, 8036 |
| 其他软件 | git |
| 内存 | 开发测试 >= 8GB | 生产环境 >= 16GB |
| CPU 颗数 | 开发测试 >= 2 | 生产环境 >= 4 |
| 硬盘 | >= 20GB |
安全组
如果使用云主机，要考虑到不同云服务提供商的安全组设置，允许 8035 和 8036 端口下行。
克隆代码
git clone -b develop https://gitee.com/cskefu/cskefu.git cskefu.develop
cd cskefu.develop
以上命令中，develop 代表开发中的大版本，当前是 cskefu/cskefu v8。
| 分支 | 说明 | 版本 |
|---|---|---|
| master | 当前稳定版本 | v7.x |
| develop | 当前开发版本 | v8.x |
克隆代码时，按照需要指定分支信息；本部署文档针对春松客服 v8.x 版本。
配置项
cd cskefu.develop
cp sample.env .env
以下为部署相关的环境变量，可以在 .env 中覆盖默认值。
| KEY | 默认值 | 说明 |
|---|---|---|
| COMPOSE_FILE | docker-compose.yml | 服务编排描述文件，保持默认值 |
| COMPOSE_PROJECT_NAME | cskefu | 服务实例的容器前缀，可以用其它字符串 |
| MYSQL_PORT | 8037 | MySQL 数据库映射到宿主机器使用的端口 |
| REDIS_PORT | 8041 | Redis 映射到宿主机器的端口 |
| CC_WEB_PORT | 8035 | 春松客服 Web 服务地址映射到宿主机器的端口 |
| CC_SOCKET_PORT | 8036 | 春松客服 SocketIO 服务映射到宿主机器的端口 |
| ACTIVEMQ_PORT1 | 8051 | ActiveMQ 端口 |
| ACTIVEMQ_PORT2 | 8052 | ActiveMQ 端口 |
| ACTIVEMQ_PORT2 | 8053 | ActiveMQ 端口 |
| DB_PASSWD | 123456 | 数据库密码，设置到 MySQL, Redis, ActiveMQ |
| LOG_LEVEL | INFO | 日志级别，可使用 WARN, ERROR, INFO, DEBUG |
以上配置中，端口的各默认值需要保证在宿主机器上还没有被占用；数据库的密码尽量复杂；CC_WEB_PORT 和 CC_SOCKET_PORT 这两个值尽量不要变更；生产环境下 LOG_LEVEL 使用至少 WARN 的级别。
以下为一些业务功能相关配置的环境变量：
| KEY | 默认值 | 说明 |
|---|---|---|
| TONGJI_BAIDU_SITEKEY | placeholder | 使用百度统计 记录和查看页面访问情况，默认不记录 |
| EXTRAS_AUTH_SUPER_ADMIN_PASS | admin1234 | 系统超级管理员 admin 的初始化密码 |
| EXTRAS_LOGIN_BANNER | off | 登录页上方展示通知的内容，默认(off)不展示 |
| EXTRAS_LOGIN_CHATBOX | off | 登录页支持加入一个春松客服网页渠道聊天按钮，比如 https://oh-my.cskefu.com/im/xxx.html，默认(off)不展示 |
管理命令
启动服务
cd cskefu # 进入下载后的文件夹
docker-compose pull # 拉取镜像
docker-compose up -d contact-center # 启动服务
查看服务状态
docker-compose ps
查看服务日志
docker-compose logs -f contact-center
登陆系统
在日志中，查看到如下类似信息，代表服务已经启动。
INFO c.c.socketio.SocketIOServer – SocketIO server started at port: 8036 [nioEventLoopGroup-2-1]
INFO com.chatopera.cc.Application – Started Application in 35.319 seconds (JVM running for 42.876) [main]
然后，从浏览器打开 http://YOUR_IP:CC_WEB_PORT/ 访问服务。 默认管理员账号： admin 密码： admin1234
关闭服务
docker-compose down
重启服务
docker-compose restart
无网络访问条件下部署
利用其他机器
首先，找一个网络条件好的电脑或服务器，安装 docker。
下载镜像
然后，在新的电脑下载镜像。
方法，执行命令：
docker pull IMAGE_NAME
IMAGE_NAME 参考 docker-compose.yml 中各服务的 image， 比如： docker pull cskefu/contact-center:develop
春松客服包含多个 image。
导出镜像
下载好 image 后，导出 image，将所有 image 使用下面命令导出为 tgz 文件
docker save cskefu/contact-center:develop > cc.docker.tgz
上传镜像
将所有导出的 image tgz 文件上传到目标部署的服务器 即网络条件不好的机器，比如用 FTP 工具或 SCP 命令。
安装镜像
上传到目标机器后，安装镜像 docker load < cc.docker.tgz
安装成功后，会提示。
启动服务
启动春松客服，参考本章以上内容。
cd cskefu # 源文件下载地址
docker-compose up -d contact-center
下一步
配置 HTTPS
系统初始化
系统维护
准备条件
前提
| 说明 | |
|---|---|
| 操作系统 | Linux (CentOS 7.x, Ubuntu 16.04+ 等)，推荐使用 Ubuntu LTS |
| Docker 版本 | Docker version 1.13.x 及以上 |
| Docker Compose 版本 | version 1.23.x 及以上 |
| 防火墙端口 | 8035, 8036 |
| 其他软件 | git |
| 内存 | 开发测试 >= 8GB | 生产环境 >= 16GB |
| CPU 颗数 | 开发测试 >= 2 | 生产环境 >= 4 |
| 硬盘 | >= 20GB |
安全组
如果使用云主机，要考虑到不同云服务提供商的安全组设置，允许 8035 和 8036 端口下行。
克隆代码
git clone -b develop https://gitee.com/cskefu/cskefu.git cskefu.develop
cd cskefu.develop
以上命令中，develop 代表开发中的大版本，当前是 cskefu/cskefu v8。
| 分支 | 说明 | 版本 |
|---|---|---|
| master | 当前稳定版本 | v7.x |
| develop | 当前开发版本 | v8.x |
克隆代码时，按照需要指定分支信息；本部署文档针对春松客服 v8.x 版本。
配置项
cd cskefu.develop
cp sample.env .env
以下为部署相关的环境变量，可以在 .env 中覆盖默认值。
| KEY | 默认值 | 说明 |
|---|---|---|
| COMPOSE_FILE | docker-compose.yml | 服务编排描述文件，保持默认值 |
| COMPOSE_PROJECT_NAME | cskefu | 服务实例的容器前缀，可以用其它字符串 |
| MYSQL_PORT | 8037 | MySQL 数据库映射到宿主机器使用的端口 |
| REDIS_PORT | 8041 | Redis 映射到宿主机器的端口 |
| CC_WEB_PORT | 8035 | 春松客服 Web 服务地址映射到宿主机器的端口 |
| CC_SOCKET_PORT | 8036 | 春松客服 SocketIO 服务映射到宿主机器的端口 |
| ACTIVEMQ_PORT1 | 8051 | ActiveMQ 端口 |
| ACTIVEMQ_PORT2 | 8052 | ActiveMQ 端口 |
| ACTIVEMQ_PORT2 | 8053 | ActiveMQ 端口 |
| DB_PASSWD | 123456 | 数据库密码，设置到 MySQL, Redis, ActiveMQ |
| LOG_LEVEL | INFO | 日志级别，可使用 WARN, ERROR, INFO, DEBUG |
以上配置中，端口的各默认值需要保证在宿主机器上还没有被占用；数据库的密码尽量复杂；CC_WEB_PORT 和 CC_SOCKET_PORT 这两个值尽量不要变更；生产环境下 LOG_LEVEL 使用至少 WARN 的级别。
以下为一些业务功能相关配置的环境变量：
| KEY | 默认值 | 说明 |
|---|---|---|
| TONGJI_BAIDU_SITEKEY | placeholder | 使用百度统计 记录和查看页面访问情况，默认不记录 |
| EXTRAS_AUTH_SUPER_ADMIN_PASS | admin1234 | 系统超级管理员 admin 的初始化密码 |
| EXTRAS_LOGIN_BANNER | off | 登录页上方展示通知的内容，默认(off)不展示 |
| EXTRAS_LOGIN_CHATBOX | off | 登录页支持加入一个春松客服网页渠道聊天按钮，比如 https://oh-my.cskefu.com/im/xxx.html，默认(off)不展示 |
管理命令
启动服务
cd cskefu # 进入下载后的文件夹
docker-compose pull # 拉取镜像
docker-compose up -d contact-center # 启动服务
查看服务状态
docker-compose ps
查看服务日志
docker-compose logs -f contact-center
登陆系统
在日志中，查看到如下类似信息，代表服务已经启动。
INFO c.c.socketio.SocketIOServer – SocketIO server started at port: 8036 [nioEventLoopGroup-2-1]
INFO com.chatopera.cc.Application – Started Application in 35.319 seconds (JVM running for 42.876) [main]
然后，从浏览器打开 http://你的ip:CC_WEB_PORT/ 访问服务。 默认管理员账号： admin 密码： admin1234
关闭服务
docker-compose down
重启服务
docker-compose restart
无网络访问条件下部署
利用其他机器
首先，找一个网络条件好的电脑或服务器，安装 docker。
下载镜像
然后，在新的电脑下载镜像。
方法，执行命令：
docker pull IMAGE_NAME
IMAGE_NAME 参考 docker-compose.yml 中各服务的 image， 比如： docker pull cskefu/contact-center:develop
春松客服包含多个 image。
导出镜像
下载好 image 后，导出 image，将所有 image 使用下面命令导出为 tgz 文件
docker save cskefu/contact-center:develop > cc.docker.tgz
上传镜像
将所有导出的 image tgz 文件上传到目标部署的服务器 即网络条件不好的机器，比如用 FTP 工具或 SCP 命令。
安装镜像
上传到目标机器后，安装镜像 docker load < cc.docker.tgz
安装成功后，会提示。
启动服务
启动春松客服，参考本章以上内容。
cd cskefu # 源文件下载地址
docker-compose up -d contact-center