在香港服务器部署ASP.NET Core 8应用,如何配置进程托管与异常重启?

发布人:A5数据发布时间:2026-10-15 14:11阅读量:117

要让香港服务器上的 ASP.NET Core 8 应用在 SSH 断开后继续运行、服务器重启后自动启动,并在进程异常退出后恢复,可以使用 systemd 托管应用进程,Nginx 提供对外入口。Kestrel 只监听本机地址,systemd 负责启动、停止、异常重启和日志收集;这比在终端中执行 dotnet xxx.dll 或使用后台运行命令更适合正式部署。

下面以 Ubuntu 24.04 LTS、ASP.NET Core 8、框架依赖发布为实施环境,完成一次从发布文件到托管验证的部署。香港机房位置不会改变 systemd 的工作方式,但公网访问延迟、DNS、入站规则与本机进程状态需要分别验证。示例应用名为 HkWeb,域名为 app.example.com,请替换成实际值;文中的预期结果不是实际执行记录。

一、准备环境,先明确托管边界

1. 本次部署需要哪些条件

开始操作前,准备好以下内容:

  • 一台具有 sudo 权限的 Ubuntu 24.04 香港服务器。
  • 一个能够使用 .NET 8 SDK 编译的 ASP.NET Core 项目。
  • 应用所需的数据库、外部接口和生产配置。
  • 指向服务器公网地址的业务域名;正式开放 HTTPS 时,还需有效证书及私钥。
  • 服务器管理入口和备份。涉及覆盖配置、切换发布目录时,应保留上一版本。

服务器防火墙和云平台入站规则只开放必要端口:管理端口按来源限制,业务入口使用 80、443。不要向公网开放示例中的 5000 端口,它只供 Nginx 访问本机 Kestrel。

一、准备环境,先明确托管边界配图

如果服务器已经运行其他网站,不要删除 Nginx 默认站点或批量替换现有配置。本次使用独立的 hkweb.conf,便于检查和回滚。

A5数据提供香港物理服务器租用,为采用 systemd 管理进程、Nginx 承接访问的 ASP.NET Core 8 应用提供部署资源基础。产品覆盖入门建站、Xeon Gold 与 AMD EPYC 平台,搭配不同容量的内存及 SSD、NVMe 存储,可承载企业网站、业务后台与接口服务,并为应用日志、持久数据和多版本发布文件提供存储空间;香港产品另有 CN2 与国际带宽方案,覆盖不同访问人群的网络资源需求。

2. 核验系统与运行时来源

在服务器上执行:

cat /etc/os-release
uname -m
sudo apt update
apt-cache policy aspnetcore-runtime-8.0

本文后续命令适用于 Ubuntu 24.04。uname -m 如果返回 x86_64,对应发布目标 linux-x64;如果返回 aarch64,应改用 linux-arm64。

确认软件源存在安装候选版本后再安装:

sudo apt install -y aspnetcore-runtime-8.0 nginx curl
command -v dotnet
dotnet --list-runtimes

预期运行时列表中包含:

Microsoft.AspNetCore.App 8.0.x [...]
Microsoft.NETCore.App 8.0.x [...]

这里安装的是 ASP.NET Core 运行时,不是仅安装基础 .NET 运行时。服务器只执行编译后的程序时,不必安装 SDK。

如果软件包没有候选版本,先检查 Ubuntu 软件源及相应仓库是否启用,不要把其他发行版的软件源直接套到这台服务器上。后续 unit 使用 /usr/bin/dotnet;若 command -v dotnet 返回不同路径,应按实际结果调整。

3. 保存可能被修改的配置

如果服务器已有同名服务或站点,先备份。下面的命令把文件放在独立的 root 目录,避免备份文件被 Nginx 当成站点配置加载:

BACKUP="/root/hkweb-backup-$(date +%Y%m%d-%H%M%S)"
sudo install -d -m 0700 "$BACKUP"

for file in \
  /etc/systemd/system/hkweb.service \
  /etc/hkweb/hkweb.env \
  /etc/nginx/sites-available/hkweb.conf
do
  if sudo test -f "$file"; then
    sudo cp -a "$file" "$BACKUP/$(basename "$file")"
  fi
done

if sudo test -L /opt/hkweb/current; then
  sudo readlink -f /opt/hkweb/current \
    | sudo tee "$BACKUP/previous-release.txt" >/dev/null
