修改配置文件

将服务端程序上传之前，可先在本地电脑完成对配置文件的修改。

参阅：使用自动化工具配置服务器端程序

也可以选择先把服务端程序上传后，再通过 vim 手工对配置文件修改。

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

配置 Nginx

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

1. 编辑 nginx 配置文件
   vim /etc/nginx/nginx.conf

2. 在 Server 节点 平级 添加如下内容
   注意 server_name 处替换为你所使用的域名。

   如果在 vim 环境中编辑不习惯，可以将此文件下载到本地计算机编辑后再上传。

   map $http_upgrade $connection_upgrade {
   default upgrade;
   ''   close;
   }
   upstream dotnet_server_proxy {
        server localhost:5000;                                                
        keepalive 2000;
   }
   server{
        listen 80;
        listen [::]:80;
   
        server_name kf-api.yourname.com;
   
        location / {
                    proxy_pass http://dotnet_server_proxy;
                    proxy_http_version 1.1;
                    proxy_set_header Upgrade $http_upgrade;
                    proxy_set_header Connection keep-alive; 
                    proxy_set_header Host $host;
                    proxy_cache_bypass $http_upgrade;
                    proxy_set_header X-Forwarded-For $remote_addr;
                    proxy_set_header Upgrade $http_upgrade;
                    proxy_set_header Connection $connection_upgrade;
        }
   }

   示例文件：https://kf.shengxunwei.com/files/nginx.conf.txt

3. 重新加载 nginx 配置文件
   cd /usr/sbin
./nginx -s reload

配置主程序

1. 进入
   cd /lib/systemd/system/

2. 创建文件
   vim kfServer.service

3. 输入以下内容后保存退出
   注意 WorkingDirectory 为您的 Server 目录

   [Unit]
   Description=kfServer service
   After=network.target
   [Service]
   Type=simple
   GuessMainPID=true
   WorkingDirectory=/wwwroot/Server
   StandardOutput=journal
   StandardError=journal
   ExecStart=/usr/bin/dotnet Sheng.Linkup.Server.dll
   Restart=always
   [Install]
   WantedBy=multi-user.target

   注意：在 CentOS 8 中，ExecStart 后无需要输入完整路径，如
   ExecStart=dotnet Sheng.Linkup.Server.dll &

4. 启动服务器主程序
   systemctl start kfServer.service

5. 设置开机启动
   systemctl enable kfServer.service

6. 查看运行状态
   systemctl status kfServer.service
   显示绿色的 active(running) 表示启动成功。

如需重新启动服务器主程序，可使用命令 systemctl restart kfServer.service。
在修改了主程序配置文件后，需要重新启动以生效。

初始化主程序

1. 访问域名，进入 Status 查看状态
   https://kf-api.yourname.com/Status

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

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

2. 初始化数据
   访问域名，进入 Status/Setup 命令
   如：https://kf-api.yourname.com/Status/Setup

常见问题

启动时提示错误无法正常访问主程序。

在命令行进入 Server 目录，执行：dotnet Sheng.Linkup.Server.dll

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

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

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