Linux服务器部署ASP.NET Core应用,需要配置哪些运行与服务管理条件?
要把 ASP.NET Core 应用部署到 Linux 服务器并稳定对外提供服务,不能只确认 dotnet MyApp.dll 能运行。还需要让服务器具备匹配的运行时,用 systemd 管理应用进程,通过 Nginx 提供公网入口与 HTTPS,并确认日志、资源余量和更新回滚路径。

下面以 Ubuntu 24.04、面向 .NET 8 构建的应用、域名 app.example.com 为例,完成一次首次上线。示例中的 MyApp.dll、域名、发布目录和版本号都要替换成实际值。操作由具备 sudo 权限的部署人员执行;应用已在开发或构建环境通过测试,且提供返回 HTTP 200 的 /health 接口。若健康检查还要反映数据库等依赖状态,应由应用自身实现相应检查,不能仅靠 Nginx 判断。
A5idc数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器租用,可为ASP.NET Core应用、业务后台、接口服务及数据库部署提供独立的CPU、内存、SSD或NVMe存储与网络资源。产品覆盖Xeon、AMD EPYC等平台,并配备不同带宽和线路方案,能够承载从常规建站到多任务应用运行的服务器环境。
部署前确认运行边界
先核对系统架构、磁盘、内存和现有监听端口,避免安装完成后才发现架构不匹配或端口冲突:
cat /etc/os-release
uname -m
df -h /
free -h
sudo ss -lntp | grep -E ':(80|443|5000)\b' || true
本文示例按 x86_64 服务器和 linux-x64 发布。若 uname -m 显示 aarch64,应改用与 ARM64 匹配的发布目标;不要直接复制 x64 产物。磁盘空间要容纳当前版本、至少一个可回退版本、系统日志及应用运行数据。80、443 若已由其他服务占用,应先弄清现有入口配置,不要直接停用原服务。
上线前还应确认:
- 域名的 A 记录指向服务器公网 IPv4 地址;如果配置了 AAAA 记录,也要保证 IPv6 能到达相应 Web 入口,否则部分访问及证书验证可能失败。
- 云平台安全组和服务器防火墙允许业务所需的 TCP 80、443 端口;应用监听的 5000 端口不对公网开放。
- 应用所需的数据库连接、外部服务凭据等已有可靠来源。下文不会把真实密钥写入发布包或命令示例。
- 已备份现有 Nginx 配置。若服务器上已有同域名站点,应先确定替换窗口及恢复方式。
安装运行时并准备发布文件
在构建环境中确认项目目标框架为 net8.0,然后生成依赖服务器运行时的发布包:
dotnet publish ./MyApp.csproj -c Release -r linux-x64 --self-contained false -o ./publish
ls -la ./publish
预期发布目录中包含 MyApp.dll、.deps.json、.runtimeconfig.json 及应用依赖文件。如果采用单文件、自包含发布,服务器运行时要求会有所不同,不能把两种发布方式的检查条件混用。
在 Ubuntu 24.04 服务器安装与目标框架匹配的 ASP.NET Core Runtime。以下步骤会增加 Microsoft 软件源并安装软件包,应先确认服务器的软件源管理要求;已有对应运行时的服务器不必重复安装。
wget https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update
sudo apt install aspnetcore-runtime-8.0
dotnet --list-runtimes
在结果中应能看到 Microsoft.AspNetCore.App 8.0.x。如果应用要求的是其他主版本,应以项目的 .runtimeconfig.json 和发布配置为准,而不是只看服务器上是否存在任意版本的 dotnet。软件源或包安装失败时,先检查系统版本、架构及 apt update 报错,不要用不匹配发行版的软件源文件替代。
接着创建独立的非登录服务账户和版本目录。首次执行前先确认 myapp 用户及 /srv/myapp 路径没有被其他业务占用:
sudo useradd --system --home /var/lib/myapp --shell /usr/sbin/nologin myapp
sudo install -d -m 0750 -o root -g myapp /srv/myapp
sudo install -d -m 0750 -o root -g myapp /srv/myapp/releases
sudo install -d -m 0750 -o root -g myapp /srv/myapp/releases/20260515-01
这里以 20260515-01 作为示例版本号。把构建产物先上传至部署账户的家目录,例如 /home/deploy/myapp-publish/,确认文件完整后再放入版本目录:
sudo cp -a /home/deploy/myapp-publish/. /srv/myapp/releases/20260515-01/
sudo chown -R root:myapp /srv/myapp/releases/20260515-01
sudo chmod -R u=rwX,g=rX,o= /srv/myapp/releases/20260515-01
sudo ln -s /srv/myapp/releases/20260515-01 /srv/myapp/current
sudo -u myapp test -r /srv/myapp/current/MyApp.dll && echo "发布文件可读取"
这些权限变更只针对本应用的新版本目录:服务账户可以读取程序,但不能修改发布文件。应用需要写入的文件应另设运行数据目录,不要写进 /srv/myapp/current。如果 current 已存在,说明这不是首次部署,应先记录它当前指向的版本,再按更新流程切换,不能直接覆盖。
用 systemd 管理应用进程
手工启动适合临时检查,但终端退出后不应依赖该进程继续提供服务。创建 /etc/systemd/system/myapp.service,让 systemd 负责开机启动、异常退出后的重启及日志归集。写入前若同名服务已存在,先备份并核对其用途。
[Unit]
Description=MyApp ASP.NET Core service
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=myapp
Group=myapp
WorkingDirectory=/srv/myapp/current
ExecStart=/usr/bin/dotnet /srv/myapp/current/MyApp.dll
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=ASPNETCORE_URLS=http://127.0.0.1:5000
Restart=on-failure
RestartSec=5
TimeoutStopSec=30
StateDirectory=myapp
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
ASPNETCORE_URLS 将示例应用限制在本机回环地址,由 Nginx 接收公网请求。但应用代码或其他配置源可能覆盖监听设置,所以启动后必须核对实际端口。StateDirectory=myapp 为应用准备 /var/lib/myapp;如应用需要保存上传文件、生成文件或持久化数据,应在应用配置中明确指向受控目录,并规划备份,不能把这些数据当作可随版本删除的发布文件。
如果需要数据库密码等配置,应根据应用使用的配置机制单独管理权限和注入方式,避免把密钥放在 Git 仓库、可公开访问的目录或日志中。systemd 环境变量并不等同于专用密钥管理方案。
加载并启动服务:
sudo systemctl daemon-reload
sudo systemctl enable --now myapp.service
systemctl is-active myapp.service
sudo ss -lntp | grep ':5000'
curl -i --max-time 5 http://127.0.0.1:5000/health
预期服务状态为 active,监听地址为 127.0.0.1:5000,健康接口返回 HTTP 200。如果服务未启动,先查日志,再检查文件名、运行时和权限:
sudo systemctl status myapp.service --no-pager
sudo journalctl -u myapp.service -n 100 --no-pager
sudo -u myapp test -r /srv/myapp/current/MyApp.dll && echo "文件权限正常"
dotnet --list-runtimes
“找不到框架”通常指向运行时主版本不匹配;“找不到 DLL”或工作目录错误,应核对发布包名称与服务文件;端口已占用则需定位占用进程,不能为了让应用启动而直接结束未知业务。若服务显示 active 但 /health 失败,还要检查接口路径、应用自身依赖以及实际监听地址。