fi

echo "$BACKUP"

记录输出的备份路径。后续示例主要针对首次部署;已有业务时,覆盖配置和服务重启应安排在维护窗口内。

二、发布应用,建立只读代码与可写数据目录

1. 添加用于验证的存活检查

应用至少需要一个不依赖数据库的存活检查,用来判断 HTTP 服务是否能响应。例如,在现有 Program.cs 中按相应位置合并以下代码,不要直接覆盖业务启动逻辑:

using System.Net;
using Microsoft.AspNetCore.HttpOverrides;
using Microsoft.Extensions.Diagnostics.HealthChecks;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddHealthChecks();

builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
    options.ForwardedHeaders =
        ForwardedHeaders.XForwardedFor |
        ForwardedHeaders.XForwardedProto;

    options.KnownProxies.Add(IPAddress.Loopback);
    options.KnownProxies.Add(IPAddress.IPv6Loopback);
});

builder.Services.Configure<HostOptions>(options =>
{
    options.ShutdownTimeout = TimeSpan.FromSeconds(20);
});

var app = builder.Build();

app.UseForwardedHeaders();

app.MapHealthChecks("/health/live",
    new Microsoft.AspNetCore.Diagnostics.HealthChecks.HealthCheckOptions
    {
        Predicate = _ => false
    });

app.MapGet("/", () => "HkWeb is running");

app.Run();

这段代码是最小验证示例。真实项目中的认证、路由、中间件等仍需保留;UseForwardedHeaders() 应放在需要识别客户端地址和 HTTPS 协议的中间件之前。

/health/live 不检查数据库,因此返回健康只说明应用能够处理请求。需要判断业务是否可用时,应另外设置包含依赖检查的就绪接口,不能把两者混为一谈。

2. 在构建环境生成发布文件

在项目所在的开发机或构建机执行:

dotnet --info

dotnet publish ./HkWeb.csproj \
  -c Release \
  -f net8.0 \
  -r linux-x64 \
  --self-contained false \
  -o ./publish

确认 publish 中存在:

  • HkWeb.dll
  • HkWeb.deps.json
  • HkWeb.runtimeconfig.json
  • 应用依赖和静态文件

程序集名称以项目实际输出为准,不一定与文件夹名称相同。采用框架依赖发布后,服务器需要保有兼容的 .NET 8 运行时。

将发布目录上传到服务器。以下命令在构建机执行,目标临时目录应尚不存在,避免混入旧文件:

scp -r ./publish deploy@SERVER_IP:/tmp/hkweb-release-001

3. 创建服务账号和目录

回到服务器,创建不允许交互登录的专用账号:

getent passwd hkweb

若账号不存在,再执行:

sudo useradd --system \
  --home-dir /var/lib/hkweb \
  --shell /usr/sbin/nologin \
  hkweb

建立目录并复制发布文件:

sudo install -d -o root -g hkweb -m 0750 \
  /opt/hkweb \
  /opt/hkweb/releases \
  /opt/hkweb/releases/release-001

sudo install -d -o hkweb -g hkweb -m 0750 \
  /var/lib/hkweb

sudo cp -a /tmp/hkweb-release-001/. \
  /opt/hkweb/releases/release-001/

sudo chown -R root:hkweb /opt/hkweb/releases/release-001
sudo chmod -R u=rwX,g=rX,o= /opt/hkweb/releases/release-001

sudo ln -s releases/release-001 /opt/hkweb/current

这里的递归权限修改只针对新发布目录。代码由 root 持有,服务账号只能读取;上传文件、缓存等运行数据放在 /var/lib/hkweb,不要让应用账号拥有整个发布目录的写权限。

二、发布应用,建立只读代码与可写数据目录配图

ln -s 在 current 已存在时会失败,这是保护行为。已有部署应使用后文的版本切换方法,不要为了继续执行而删除原发布目录。

验证文件可读性:

sudo -u hkweb test -r /opt/hkweb/current/HkWeb.dll \
  && echo "程序集可读取"

readlink -f /opt/hkweb/current

预期链接指向 release-001,程序集读取检查成功。

三、配置 systemd,让进程进入受控生命周期

1. 创建生产环境配置

创建 root 可读的环境文件目录:

sudo install -d -o root -g root -m 0700 /etc/hkweb
sudo touch /etc/hkweb/hkweb.env
sudo chmod 0600 /etc/hkweb/hkweb.env
sudoedit /etc/hkweb/hkweb.env

