主程序配置文件修改维护说明
正常情况下,使用自动化配置工具写入配置文件即可,参阅:使用自动化工具配置服务器端程序
也可以直接在服务器上手工编辑配置文件,本文对如何手工维护进行说明。
注意:对于正在运行中的主程序,修改它的配置文件,必须重启服务端主程序才可以生效。
- IIS:
重启站点和应用程序池。 - Linux:
执行:systemctl restart kfServer.service - 宝塔面板:
Supervisor 管理器中重新启动 Server 进程。
找到“Server”目录下的“appsettings.json”并用记事本打开。
配置数据库连接
找到 DatabaseEngine
节点,配置数据库引擎,可配置为:mysql
或 sqlserver
。
找到 DefaultConnection
节点,配置数据库连接。
SQL Server 最简单常用的连接字符串配置格式:
Server=服务器地址;database=数据库名称;Integrated Security=false;user id=账户;password=密码
SQL Server 的 user id 一般为sa
MySQL 最简单常用的连接字符串配置格式:
Server=服务器地址;database=数据库名称;user=账户;password=密码;Port=3306
MySQL 的 user 一般和数据库名称相同,在创建数据库时会同步创建一个同名账户
- 注意区分数据库名称、账户的字母大小写。
- 如果数据库安装在服务器本机,可使用 localhost 来表示。
- 不要使用 127.0.0.1 ,此环回地址经过网卡,并受到网络防火墙限制。
配置服务器 IP 和域名
找到 Environment
节点,配置其下的几个子节点中的信息。
TcpIpAddress
:填写服务器的公网 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