在香港服务器部署ASP.NET Core 8应用,如何配置进程托管与异常重启?
要让香港服务器上的 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.dllHkWeb.deps.jsonHkWeb.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/EXEC | ExecStart 的可执行文件路径和权限 | systemd 无法执行启动程序 |
| 提示缺少 framework | dotnet --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



