在香港Linux服务器部署ASP.NET Core 10应用,如何配置进程守护?
在香港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
写入以下完整配置:

[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



