在香港Linux服务器部署ASP.NET Core 10应用,如何配置进程守护?

发布人:A5数据发布时间:2026-10-15 10:47阅读量:139

在香港Linux服务器上部署ASP.NET Core 10应用,建议使用 systemd管理应用进程、Nginx处理公网HTTP/HTTPS请求、Kestrel只监听本机端口。systemd负责开机启动、异常退出后重启、运行身份、日志收集和资源约束;Nginx反向代理不能替代进程守护。

部署方案概览配图

下面以Ubuntu Server 24.04 LTS、框架依赖型发布的ASP.NET Core 10应用为例,完成部署、验证、故障处理与回滚。示例应用名为A5App,域名为app.example.com,内部端口为5000。执行前应替换这些值;示例状态与输出仅用于说明判断方法,不代表具体服务器的执行记录。

一、准备环境与部署目录

1. 核对服务器、权限与网络条件

本教程适用于使用systemd的Ubuntu Server 24.04,不应直接照搬到其他发行版。服务器所在地区不改变systemd配置方法,但从香港服务器下载运行时、访问软件仓库以及连接数据库时,仍需分别验证网络可达性。

准备以下条件:

  • 可以使用SSH登录,操作账号具有sudo权限。
  • 域名已指向服务器公网地址;存在AAAA记录时,IPv6也必须能正确访问。
  • 云端安全组允许公网访问TCP 80、443,SSH端口仅向管理来源开放。
  • 应用使用.NET 10,发布产物包含A5App.dll及对应依赖文件。
  • 数据库、上传文件和生产密钥的位置已明确,不混放在发布目录中。

先检查系统和架构:

cat /etc/os-release
uname -m
ps -p 1 -o comm=
timedatectl status

预期系统版本为Ubuntu 24.04,PID 1为systemd,时间同步正常。x86_64对应常见的x64发布目标,aarch64对应Arm64;包含原生依赖的应用尤其要匹配架构。

安装基础工具:

sudo apt update
sudo apt install -y \
  ca-certificates curl nginx certbot python3-certbot-nginx \
  libicu74 libssl3t64 zlib1g

这是Ubuntu 24.04示例依赖。若包名无法解析,应先检查系统版本和APT源,不要用其他发行版的库文件强行替换。

防火墙调整前先确认SSH实际端口及现有规则:

sudo ufw status verbose
sudo ss -lntp

如果UFW已启用,可允许HTTP和HTTPS:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

以上只增加网站端口规则,不修改SSH规则,也不自动启用UFW。远程操作时应保留当前SSH会话,并确认另一会话可以登录。需要撤销新增规则时,可使用对应的ufw delete allow命令;云端安全组仍要独立检查。

A5数据提供香港物理服务器租用,为ASP.NET Core网站、业务后台与接口服务提供部署资源基础。香港产品覆盖Xeon Gold和AMD EPYC等平台,配备SSD或NVMe存储,不同配置的内存与计算资源可承载应用进程、数据库及后台任务;CN2与国际带宽方案则面向不同访问人群的网络需求,为采用systemd守护、Nginx接入的生产应用提供硬件与网络支撑。

2. 安装并核验ASP.NET Core 10运行时

框架依赖型Web应用需要ASP.NET Core运行时,服务器不一定需要完整SDK。这里采用.NET安装脚本部署到/opt/dotnet,便于在systemd中使用明确的可执行文件路径。

curl -fL https://dot.net/v1/dotnet-install.sh \
  -o /tmp/dotnet-install.sh

less /tmp/dotnet-install.sh

确认下载成功并审阅脚本后执行:

sudo bash /tmp/dotnet-install.sh \
  --channel 10.0 \
  --runtime aspnetcore \
  --install-dir /opt/dotnet \
  --no-path

/opt/dotnet/dotnet --info
/opt/dotnet/dotnet --list-runtimes

预期运行时列表同时包含Microsoft.NETCore.App 10.0.x和Microsoft.AspNetCore.App 10.0.x。

--channel 10.0会选取该通道的可用版本,并非固定补丁版本。正式发布应记录实际安装版本;需要可重复部署时,改用已确认的--version 10.0.x。脚本安装的运行时不会自动纳入APT更新,后续安全补丁需要单独维护。

3. 分离代码、配置和可写数据

