入门
免费私有化部署
免费在线使用(快速上手指引)
详细使用说明书(功能介绍) 📔
集成到您的网站、APP或公众号

检查单(部署遇到问题请对照检查)


如果部署完成遇到故障,无法登录使用,请先对照此检查单进行检查。

请务必逐条对照检查,不要有“这个肯定没问题,不用看”的想法,以免走弯路浪费时间。


运行环境

  • 是否使用了网络代理,VPN?不稳定的网络代理工具会出现容易掉线现象,先去除代理测试。
  • 是否部署了高防或CDN?先将之去除,客服系统稳定运行确定客服系统正常后再考虑部署其它网络组件。
  • 对于集成在网站中使用的场景,主网站是 https 吗?那么客服系统所在域名(kf-api 和 kf-resource)也必须是 https。
  • 服务端各目录(Server、Resource)路径是否有足够的访问和执行权限?Windows Server 请勿把目录放在桌面;Linux 也需检查存储目录的权限设置。
  • 站点 IP 地址绑定是否正确?IIS 中配置站点时,默认不需要绑定 IP 地址。参阅:配置服务器主程序

服务器主程序

找到“Server”目录下的“appsettings.json”并用记事本打开。

  • 数据库连接 DatabaseEngineDefaultConnection 配置是否正确。
  • 使用数据库管理工具测试数据库连接串在服务器上是否能够正常连接数据库,也可使用自动化配置工具进行测试。
  • Environment 节点下的 服务器IP、端口、域名 是否配置正确。
    TcpIpAddress 必须是服务器的 IP地址,不能是 localhost 或其它别名,客服端软件通过此 IP 地址建立长连接。
  • Baidu 节点下的 AK 是否配置正确。
  • 修改配置后是否重启了 “Server” 站点,除了 “站点” 外,“应用程序池”是否已经重启。

参阅:主程序配置文件修改维护说明

资源站点

找到“Resource”目录下的“embedded.js”,并用记事本打开。

  • 配置服务器连接地址各个参数是否配置正确。
  • 所使用的连接协议,是 http 还是 https ,是 wss 还是 ws 是否配置正确。

找到“Resource/WebChat”目录下的“Config.js”,并用记事本打开。

  • 配置服务器连接地址各个参数是否配置正确。
  • 所使用的连接协议,是 http 还是 https ,是 wss 还是 ws 是否配置正确。

是否清除了缓存

  • 修改配置后是否重启了 “Resource” 站点。
  • 访客端是否强制刷新(Ctrl + F5)或清除了缓存。

参阅:资源站点配置文件修改维护说明

客服端软件

  • 是否在登录界面点击“修改”配置了正确的服务器主程序地址。
    旧版本程序若所在目录需要管理员权限才能更新,可手工检查 Sheng.Linkup.Client.Shell.exe.config 文件中的 apiAddress 配置是否正确。
  • 登录时提示版本不正确,检查数据库信息中记录的版本与实际使用的版本是否一致,参阅:升级数据库中的信息

服务器配置

  • 客服程序所使用的 TCP 端口是否已经开放,默认是 9527。
  • 所需的基础中间件是否已经安置配置,
    参阅:Windows 服务器Linux 服务器
  • 如果使用的是 nginx ,修改 nginx 配置文件后是否已经重新加载。

使用命令行检查服务器主程序

  • 使用命令行(在 Windows Server 中使用 Command Prompt)进入 Server 目录,执行:dotnet Sheng.Linkup.Server.dll,如果服务器主程序不能正确启动,将输出提示信息,可根据提示信息进一步排查。

若依然不能解决故障,可与我联系,不收费。

  • QQ:1930384802,请直接留言问题,我看到后会及时回复
  • E-mail:cao.silhouette@msn.com ,来信必复

All Rights Reserved. 曹旭升 版权所有

E-mail: cao.silhouette@msn.com

QQ: 279060597

@南京

关于我 我的产品 我的开源项目

ICP证:皖ICP备14020687号-1

公安备案:34110202000256