JSUDO 本地私有化在线客服系统

三种主流客服部署模式完整对比：传统SaaS云端客服 / 云端私有化部署客服 / JSUDO本地电脑部署客服

项目简介 FAQ 安装帮助 服务协议

安装流程

第一步：安装软件
第二步：查看配置
第三步：用户端部署
第四步：客服工作台
常见问题

第一步：安装软件

1 下载安装包

从官方渠道下载 JSUDO-KF 安装包，文件名格式为 JSUDOKF-x.x.x-Setup.exe。

2 运行安装程序

双击安装包，系统会弹出用户账户控制（UAC）提示，请点击"是"以管理员身份运行。

3 选择安装路径

建议安装到非系统盘（如 D 盘），避免系统盘空间不足影响运行。默认路径为：

C:\Users\您的用户名\AppData\Roaming\SUDO-KF

点击"下一步"继续。

4 等待安装完成

安装程序会自动复制文件并配置系统服务，此过程大约需要 1-2 分钟。

安装完成后，点击"完成"按钮，系统会自动启动服务。

温馨提示：如果之前安装过旧版本，安装程序会自动检测并提示升级，建议保留聊天记录数据库。

第二步：查看配置信息

1 访问配置页面

安装完成后，打开浏览器访问：

http://localhost:8090/embed_static/admin/config.html

使用默认账号密码登录：

用户名：admin
密码：admin123
2 获取客服网址

登录后，配置页面会显示以下关键信息：

  • 外网公网IP：用于外部用户访问客服系统
  • 本地内网地址：用于局域网内用户访问
  • H5聊天页面链接：独立的H5聊天页面地址

注意：首次安装可能需要等待几秒钟获取公网IP，请刷新页面查看。

3 生成悬浮窗口JS代码

点击"一键生成JS代码"按钮，系统会自动生成用于嵌入网站的悬浮客服代码。

复制生成的JS代码，粘贴到您的网站页面底部即可。

提示：如果您的网站使用了内容安全策略（CSP），请确保允许加载客服系统的脚本。

4 配置端口映射（可选）

系统默认启用 UPnP 自动端口映射，如果您的路由器支持 UPnP，无需手动配置。

如果外网无法访问，请登录路由器管理后台，手动添加端口转发规则：

  • 外部端口：8090
  • 内部端口：8090
  • 协议：TCP
  • 目标IP：运行客服系统的电脑内网IP

第三步：用户端部署与应用

1 嵌入网站/商城

将第二步获取的悬浮窗口JS代码嵌入到您的网站或商城页面中：

<script src="http://您的公网IP:8090/embed_static/widget/widget-loader.js"></script>

建议将代码放置在页面的 </body> 标签之前。

支持的平台：WordPress、Discuz、Shopify、淘宝店铺、任意自定义网站等。

2 使用独立H5聊天页面

如果您不需要嵌入网站，可以直接使用独立的H5聊天页面：

http://您的公网IP:8090/embed_static/h5/chat-h5.html

将此链接发送给用户，用户点击即可直接打开聊天窗口。

3 微信小程序/公众号接入（可选）

如果您有微信小程序或公众号，可以通过 WebView 组件嵌入H5聊天页面：

  • 小程序：使用 <web-view> 组件加载H5聊天页面
  • 公众号：在自定义菜单中添加H5聊天页面链接
4 测试用户端效果

在浏览器中打开嵌入了客服代码的页面或H5聊天页面，确认：

  • 悬浮客服图标正常显示
  • 点击图标可以打开聊天窗口
  • 可以正常发送消息
  • 离线留言功能正常

第四步：客服工作台使用

1 登录客服工作台

打开浏览器访问客服工作台地址：

http://localhost:8090/embed_static/admin/index.html

使用管理员账号登录（默认：admin / admin123）。

2 熟悉工作台界面

客服工作台包含以下主要区域：

  • 左侧菜单栏：工作台、留言列表、配置、管理员头像菜单
  • 中间聊天区域：当前对话窗口和消息列表
  • 右侧访客列表：当前在线访客和历史会话
3 接待访客

当有访客发起聊天时：

  • 右侧访客列表会显示新消息提醒
  • 点击访客名称打开聊天窗口
  • 在输入框中输入回复并发送
4 处理留言

访客离线时的留言会保存在系统中：

  • 点击左侧"留言列表"菜单
  • 查看所有留言记录
  • 支持按姓名、号码搜索，按时间筛选
  • 支持导出CSV文件
5 管理授权信息

点击左下角管理员头像，选择"查看授权信息"：

  • 查看当前授权状态
  • 查看授权码、有效期、VIP等级
  • 如需升级授权，请联系客服
6 修改密码

点击左下角管理员头像，选择"修改密码"：

  • 输入旧密码
  • 输入新密码并确认
  • 点击保存完成修改

安全提示：建议首次登录后立即修改默认密码。

常见问题排查

1 无法访问配置页面

如果无法访问 http://localhost:8090，请检查：

  • JSUDO-KF 服务是否已启动（可在任务管理器中查看）
  • 端口 8090 是否被其他程序占用
  • 防火墙是否阻止了 8090 端口
2 外网无法访问

如果内网可以访问但外网无法访问，请检查：

  • 路由器是否开启了 UPnP 功能
  • 是否手动配置了端口转发规则
  • 运营商是否屏蔽了 8090 端口（可尝试更换其他端口）
  • 电脑是否使用了公网IP（部分网络环境可能使用了NAT）
3 聊天记录丢失

聊天记录保存在安装目录下的 chat.db 文件中：

  • 升级安装时不要删除此文件
  • 定期备份此文件以防数据丢失
  • 如误删文件，聊天记录将无法恢复
4 客服端收不到消息

请检查：

  • 客服工作台是否已登录
  • 浏览器是否允许了通知权限
  • 是否开启了浏览器的勿扰模式
5 服务无法启动

如果服务启动失败：

  • 检查安装目录权限是否正确
  • 检查是否有杀毒软件拦截
  • 查看安装目录下的日志文件获取详细错误信息
  • 尝试以管理员身份重新运行安装程序