配置服务器主程序

修改配置文件

可使用自动化配置工具完成对服务端程序的配置。
参阅：使用自动化工具配置服务器端程序
参阅：主程序配置文件修改维护说明

上传文件

将压缩包中的“Server”目录拷贝到服务器上。

在本示例中，我们把“Server”目录放在“C:\wwwroot\”下。

路径中的文件夹名称尽量只使用英文构成，不要包含特殊字符和空格。

建立 IIS 站点

1. 启动 IIS，选择服务器节点后，点击“模块”，确认已经包含了“AspNetCoreModuleV2”。

如果没有，请先安装 .NET 8，参阅：安装 .NET

2. 右击“网站”节点，点击“添加网站”。

3. 在“添加网站”界面中，输入“网站名称”、“物理路径”、“主机名”。点击“确定”。

• 主机名为 kf-api 开头的域名，如 kf-api.yourname.com。
• IP 地址无需选择。
• 如果已经导入了 SSL 证书，可以将“类型”切换为“https”，并选择对应的证书。

4. 在 IIS 中，选择“应用程序池”，找到刚才新建的“Server”，右击选择“基本设置”。

5. 在弹出的界面中，选择“无托管代码”，点击“确定”。

6. 再次右击应用程序池中的“Server”，选择“正在回收”

7. 在弹出的窗口中，取消所有勾选，点击“下一步”。

8. 点击“完成”。

9. 再次右击应用程序池中的“Server”，选择“高级设置”

10. 点击右侧的“高级设置”，在弹出的窗口中，找到“闲置超时(分钟)”，修改数值为“0”。

初始化

请确认已经完成了对服务器主程序配置文件的配置。
参阅：使用自动化工具配置服务器端程序

1. 在浏览器中访问你的主程序域名，进入“Status”命令，如“kf-api.shengxunwei.com/Status”，看到类似如图信息，表示安装部署成功。

注意：直接访问域名显示 404 是正常的，主程序没有默认页面，请留意上面的示例网址，进入 Status 命令

2. 进入“Status/Setup”命令，初始化数据。

必须调用此命令初始化数据，客服端才能登录。

常见问题

如果在访问时提示应用程序启动失败：

选择服务器节点后，点击“模块”，确认已经包含了“AspNetCoreModuleV2”。

如果没有，请先安装 .NET 8，参阅：安装 .NET

注意，安装 .NET 之后可重新启动 IIS 服务再次尝试。

在开始菜单中选择运行，输入 cmd ，点击确定启动命令行，或使用 Windows PowerShell，进入 Server 目录，执行：dotnet Sheng.Linkup.Server.dll

通过输出，可以初步判断启动失败原因，如图所示为数据库连接串没有配置，请检查配置文件。

注意：主程序配置文件 appSettings.json 修改后，必须重新启动站点和应用程序池才会生效。

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