入门
特色功能
免费私有化部署 👈
配置文件修改说明
部署新服务器 👈
Windows 服务器
Linux 服务器
宝塔面板(aaPanel)
Docker
发布客服端程序
1.x 部署文档
Windows 服务器
Linux 服务器
宝塔面板(aaPanel)
发布客服端程序
升级现有服务器
服务器维护
开通自动翻译服务
配置文件存储
公告
免费在线使用(快速上手指引)
详细使用说明书(功能介绍) 📔
准备使用客服端软件
站点管理
客服账号管理
基础会话功能
辅助会话功能
个性化站点配置
访客管理
访客留言
集成及二次开发

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


注意:appsettings.json 文件修改之后,必须重启服务端主程序才可以生效。

  • IIS:重启站点和应用程序池。
  • Linux:执行:sudo systemctl restart kf.service
  • 宝塔面板:Supervisor 管理器中重新启动 Server 进程
  • Docker容器内:sudo supervisorctl restart kf

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

配置数据库连接

找到 DatabaseEngine 节点,配置数据库引擎,可配置为:mysqlsqlserver

找到 DefaultConnection 节点,配置数据库连接。

  • SQL Server 最简单常用的连接字符串配置格式:
    Server=服务器地址;database=数据库名称;Integrated Security=false;TrustServerCertificate=true;user id=账户;password=密码
    SQL Server 的 user id 一般为 sa

  • MySQL 最简单常用的连接字符串配置格式:
    Server=服务器地址;database=数据库名称;user=账户;password=密码;Port=3306

注意区分数据库名称、账户的字母大小写。
如果数据库安装在服务器本机,服务器地址一般使用 localhost 来表示,而不要使用 127.0.0.1 ,因为此环回地址可能经过网卡,受到网络防火墙限制。

配置服务器环境信息

找到 Environment 节点,配置其下的几个子节点中的信息。

  • UseUrls:服务端主程序所监听的本地服务地址,可留空,默认为 http://localhost:5000 ,如果服务器的 5000 端口不能被使用,可在此指定其它端口号。
    注意:这里要填写一个有效的监听服务地址,而不是只填写端口号,如:http://localhost:5001
  • TcpIpAddress:填写服务器的公网 IP 地址,必须是有效的 IPv4 地址,客服端通过此 IP 地址向服务器发起连接。
  • TcpPort:填写给客服系统开放的通信端口,如 9527。
    注意:私有化部署版在免费使用时,通信端口固定为 9527,请勿填写其它端口号。
  • ResourceAddress:填写静态资源站点的访问地址,如:http://kf-resource.yourname.com
  • HostAddress:填写服务器主程序站点的访问地址,如:http://kf-api.yourname.com

配置翻译服务

翻译服务是可选的,不开启翻译服务时,保持 Translation 节点下的 Engine 为空即可。

找到 Translation 节点,配置其下的 Engine 节点:

配置了 Engine 后,在随后的 GoogleBaiduYoudao 节点下,配置对应的接口密钥即可。

配置文件存储

客服系统的服务端程序在接收上传的文件时,可以将文件存储在服务器本地目录,或转存至阿里云OSS。参阅:文件存储简介

找到 FileStore 节点,配置其下的 Store 节点:

  • static:存储在服务器本地目录。
  • alioss:转存至阿里云OSS。

如果配置为 alioss,则在 AliOSS 节点下,进一步配置阿里云OSS有关信息,参阅:将上传的文件转存至阿里云OSS

  • AccessKeyId:阿里云 RAM 访问控制中创建的用户所拥有的 AccessKeyId。
  • AccessKeySecret:阿里云 RAM 访问控制中创建的用户所拥有的 AccessKeySecret。
  • BucketName:存储空间名称。
  • EndPoint:地域节点访问域名,进入指定 bucket 的“概览”页面,可以查看 Endpoint(地域节点)
  • PublicAddress:文件访问地址,可以使用 Bucket 自有外网访问域名,也可以使用绑定域名访问。此处必须填写带有 http 或 https 开头的完整 URL,如:https://bucketName.oss-cn-hangzhou.aliyuncs.com

目录

入门
特色功能
免费私有化部署 👈
配置文件修改说明
部署新服务器 👈
Windows 服务器
Linux 服务器
宝塔面板(aaPanel)
Docker
发布客服端程序
1.x 部署文档
Windows 服务器
Linux 服务器
宝塔面板(aaPanel)
发布客服端程序
升级现有服务器
服务器维护
开通自动翻译服务
配置文件存储
公告
免费在线使用(快速上手指引)
详细使用说明书(功能介绍) 📔
准备使用客服端软件
站点管理
客服账号管理
基础会话功能
辅助会话功能
个性化站点配置
访客管理
访客留言
集成及二次开发
二次开发