写入:

ASPNETCORE_ENVIRONMENT=Production
ASPNETCORE_URLS=http://127.0.0.1:5000
Logging__LogLevel__Default=Information
Logging__LogLevel__Microsoft.AspNetCore=Warning

systemd 的环境文件不是 shell 脚本,不要添加 export。连接字符串等生产参数可按应用的配置结构补充,但不要把敏感值粘贴到工单、日志或公开终端记录中。

环境变量会进入进程环境,并不等于专用的密钥管理方案。已有密钥管理设施时,应继续使用原方案。

2. 创建服务文件

编辑服务配置:

sudoedit /etc/systemd/system/hkweb.service

写入:

[Unit]
Description=HkWeb ASP.NET Core 8 Application
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=60
StartLimitBurst=5

[Service]
Type=simple
User=hkweb
Group=hkweb
WorkingDirectory=/opt/hkweb/current
ExecStart=/usr/bin/dotnet /opt/hkweb/current/HkWeb.dll
EnvironmentFile=/etc/hkweb/hkweb.env

Restart=always
RestartSec=5
KillSignal=SIGTERM
KillMode=control-group
TimeoutStopSec=30

StandardOutput=journal
StandardError=journal
SyslogIdentifier=hkweb

UMask=0027
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/var/lib/hkweb

[Install]
WantedBy=multi-user.target

配置中的几项边界需要明确:

配置本例作用需要注意的边界
Type=simple执行 dotnet 并跟踪主进程active 不代表 HTTP 已就绪
Restart=always进程自行退出后重新启动,包括退出码为 0执行 systemctl stop 不会触发自动重启
RestartSec=5退出后等待约 5 秒再尝试启动不是故障恢复时间承诺
StartLimitBurst=5限制 60 秒窗口内的启动次数持续失败后会停止重试
TimeoutStopSec=30为停止过程保留时间超时后进程可能被强制结束
ProtectSystem=strict限制应用修改文件系统正常持久写入应放到允许目录

应用示例的优雅关闭预算为 20 秒,systemd 停止等待为 30 秒,留出一定余量。如果业务包含长任务,应结合任务取消、事务处理和幂等设计调整,不能仅靠延长超时解决。

本例使用 Restart=always,是为了覆盖应用意外正常返回的情况。如果业务明确要求正常退出后保持停止,可以改为 Restart=on-failure。两种策略都无法识别“进程还在,但请求一直卡住”。

3. 启动并逐项验证

先检查 unit,再启动:

sudo systemd-analyze verify /etc/systemd/system/hkweb.service
sudo systemctl daemon-reload
sudo systemctl enable --now hkweb.service

检查进程、监听和接口:

systemctl status hkweb.service --no-pager
systemctl show hkweb.service \
  -p MainPID -p ActiveState -p SubState -p NRestarts

sudo ss -ltnp 'sport = :5000'
curl --fail --max-time 5 http://127.0.0.1:5000/health/live

成功时应看到:

  • 服务处于 active (running),MainPID 非零。
  • 5000 端口监听在 127.0.0.1,而不是公网地址。
  • 存活检查返回 HTTP 200,正文通常为 Healthy。

如果监听地址不符合预期,检查代码中的 Listen、配置文件中的 Kestrel 端点或启动参数是否覆盖了 ASPNETCORE_URLS。不要只看环境文件就认定公网端口已经关闭。

查看应用日志:

sudo journalctl -u hkweb.service -b -n 100 --no-pager
sudo journalctl -u hkweb.service -f

-b 表示当前启动周期。需要跨服务器重启保留日志时,应检查 journald 是否使用持久存储及其磁盘限额;默认行为不能未经验证就当作长期日志留存方案。

四、配置 Nginx 入口,分别验证 HTTP 与 HTTPS

1. 先建立受限的 HTTP 验证入口

首次验证阶段可暂时使用 HTTP,但不要通过明文入口传输登录凭据或业务敏感数据;必要时只对测试来源开放。

编辑独立站点配置:

sudoedit /etc/nginx/sites-available/hkweb.conf

写入:

server {
    listen 80;
    listen [::]:80;
    server_name app.example.com;

    access_log /var/log/nginx/hkweb.access.log;
    error_log /var/log/nginx/hkweb.error.log;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
    }
}

