千云客服 SELF-HOSTED SERVICE DESK

SELF-HOSTED SERVICE DESK / PHP 单站部署

把客服窗,装在自己的服务器上。

客户打开网页就能聊,你在后台接管会话、推送提醒、查看统计,聊天记录与素材都留在本机。

打开客服入口 查看后台实景 不依赖第三方客服平台
存储方式
JSON / SQLite / MySQL
后台主题
18 套配色 / 日夜
客户接入
链接 / 悬浮 / 嵌入
会话总览 / DESK OVERVIEW
示意界面
DESK 客服工作台 24 会话 / 2 条未读
访客 · 小林在线
悬浮窗 · 广州 · 12 条消息
今日消息8
访客 · 阿哲等待
网页嵌入 · 杭州 · 5 条消息
今日消息6
访客 · Momo在线
直达链接 · 成都 · 3 条消息
今日消息4
访客 · 老周已完成
二维码 · 西安 · 2 条消息
今日消息2
会话、入口与状态仅作界面示意
文字 · 图片视频 · 语音
转人工超时自动结束
VISITOR → DESK → NOTIFY 单站部署 · 数据留在本机
01 / 核心能力

聊得起来,
也收得住。

不是把聊天框接上就结束。会话、转人工、提醒、安全与统计都在同一套后台里,装完就能用,不依赖任何第三方客服平台。

实时会话

客户发来文字、图片、视频和语音,工作台即时出现;未读计数、消息撤回、拉黑与会话清空都在同一处处理,聊完即可归档。

文字图片视频语音撤回拉黑

自动回复

欢迎语在客户进门时发出;关键词规则支持「包含」与「精确」两种匹配,命中次数记在规则上,过时的规则随时可以停用。

欢迎语关键词精确匹配命中统计

转人工与工作台

等待中、处理中、已完成三种状态一眼分清,超时未接管会自动结束并给出提示;后台与手机都能接管。

会话筛选转人工超时结束

通知触达

钉钉、飞书、Server酱与邮件四路提醒可选;客户留言邮箱后会收到回复通知,直接回邮件也能写回会话。

钉钉飞书Server酱邮件

安全与访问

后台登录目录可改名,可开启屏幕锁、F12 拦截、PC 访问拦截、域名授权与维护模式;离开电脑点一下就能锁住后台。

改目录屏幕锁F12PC 拦截域名授权

统计与素材

最近 7 天的会话与消息趋势、状态分布、省份与城市来源都能看到;图片、视频、语音、头像与提示音统一在素材目录管理。

7 日趋势地域分布状态统计素材上传
完整能力 JSON / SQLite / MySQL 安装向导 01→03 18 套配色与日夜模式 手机端适配 快捷回复 邮件回信 素材管理 运行统计
02 / 接入方式

一条链接,
或者一个悬浮窗。

客户从哪里进来由你决定:直接发链接和二维码、在现有网页嵌一个悬浮按钮,或者把聊天页当独立页面使用。所有人最后都汇到同一个工作台。

01
聊天链接与二维码LINK / 直接发给客户

发一条链接,客户就能开始聊。

客服入口是一条固定地址,可以放在官网按钮、商品详情页、公众号菜单或包装二维码里。客户打开即进入聊天页,输入称呼就能说话,不需要注册账号。

客服入口二维码免注册手机浏览器
02
网页嵌入组件EMBED / 一行 script

不离开页面,也能把客服挂上去。

在现有网页引入一个 script 即可生成悬浮客服:横排、圆形、气泡按钮多种样式,颜色、宽高、左右位置和是否新窗口打开都能调;也可以直接用独立页面或 iframe。

悬浮窗横排样式气泡按钮颜色与宽高新窗口
03
客服工作台DESK / 后台接管

所有入口,最后都汇到一块屏幕。

会话列表按等待中、处理中、已完成筛选,支持搜索昵称与 IP;客服在后台回复、发图片视频语音、调用快捷回复,超时没人接管会自动结束。

会话列表状态筛选快捷回复超时结束手机后台
接入说明

同一套程序同时提供客户聊天页与客服后台,不需要另装插件或第三方服务。官网只负责介绍与入口,聊天数据不会经过官网。

03 / 后台实景

每天要用的后台,
信息要一眼看清。

工作台、自动回复、系统设置是三块最常打开的页面。配色、全屏与日夜模式做成同一套工具栏,切换状态会留在浏览器里。

工作台视图:左侧会话列表,右侧当前会话。等待、处理中、已完成一眼分清,未读和新消息提示音都不会漏。

主题配色 / 18 套

Preview notes左侧切换视图与配色,右侧同步更新;状态与数据均作界面示意。

DESK / WORKSPACE
--千配色全屏夜间

客服工作台

会话、转人工与实时消息

在线
今日会话18+5 较昨日
未读消息21 个等待中
平均响应42 秒今日
全部会话 · 24筛选 / 搜索
访客 · 小林悬浮窗 · 广州 · 12 条消息
处理中
访客 · 阿哲网页嵌入 · 杭州 · 5 条消息
等待中
访客 · Momo直达链接 · 成都 · 3 条消息
已完成
访客 · 老周二维码 · 西安 · 2 条消息
已完成
访客 · 未命名IP 未定位 · 1 条消息
已完成
访客会话 · 小林今日 10:24 · 来源:官网悬浮窗
客户