推荐使用以下目录结构:

路径用途权限原则
/srv/a5app/releases/版本号不可变发布产物应用账号只读
/srv/a5app/current指向当前版本的符号链接管理账号切换
/etc/a5app/a5app.env环境变量与敏感配置root读取,避免公开
/var/lib/a5app上传文件、数据保护密钥等应用账号可写

先确认同名账号没有被其他业务使用:

getent passwd a5app

如果不存在,再创建:

sudo useradd --system --user-group \
  --home-dir /var/lib/a5app \
  --shell /usr/sbin/nologin a5app

sudo install -d -o root -g root -m 0755 /srv/a5app/releases
sudo install -d -o root -g root -m 0750 /etc/a5app
sudo install -d -o a5app -g a5app -m 0750 /var/lib/a5app

独立账号能限制应用被攻破后的权限范围。不要给应用账号sudo权限,也不要通过chmod -R 777解决写入错误。

二、发布应用并准备生产配置

1. 在构建环境生成发布产物

以下命令在安装.NET 10 SDK的开发机或CI环境执行,不是在生产服务器上编译:

dotnet --list-sdks

dotnet publish ./A5App.csproj \
  -c Release \
  -f net10.0 \
  --self-contained false \
  -o ./publish

tar -C ./publish -czf A5App-release.tar.gz .
scp A5App-release.tar.gz deploy@服务器地址:/tmp/

若应用引用平台相关的原生库,应在发布时指定与服务器一致的RID,例如-r linux-x64或-r linux-arm64。不要把Windows发布目录直接当成Linux产物使用。

在服务器上创建一个新版本目录。以下版本号仅为示例:

RELEASE=20261201-01
RELEASE_DIR="/srv/a5app/releases/$RELEASE"

sudo install -d -o root -g root -m 0755 "$RELEASE_DIR"
sudo tar -xzf /tmp/A5App-release.tar.gz -C "$RELEASE_DIR"
sudo chown -R root:root "$RELEASE_DIR"
sudo chmod -R u=rwX,go=rX "$RELEASE_DIR"

sudo -u a5app test -r "$RELEASE_DIR/A5App.dll"
sudo -u a5app test -r "$RELEASE_DIR/A5App.runtimeconfig.json"

只解压可信构建产物。权限调整仅作用于本次新建目录;不要将上述递归命令改为作用于整个/srv或根目录。

首次部署时建立当前版本链接:

if [ -e /srv/a5app/current ] || [ -L /srv/a5app/current ]; then
  echo "current已存在,请按版本切换流程操作"
  exit 1
fi

sudo ln -s "$RELEASE_DIR" /srv/a5app/current
readlink -f /srv/a5app/current

预期链接指向刚创建的发布目录。上述变量只在当前Shell会话有效,重新登录后需要重新设置。

2. 让应用正确识别反向代理

Nginx终止HTTPS后,转发给Kestrel的是本机HTTP请求。应用若未处理转发头,可能产生HTTPS重定向循环、错误的回调地址或错误的客户端地址记录。

在Program.cs中、builder.Build()之前加入以下配置,并合并到现有代码中:

using System.Net;
using Microsoft.AspNetCore.DataProtection;
using Microsoft.AspNetCore.HttpOverrides;
using Microsoft.Extensions.Hosting;

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

    options.KnownProxies.Clear();
    options.KnownProxies.Add(IPAddress.Parse("127.0.0.1"));
});

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

builder.Services.AddDataProtection()
    .PersistKeysToFileSystem(
        new DirectoryInfo("/var/lib/a5app/keys"))
    .SetApplicationName("A5App");

构建应用后,确保转发头中间件位于HTTPS重定向、认证等中间件之前,并增加一个简单存活检查:

var app = builder.Build();

app.UseForwardedHeaders();

// 原有的HTTPS重定向、认证、授权等中间件放在此后。

app.MapGet("/healthz", () => Results.Ok(new { status = "ok" }));

// 保留原有路由映射。
app.Run();

这里信任的是同机Nginx的127.0.0.1,不是任意公网来源。引入外部负载均衡后,应重新定义可信代理边界。

/healthz仅证明应用能够处理请求,不代表数据库、消息队列等依赖正常。需要上线就绪检查时,应另设包含必要依赖检测的端点,且不要公开敏感诊断信息。