配置 Nginx 入口与 HTTPS
本示例使用 Nginx 接收请求,并使用 Certbot 的 Webroot 方式申请证书。先安装软件并创建仅供证书验证使用的目录:
sudo apt install nginx certbot
sudo install -d -m 0755 /var/www/letsencrypt/.well-known/acme-challenge
首次申请证书前,在 /etc/nginx/sites-available/myapp.conf 写入 HTTP 配置:
server {
listen 80;
server_name app.example.com;
location ^~ /.well-known/acme-challenge/ {
root /var/www/letsencrypt;
default_type text/plain;
}
location / {
return 301 https://$host$request_uri;
}
}
启用站点并检查语法:
sudo ln -s /etc/nginx/sites-available/myapp.conf /etc/nginx/sites-enabled/myapp.conf
sudo nginx -t
sudo systemctl reload nginx
若同名软链接或配置文件已存在,不要覆盖;先核对已有站点。nginx -t 失败时不要执行 reload,应按其报告的文件及行号修正配置。申请证书前,确认域名解析已生效且外部能够访问服务器的 80 端口:
sudo certbot certonly --webroot -w /var/www/letsencrypt -d app.example.com
证书申请成功后,将同一站点配置补充为 HTTP 跳转与 HTTPS 反向代理。修改已有文件前保留副本:
sudo cp -a /etc/nginx/sites-available/myapp.conf /etc/nginx/sites-available/myapp.conf.pre-https
完整配置示例如下:
server {
listen 80;
server_name app.example.com;
location ^~ /.well-known/acme-challenge/ {
root /var/www/letsencrypt;
default_type text/plain;
}
location / {
return 301 https://$host$request_uri;
}
}
server {
listen 443 ssl;
server_name app.example.com;
ssl_certificate /etc/letsencrypt/live/app.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/app.example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:5000;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
确认配置及证书文件路径后再加载:
sudo nginx -t
sudo systemctl reload nginx
curl -I --max-time 10 https://app.example.com/health
curl 应能完成证书校验并收到健康接口预期的 HTTP 响应。如果本机请求成功、外部请求失败,应先看 DNS、公网 80/443 连通性和安全组;如果外部返回 502 Bad Gateway,应检查 myapp.service、本机 5000 端口及 Nginx 错误日志:
sudo journalctl -u nginx -n 80 --no-pager
sudo journalctl -u myapp.service -n 80 --no-pager
应用如果依赖原始客户端 IP、HTTPS 判断、重定向 URL 或认证回调,除了 Nginx 发送 X-Forwarded-* 请求头,还须在 ASP.NET Core 中配置转发头处理中间件,并将可信代理限定为实际的 Nginx 来源。本例反向代理通过 127.0.0.1 连接应用;不要无条件信任任意来源提交的转发头。
证书签发完成不代表续期已经安排妥当。检查服务器上的 Certbot 定时任务,并试运行续期流程:
systemctl list-timers --all | grep certbot || true
sudo certbot renew --dry-run
还需确保证书实际续期后 Nginx 会重新加载,使新证书生效;可以按服务器的 Certbot 部署钩子机制配置 reload,并验证钩子执行情况。若由现有证书管理系统统一处理,应沿用该系统,不要并行建立两套互相冲突的续期任务。
上线验收与回滚检查项
正式交付时,不只记录“网页能打开”。至少逐项确认以下结果:
- 进程与自启:
systemctl is-enabled myapp.service显示已启用,systemctl is-active myapp.service显示运行中;必要时在维护窗口验证重启后的恢复情况。 - 监听与入口:5000 只监听本机地址;外部通过域名访问 HTTPS
/health返回预期结果,HTTP 请求按配置跳转至 HTTPS。 - 日志与资源:
journalctl -u myapp.service能看到启动或错误信息,Nginx 日志可用于区分入口错误与应用错误;df -h /、free -h显示仍有满足业务增长和保留版本所需的余量。 - 证书与依赖:浏览器或
curl未报告证书错误,续期测试通过;依赖数据库等外部服务的接口按实际业务验收,而不只检查进程存活。 - 可回退文件:保留上一版发布目录、原 Nginx 配置及必要的应用数据备份,并记录每个版本对应的部署时间和变更内容。
首次部署若未承接流量,回滚可先停止并禁用本次新增的服务,再恢复原站点配置;仅在确认文件属于本次部署且已备份需要保留的内容后,才移除新增文件。不要删除 /var/lib/myapp 等可能含业务数据的目录。
后续更新时,先记录 readlink -f /srv/myapp/current 的结果,再上传新版本并切换 current。若新版本健康检查或业务验收失败,把链接重新指向保留的上一版,重启 myapp.service,再按“本机健康接口 → HTTPS 入口 → 业务依赖”的顺序复核。若新版本同时改变了数据库结构或外部状态,程序文件回退未必足够;这类变更应在上线前另行制定数据备份与兼容性方案。

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



