配置服务器主程序


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

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

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

注意:服务端程序使用 5000 端口作为反向代理,请勿占用此端口。


修改配置文件

注意:对于正在运行中的主程序,修改它的配置文件,必须重启服务端主程序才可以生效。

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

配置数据库连接

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

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

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

  • 如果数据库安装在服务器本机,可使用 localhost 来表示。
  • 不要使用 127.0.0.1 ,此环回地址经过网卡,并受到网络防火墙限制。

配置环境信息

找到 Environment 节点,配置其下节点。


建立 IIS 站点

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

如果没有,请先安装 .Net Core,参阅:安装 .Net Core

  1. 右击“网站”节点,点击“添加网站”。

  1. 在“添加网站”界面中,输入“网站名称”、“物理路径”、“主机名”。点击“确定”。
  • 如果使用域名访问,主机名中填写该域名,如:e-api.yourname.com。
  • 如果使用 IP 地址加端口号访问,主机名无需填写,修改 80 端口为你所要使用的端口即可。
  • IP 地址无需选择。
  • 如果已经导入了 SSL 证书,可以将“类型”切换为“https”,并选择对应的证书。

  1. 在 IIS 中,选择“应用程序池”,找到刚才新建的“Server”。

  1. 双击“Server”,在弹出的界面中,选择“无托管代码”,点击“确定”。

  1. 点击右侧的“正在回收”,在弹出的窗口中,取消所有勾选,点击“下一步”。

  1. 点击“完成”。

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

初始化

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

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

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

必须调用此命令初始化数据,系统才能登录。


常见问题

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

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

如果没有,请先安装 .Net Core,参阅:安装 .Net Core

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

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

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