持久化数据保护密钥可以减少重启后Cookie失效的问题,但还要保持相同的应用名与认证配置。上述密钥文件没有额外配置静态加密,应通过目录权限、受保护的备份和必要的密钥加密机制控制风险。

3. 创建环境变量文件

sudo install -o root -g root -m 0600 \
  /dev/null /etc/a5app/a5app.env

sudo nano /etc/a5app/a5app.env

写入:

ASPNETCORE_ENVIRONMENT=Production
ASPNETCORE_URLS=http://127.0.0.1:5000
DOTNET_NOLOGO=true

如需数据库连接串,可按.NET配置层级使用ConnectionStrings__Default等键名。不要加入Shell的export语句,也不要认为文件会像Shell一样执行变量展开。

若该文件已经存在,不要执行会清空文件的install /dev/null操作,应先备份再编辑。环境变量适合基本部署,但高敏感凭据可以进一步迁移到专门的密钥管理方案。

三、配置systemd进程守护并逐项验证

1. 创建服务单元

若同名服务已经存在,先备份;首次部署则直接创建:

sudo nano /etc/systemd/system/a5app.service

写入以下完整配置:

三、配置systemd进程守护并逐项验证配图

[Unit]
Description=A5App ASP.NET Core 10 Service
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=120
StartLimitBurst=5

[Service]
Type=simple
User=a5app
Group=a5app
WorkingDirectory=/srv/a5app/current
ExecStart=/opt/dotnet/dotnet /srv/a5app/current/A5App.dll
EnvironmentFile=/etc/a5app/a5app.env

Restart=always
RestartSec=5
KillSignal=SIGTERM
TimeoutStopSec=45

StateDirectory=a5app
StateDirectoryMode=0750
UMask=0027

NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ReadWritePaths=/var/lib/a5app

MemoryAccounting=true
CPUAccounting=true
MemoryHigh=768M
MemoryMax=1G
CPUQuota=150%
TasksMax=256
LimitNOFILE=65536

StandardOutput=journal
StandardError=journal
SyslogIdentifier=a5app

[Install]
WantedBy=multi-user.target

关键配置的作用是:

  • Restart=always:常驻Web进程退出后自动重启,包括正常退出;管理员执行systemctl stop不会触发自动重启。
  • RestartSec=5:避免进程退出后立即高速重启。
  • 启动频率限制:120秒内允许最多5次启动,持续失败后停止尝试,避免无效重启风暴。
  • TimeoutStopSec=45:给应用30秒关闭窗口留出余量,超时后systemd可能强制结束进程。
  • ProtectSystem=strict:应用不能随意修改系统或发布目录,仅允许写入指定数据目录。
  • MemoryMax、CPUQuota:控制应用资源边界,而不是保证性能。

示例内存限制适合用于说明配置,不是ASP.NET Core的固定要求。MemoryMax=1G按systemd的二进制容量单位解释,为1 GiB;CPUQuota=150%约等于最多使用1.5个逻辑CPU的计算时间,并非整机CPU占用率的150%。应根据服务器总资源、其他服务和压测结果调整。

network-online.target也不等于远程数据库已就绪,应用仍需处理依赖连接失败与重试。

2. 校验、启动与设置开机启动

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

sudo systemctl status a5app.service --no-pager
sudo journalctl -u a5app.service -n 80 --no-pager

预期服务为active (running),日志中出现监听http://127.0.0.1:5000的信息,没有运行时缺失、权限错误或未处理异常。

继续验证监听和请求:

sudo ss -lntp | grep ':5000'
curl -fsS http://127.0.0.1:5000/healthz

预期端口只绑定127.0.0.1,响应类似:

{"status":"ok"}

如果监听在0.0.0.0:5000或[::]:5000,需要检查代码中的显式Kestrel端点配置。代码或其他端点配置可能覆盖ASPNETCORE_URLS,不能只检查环境变量文件。

3. 验证自动拉起与正常停止

自动重启测试会中断当前请求,只应在上线前或维护窗口执行:

sudo systemctl show a5app.service -p MainPID -p NRestarts
sudo systemctl kill --kill-who=main --signal=SIGKILL a5app.service
sleep 7
sudo systemctl show a5app.service -p MainPID -p NRestarts
curl -fsS http://127.0.0.1:5000/healthz

