主程序配置文件修改维护说明
注意:appsettings.json 文件修改之后,必须重启服务端主程序才可以生效。
- IIS:重启站点和应用程序池。
- Linux:执行:sudo systemctl restart kf.service
- 宝塔面板:Supervisor 管理器中重新启动 Server 进程
- Docker容器内:sudo supervisorctl restart kf
找到“Server”目录下的“appsettings.json”并用记事本打开。
配置数据库连接
找到 DatabaseEngine
节点,配置数据库引擎,可配置为:mysql
或 sqlserver
。
找到 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:5001TcpIpAddress
:填写服务器的公网 IP 地址,必须是有效的 IPv4 地址,客服端通过此 IP 地址向服务器发起连接。TcpPort
:填写给客服系统开放的通信端口,如 9527。
注意:私有化部署版在免费使用时,通信端口固定为 9527,请勿填写其它端口号。ResourceAddress
:填写静态资源站点的访问地址,如:http://kf-resource.yourname.com
。HostAddress
:填写服务器主程序站点的访问地址,如:http://kf-api.yourname.com
。
配置翻译服务
翻译服务是可选的,不开启翻译服务时,保持
Translation
节点下的Engine
为空即可。
找到 Translation
节点,配置其下的 Engine
节点:
- 留空,不开启翻译服务。
google
:使用 Google 翻译接口(仅支持付费用户)。参阅:使用 Google 翻译baidu
:使用百度翻译接口。参阅:使用百度翻译youdao
:使用有道翻译接口。参阅:使用有道翻译
配置了 Engine
后,在随后的 Google
、 Baidu
或 Youdao
节点下,配置对应的接口密钥即可。
配置文件存储
客服系统的服务端程序在接收上传的文件时,可以将文件存储在服务器本地目录,或转存至阿里云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