该配置按“Nginx 直接接收客户端连接”编写,用 $remote_addr 重建来源信息,避免直接信任客户端提交的转发头。若前面还有 CDN 或负载均衡,应另外配置可信入口范围,不能直接沿用这里的客户端地址判断。

启用站点;同名链接已存在时应先核验,不要强制覆盖:

sudo ln -s /etc/nginx/sites-available/hkweb.conf \
  /etc/nginx/sites-enabled/hkweb.conf

sudo nginx -t
sudo systemctl reload nginx

只有 nginx -t 成功后才能重载。语法错误时先修复或恢复备份,不要重启 Nginx 来“试试看”。

在服务器本机验证:

curl --fail --max-time 5 \
  -H 'Host: app.example.com' \
  http://127.0.0.1/health/live

再从外部终端访问:

curl --fail --max-time 10 \
  http://app.example.com/health/live

本机成功、外部失败,优先检查 DNS、云平台入站规则、主机防火墙及公网连通性,而不是立即修改 systemd 重启策略。

2. 正式开放前切换为 HTTPS

取得与域名匹配的证书后,可将上述站点替换为以下配置。证书路径为示例,文件必须已存在;私钥不应授予应用账号读取权限。

server {
    listen 80;
    listen [::]:80;
    server_name app.example.com;

    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name app.example.com;

    ssl_certificate /etc/nginx/tls/app.example.com.fullchain.pem;
    ssl_certificate_key /etc/nginx/tls/app.example.com.key;
    ssl_protocols TLSv1.2 TLSv1.3;

    access_log /var/log/nginx/hkweb.access.log;
    error_log /var/log/nginx/hkweb.error.log;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
    }
}

再次执行检查、重载和外部验证:

sudo nginx -t
sudo systemctl reload nginx

curl --fail --max-time 10 \
  https://app.example.com/health/live

不要用 curl -k 作为最终验收,它会跳过证书验证。还应确认续期流程能够在证书更新后安全重载 Nginx。

如果应用使用 Cookie 认证或其他 Data Protection 功能,应将密钥保存到稳定的持久目录,例如 /var/lib/hkweb/keys,并配置访问权限。仅保留发布文件不能保证重启后已有登录状态仍然有效。

五、验证异常重启,并按风险顺序处理失败

1. 进行一次受控的进程退出测试

以下测试会中断当前请求,只能在尚未开放业务或已经安排维护窗口时执行。先确认没有不可重入的后台任务,必要时暂停任务或备份相关数据。

记录主进程:

systemctl show hkweb.service -p MainPID -p NRestarts

然后只终止这个服务的主进程:

sudo systemctl kill \
  --kill-whom=main \
  --signal=SIGKILL \
  hkweb.service

等待重启间隔和应用启动时间,再检查:

systemctl show hkweb.service \
  -p MainPID -p ActiveState -p SubState -p NRestarts

curl --fail --max-time 5 \
  http://127.0.0.1:5000/health/live

sudo journalctl -u hkweb.service -b -n 60 --no-pager

预期是 PID 发生变化、重启次数增加,随后存活检查恢复。日志中可能出现进程被 KILL 信号终止以及安排重启的记录。

恢复等待期内,Nginx 可能返回 502。单进程自动重启能恢复服务,但不能提供无中断切换;对连续可用性有更高要求时,需要多个实例和入口侧健康检查。

2. 验证人工停止不会被拉起

仍在维护窗口内执行:

sudo systemctl stop hkweb.service
sleep 8
systemctl is-active hkweb.service

预期返回 inactive。此时 is-active 返回非零退出码是正常现象。

重新启动并验证:

sudo systemctl start hkweb.service
curl --fail --max-time 5 \
  http://127.0.0.1:5000/health/live

这项测试区分了“进程意外退出”和“管理员明确停止”,避免把自动重启误解为无法停机。

3. 按由外到内、由低风险到高风险排查

现象优先检查结果含义与处理
公网无法访问,本机 Nginx 正常DNS、入站规则、证书和公网链路不应先重启应用
Nginx 返回 502本机 5000 端口、应用日志、Nginx 错误日志常见于应用未启动或监听地址不匹配
status=203/EXECExecStart 的可执行文件路径和权限systemd 无法执行启动程序
提示缺少 frameworkdotnet --list-runtimes检查 ASP.NET Core 8 运行时及发布目标
出现权限拒绝运行账号、目标路径、unit 的写入限制将合法运行数据写入允许目录
start-limit-hit最近一次启动失败的日志先修复原因,再清除启动限流
服务 active,但健康检查超时应用卡死、线程池、依赖调用和资源状态单靠退出重启策略无法解决