预期主PID变化、重启次数增加,健康检查恢复成功。SIGKILL不能验证优雅关闭,它只用于模拟进程突然终止。

再测试管理员正常停服:

sudo systemctl stop a5app.service
sudo systemctl is-active a5app.service
sudo systemctl start a5app.service

停服后应保持inactive,启动后重新恢复请求。守护进程能恢复进程退出,不能保证单实例服务没有中断,也不能自动发现所有进程卡死问题。 外部健康监控仍然必要。

四、接入Nginx、HTTPS与日志

1. 配置HTTP反向代理

创建新站点文件;如已存在同名配置,应先复制备份再修改:

sudo nano /etc/nginx/sites-available/a5app

写入:

server {
    listen 80;
    server_name app.example.com;

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

    client_max_body_size 20m;

    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 $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        proxy_connect_timeout 5s;
        proxy_read_timeout 60s;
    }
}

启用前确认没有重复站点链接:

sudo ln -s /etc/nginx/sites-available/a5app \
  /etc/nginx/sites-enabled/a5app

sudo nginx -t
sudo systemctl enable nginx
sudo systemctl reload nginx

如果链接已存在,不要重复创建。nginx -t成功后再重载,避免将错误配置带入运行环境。

本机验证Nginx转发:

curl -fsS -H 'Host: app.example.com' \
  http://127.0.0.1/healthz

直接访问Kestrel成功、经Nginx失败,说明应优先检查站点匹配、上游地址和Nginx错误日志,而不是修改运行时。

示例上传上限为20 MiB,业务允许的大文件还要同时核对ASP.NET Core和表单处理限制。WebSocket、流式响应及长时间任务需要额外配置,不能只靠增加超时时间解决。

2. 签发证书并检查续期

确认域名解析正确、80端口可从公网到达后执行:

sudo certbot --nginx \
  -d app.example.com \
  --redirect \
  -m ops@example.com \
  --agree-tos

Certbot会修改Nginx配置。执行前应备份站点文件,并将邮箱替换为能够接收通知的地址。

验证:

sudo nginx -t
curl -fsS https://app.example.com/healthz
sudo certbot certificates
sudo certbot renew --dry-run
systemctl list-timers --all | grep -i certbot

验收时不要给curl增加-k跳过证书校验。若续期定时器未出现,应检查实际安装方式提供的定时任务,不能仅凭首次签发成功判断后续会自动续期。

3. 核对日志和磁盘占用

应用控制台日志由journald收集:

sudo journalctl -u a5app.service --since "30 minutes ago"
sudo journalctl -u a5app.service -f
sudo journalctl --disk-usage

sudo tail -n 50 /var/log/nginx/a5app.error.log
df -h

应用应把可操作的错误写入日志,但不要输出连接串、令牌或完整个人信息。

journald是否跨重启保留日志取决于持久化配置;应检查/var/log/journal及journald设置。日志容量上限属于整机运维配置,调整时要考虑其他服务,不能只按一个应用的需求设置。

Nginx日志还应核对/etc/logrotate.d/nginx中的轮转策略。进程守护无法解决磁盘被日志写满的问题。

五、按低风险顺序处理常见异常

先区分“公网访问失败”“反向代理失败”和“应用进程失败”,再修改配置。

现象优先检查结果含义与处理
域名无法访问DNS、安全组、80/443监听公网入口问题,不一定与systemd有关
HTTPS证书错误域名、证书有效期、系统时间不应通过关闭校验绕过
Nginx返回502本机5000端口、服务状态、错误日志应用未运行或上游地址错误
服务启动后立即退出journal中的首个异常常见于运行时、配置、依赖或权限问题
start-limit-hit连续启动失败原因修复后再解除启动限制
请求重定向循环转发头中间件、可信代理、执行顺序应用可能误判原始请求为HTTP
部署后登录失效数据保护密钥、应用名、认证配置不只是进程重启问题

建议依次执行:

五、按低风险顺序处理常见异常配图

curl -v https://app.example.com/healthz
sudo nginx -t
curl -fsS http://127.0.0.1:5000/healthz
sudo systemctl status a5app.service --no-pager
sudo journalctl -u a5app.service -n 100 --no-pager

如果本机健康检查成功而公网失败,先排查入口链路;如果本机也失败,再检查服务日志。