你们的客服能放在我自己的网站上吗?

10:24
客服

可以,给你一段 script 贴到页面里就行,颜色和位置都能调。

10:25
客户

手机上也能收到消息吧?

10:26
输入回复…发送 / Enter
运行状态正常 · 已运行 12 天JSON 存储 · 版本 2026.11
存储方式JSON(data/)本机
通知渠道钉钉 · 飞书 · 邮件已启用
最近备份今日 03:00成功
界面结构与实际后台一致数据为示意,不代表真实站点
04 / 数据与安全

数据在自己手里,
备份就是拷目录。

默认 JSON 存储,会话、设置和消息都写在 data 目录;换成 SQLite 或 MySQL 也只换存储层,界面和功能不变。

说明官网只介绍产品使用能力,具体以实际后台为准。

本机存储

两个目录,
装下全部内容。

客服系统的数据只落在 data 与 uploads 两个目录:会话、设置、消息,以及图片、视频、语音、头像与提示音。迁移或备份,把这两个目录拷走即可。

  • 01data 目录默认禁止直接访问,聊天内容不会暴露在浏览器里。
  • 02可选 SQLite 单文件或 MySQL,安装时选择,后续切换不动界面。
  • 03后台可改登录目录、开屏幕锁、拦截 F12 与 PC 访问,必要时开启维护模式。

“数据留在本机”不是一句口号,而是目录结构本身。

数据目录 / data 与 uploads目录示意
data/
会话与设置JSON
sessions.json会话索引
settings.json后台设置
messages/*.json
uploads/
素材与声音按类型分开
images · videos聊天文件
audios · sounds语音提示
avatars · favicons
备份 / 迁移:整目录拷贝可回退
05 / 部署方案

装得上,
也守得住。

一键安装向导和运行环境检查随程序提供;界面、数据与素材分开存放,换版本不影响已经聊过的记录。

三种存储 / 同一套后台

先用 JSON 跑,
再按需要升级。

安装向导里选择 JSON、SQLite 或 MySQL。小站零依赖起步;数据量上来后换数据库,后台与聊天页都不用改。

JSONSQLiteMySQL
存储切换不影响界面与功能

安装 / 01 → 03

按向导走完,
就能开始接待。

  • 01上传程序,访问 setup.php 检查运行环境。
  • 02选择存储方式,设置管理员账号与密码。
  • 03删除 setup.php,进后台设置客服资料即可。
安装后请立即删除 setup.php

运行 / 访问防护

该关的目录,
提前关掉。

data 目录禁止直接访问,uploads 只放白名单类型;建议全站 HTTPS,并按说明配置伪静态与访问规则。

素材目录只接受白名单格式

数据 / 备份与回退

先能备份,
再谈升级。

备份 data 与 uploads 两个目录即可完整回退;升级或迁移环境前留一份快照,出问题按原目录恢复。

备份文件请另行妥善保管

更新 / 程序与数据分离

换版本,不动聊天记录。

升级只覆盖程序文件,data 与 uploads 保持原样。

覆盖文件 → 保留 data/uploads → 强刷缓存
06 / 常见问题

装之前,
先把这些说清楚。

存储、接入、提醒、安全与升级,是部署前最常问的几件事。下面按实际系统行为回答。

01需要先准备数据库吗?
默认不需要。安装时可以选择 JSON 直接运行,也可以选 SQLite 单文件或 MySQL。小站先用 JSON 就能跑,数据量和访问上来后再换数据库,界面和功能不变。
02客户通过什么方式进入聊天?
三种都可以:发一条客服入口链接(也可生成二维码)、在现有网页嵌入悬浮或横排组件、或者直接把聊天页当独立页面使用。客户不用注册,输入称呼即可开始。
03手机端能用吗?
可以。客户聊天页和客服工作台都做了窄屏适配,后台在手机上同样能收消息、回消息、切换会话;工作台支持屏幕锁,离开电脑前点一下即可隐藏内容。
04有新消息时怎么提醒?
后台可配置钉钉机器人、飞书机器人、Server酱和邮件提醒;客户在聊天页留下邮箱后,可在收到人工回复时收到邮件,直接回复邮件也会写回对应会话。
05自动回复和快捷回复怎么用?
自动回复支持欢迎语与关键词规则,关键词可选「包含」或「精确」匹配,规则上会记录命中次数;客服在工作台还可以调用快捷回复话术,常用的图片和说明也能一起发。
06数据安全怎么保证?
聊天数据只写入本站 data 目录并禁止直接访问;后台登录目录可以改名,可开启屏幕锁、F12 拦截、PC 访问拦截和域名授权,维护模式也能随时开启。备份只需拷贝 data 与 uploads 两个目录。
07怎么升级到新版本?
覆盖程序文件即可,保留 data 与 uploads 目录不动,升级后强刷一次浏览器缓存。升级前建议先做一份完整备份,出问题可以按原目录回退。
08官网还要单独装一套吗?
不用。官网和客服系统各自独立运行、互不影响:官网负责介绍与引导,客服系统负责接待。两者都可以放在同一台服务器上。

QIANYUN / 一套装在自己服务器上的客服系统

把客服窗,
装进自己的服务器。

上传程序、装好、发一条链接,客户就能开始聊。会话、素材与设置都留在本机。