cskefu/contact-center

春松客服 Docker 镜像文档

镜像概述

春松客服（CSKefu）是一款基于 Java/JavaScript 技术栈开发的开源客服系统，旨在为企业提供功能全面、部署灵活的客服解决方案。该 Docker 镜像封装了春松客服的核心服务组件，支持快速部署与集成，帮助企业无需复杂配置即可搭建自有客服平台，实现客户咨询统一管理与高效响应。

核心功能与特性

• 多渠道接入：支持网站在线咨询、APP 内嵌、微信公众号/小程序、企业微信等多渠道客户咨询统一接入
• 客户管理：提供客户资料建档、历史对话记录、标签分类等功能，支持客户画像构建
• 工单系统：支持咨询转工单、工单分配/流转/归档，实现客户问题闭环管理
• 实时通讯：基于 WebSocket 实现客服与客户实时消息交互，支持文字、图片、文件传输
• 报表分析：提供客服工作量、响应时长、客户满意度等数据报表，辅助服务质量优化
• 知识库：内置知识库功能，支持常见问题自动回复与客服辅助查询，提升响应效率
• 开源可扩展：源代码完全开放，支持二次开发与功能定制，满足企业个性化需求

使用场景与适用范围

春松客服 Docker 镜像适用于需要搭建自有客服体系的各类组织：

• 中小企业：无需投入大量资源，快速部署轻量级客服平台
• 电商企业：处理订单咨询、售后问题，提升购物体验
• 在线教育：解答学员课程疑问，支持师生实时沟通
• SaaS 服务商：为自身产品集成客服功能，提升用户支持能力
• ***/公共服务：提供政务咨询、投诉建议处理渠道

使用方法与部署指南

环境要求

• Docker 1.13+ 或 Docker Compose 1.20+
• 2GB 以上内存，20GB 可用磁盘空间
• 外部 MySQL 数据库（5.7+）

Docker 快速启动

1. 准备数据库
   需提前创建 MySQL 数据库（示例库名：cskefu），并授权访问权限。

2. 启动容器

   bash
   docker run -d \
     --name cskefu \
     -p 8080:8080 \
     -e DB_HOST=your_mysql_host \
     -e DB_PORT=3306 \
     -e DB_NAME=cskefu \
     -e DB_USER=root \
     -e DB_PASSWORD=your_mysql_password \
     -e SERVER_PORT=8080 \
     cskefu/cskefu:latest
   

3. 访问系统
   容器启动后，通过 http://localhost:8080 访问春松客服管理后台，默认管理员账号：admin，密码：123456。

Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  cskefu:
    image: cskefu/cskefu:latest
    container_name: cskefu
    restart: always
    ports:
      - "8080:8080"
    environment:
      - DB_HOST=mysql
      - DB_PORT=3306
      - DB_NAME=cskefu
      - DB_USER=cskefu_user
      - DB_PASSWORD=cskefu_pass
      - SERVER_PORT=8080
      - LOG_LEVEL=INFO
    depends_on:
      - mysql
    volumes:
      - ./cskefu_data:/opt/cskefu/data  # 数据持久化
      - ./cskefu_logs:/opt/cskefu/logs  # 日志持久化

  mysql:
    image: mysql:5.7
    container_name: cskefu_mysql
    restart: always
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_DATABASE=cskefu
      - MYSQL_USER=cskefu_user
      - MYSQL_PASSWORD=cskefu_pass
    volumes:
      - ./mysql_data:/var/lib/mysql  # 数据库数据持久化

启动服务：

bash
docker-compose up -d

配置参数说明

注意事项

1. 数据持久化：生产环境需通过 volumes 挂载数据目录，避免容器重启后数据丢失
2. 数据库备份：定期备份 MySQL 数据，建议通过定时任务执行 mysqldump
3. 安全配置：首次登录后请立即修改管理员密码，并限制后台访问 IP
4. 性能优化：高并发场景下建议独立部署 Redis 缓存，并调整 JVM 内存参数（通过 -e JAVA_OPTS="-Xms512m -Xmx1024m" 配置）

参考链接

• 官方网站：[***]
• 源代码仓库：[***]
• 详细文档：[***]