遇到启动限流时,不要循环执行 restart。修复错误后再执行:

sudo systemctl reset-failed hkweb.service
sudo systemctl start hkweb.service

若怀疑内存不足导致进程被终止,检查内核日志:

sudo journalctl -k -b --no-pager \
  | grep -Ei 'out of memory|oom|killed process'

不要用禁用内存保护、无限制重启或给所有目录加写权限来掩盖故障。

还应区分两种异常:普通 HTTP 请求抛出异常,通常只导致该请求失败,进程并不会退出;只有进程退出,systemd 才会依据本例策略重启。 对“进程活着但服务不可用”的情况,需要额外的健康监控、连续失败判定和告警机制。

五、验证异常重启,并按风险顺序处理失败配图

六、完成验收,并保留明确的回滚路径

1. 上线前验收清单

完成配置后逐项检查:

  • systemctl is-enabled hkweb.service 返回 enabled。
  • 服务账号不是 root,发布目录不可由应用随意修改。
  • Kestrel 只监听本机地址,5000 端口未向公网开放。
  • 本机存活检查、Nginx 本机入口和外部 HTTPS 均能正常响应。
  • HTTPS 验证未跳过证书检查,证书续期流程明确。
  • 异常退出测试后,进程能恢复,日志能够解释退出原因。
  • 人工停止后不会被自动拉起。
  • 数据库和其他业务依赖另行验证通过。
  • 持久数据、认证密钥不依赖临时目录或发布目录。
  • 在可控维护窗口内完成服务器重启验证,并确认服务自动启动。

服务器重启测试前,应确认远程管理入口可用、数据已保存,且不会影响同机其他业务。配置了开机启动不等于已经验证重启后的完整链路。

2. 更新失败时回退发布版本

后续发布新版本时,继续使用独立目录,例如 release-002,不要直接覆盖 release-001。完成上传、权限设置和配置核验后,可以用临时链接切换:

sudo ln -s releases/release-002 /opt/hkweb/current.next
sudo mv -Tf /opt/hkweb/current.next /opt/hkweb/current
sudo systemctl restart hkweb.service

这里的 mv -Tf 会替换 current 符号链接。执行前应确认它确实是链接,并确认 current.next 不存在;切换链接不会替代服务重启,也不保证业务请求不中断。

如果新版本启动或验收失败,在维护窗口内回到上一版:

sudo ln -s releases/release-001 /opt/hkweb/current.rollback
sudo mv -Tf /opt/hkweb/current.rollback /opt/hkweb/current
sudo systemctl restart hkweb.service

curl --fail --max-time 5 \
  http://127.0.0.1:5000/health/live

回滚前确认旧版本与当前数据库结构兼容。回退程序集不会自动撤销数据库迁移,数据库变更需要独立的备份与恢复方案。

如果本次还修改了环境文件、unit 或 Nginx 配置,应从已记录的备份目录恢复对应文件。恢复 unit 后执行 daemon-reload;恢复 Nginx 配置后先执行 nginx -t,通过后再重载。不要将其他网站的配置一并回退。

3. 首次部署整体撤回

如果决定撤回首次部署,可以先取消该站点入口。确认下面的链接确实由本次操作创建后执行:

sudo unlink /etc/nginx/sites-enabled/hkweb.conf
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl disable --now hkweb.service

这只撤下指定站点并停止应用,不删除发布文件、日志和持久数据。如果语法检查失败,应先恢复站点链接或修复配置,不继续重载。

回滚完成后再核对:

  • 旧站点和同机其他业务仍能访问。
  • 应用已停止,或上一版本已恢复健康。
  • 本次新增的入站规则已按原记录撤销。
  • 发布文件、数据目录和备份仍保留,便于排查。
  • 最终访问结果、服务状态与回滚记录一致。

这样建立的托管链路,能够把首次启动、异常恢复和人工维护区分开:systemd 管进程,Nginx 管入口,健康检查验证服务,版本目录与备份负责回退。每一层都有对应的验证点,才能避免“进程已经启动”被误判为“应用已经稳定上线”。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3886.html

相关推荐