修复启动错误后,解除频率限制并启动:

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

不要把reset-failed当作修复方法,它只清除失败状态和启动计数。

若进程反复被结束,应检查资源情况:

sudo systemctl show a5app.service \
  -p Result -p MemoryCurrent -p MemoryPeak -p NRestarts

sudo journalctl -k --since "30 minutes ago"

出现OOM相关记录时,先区分服务内存上限和整机内存不足,再分析缓存、请求并发、大文件处理或内存泄漏。直接无限放大MemoryMax可能把故障转移给同机数据库或Nginx。

权限错误则核对应用是否试图写入发布目录。优先把文件写入/var/lib/a5app;只有业务确实需要时,才增加范围明确的可写路径。

六、验收、备份与版本回滚

1. 上线验收检查项

正式接流量前至少完成:

  • systemctl is-enabled a5app.service返回enabled。
  • 服务持续运行,本机及公网健康检查均成功。
  • Kestrel只监听本机,公网未开放5000端口。
  • 自动拉起测试通过,管理员停服不会被自动拉起。
  • HTTPS证书有效,续期试运行成功,续期任务存在。
  • 上传、认证、数据库访问和后台任务经过业务验证。
  • 日志能定位错误,并设置了合理的保留与轮转策略。
  • 在维护窗口验证服务器重启后,应用与Nginx均能恢复。

上线后还应监控HTTP错误率、响应时间、服务重启次数、内存和磁盘空间。“进程存在”只是可用性的一个条件。

2. 备份需要恢复的状态

发布目录可以由构建产物重建,但生产配置、上传文件、数据保护密钥和数据库不能只依赖重新发布。

文件备份可在计划维护窗口执行。以下示例会短暂停服,以减少应用写入造成的不一致;数据库仍需单独使用适合该数据库的备份工具:

BACKUP="/root/a5app-backup-$(date +%Y%m%d-%H%M%S).tar.gz"

sudo systemctl stop a5app.service

sudo tar -czf "$BACKUP" \
  /etc/a5app \
  /etc/systemd/system/a5app.service \
  /etc/nginx/sites-available/a5app \
  /var/lib/a5app

sudo chmod 0600 "$BACKUP"
sudo systemctl start a5app.service

必须检查压缩命令的退出状态和备份文件内容;备份失败也应按维护预案恢复服务。备份包含敏感配置和密钥,应加密保存到服务器之外,并定期测试恢复。同机备份不能应对整机丢失。

3. 切换新版本与回滚

单实例切换会有短暂中断。发布前记录旧版本真实路径,并保留旧目录:

readlink -f /srv/a5app/current

新版本上传到独立目录、完成检查后,停服再切换链接。下面路径需替换为实际新版本:

六、验收、备份与版本回滚配图

sudo systemctl stop a5app.service

sudo ln -s /srv/a5app/releases/20261202-01 \
  /srv/a5app/current.next

sudo mv -Tf /srv/a5app/current.next /srv/a5app/current

sudo systemctl start a5app.service
curl -fsS http://127.0.0.1:5000/healthz
curl -fsS https://app.example.com/healthz

执行前确认current确实是符号链接,current.next不存在,目标版本完整且可读。mv -Tf用于替换链接,不应对未经确认的路径执行。仅替换应用文件不需要daemon-reload;修改服务单元后才需要重新加载。

新版本失败时,按相同方式指回记录下来的旧版本:

sudo systemctl stop a5app.service

sudo ln -s /srv/a5app/releases/20261201-01 \
  /srv/a5app/current.rollback

sudo mv -Tf /srv/a5app/current.rollback /srv/a5app/current

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

回滚后核对:

  • 当前链接是否指向正确旧版本。
  • 服务、健康检查和关键业务是否恢复。
  • 环境变量、systemd与Nginx配置是否需要一并恢复。
  • 数据库结构是否仍兼容旧应用。
  • 上传文件与数据保护密钥是否保留完整。
  • 故障日志和失败版本是否保留,便于后续分析。

代码回滚不等于数据库回滚。 新版本若进行了不兼容的数据库迁移,不能只切换目录就认为恢复完成。生产部署应在发布前明确数据库兼容策略与恢复流程,再让systemd承担进程守护职责。

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

相关推荐