如何在韩国Linux服务器上部署ASP.NET Core 8应用并配置进程托管?
本文以韩国机房中的 Ubuntu 22.04/24.04 x86-64 Linux 服务器为例,将 ASP.NET Core 8 应用发布为依赖框架的文件,由 systemd 负责启动、异常重启和日志管理,再用 Nginx 接收公网请求并转发到仅监听本机的 Kestrel。该方案适合单机首次上线;若实际系统是其他发行版或架构,应先核对对应的 .NET 8 运行时包和软件源,不能直接照搬 Ubuntu 命令。
开始前需要准备好应用的 Release 构建、服务器 SSH 权限、已指向服务器公网地址的域名,以及服务器或云平台防火墙的 80、443 端口放行条件。以下域名、应用名、目录和版本号均为示例,执行时替换为自己的值;输出示例用于说明预期状态,不代表某台服务器的实测记录。
部署结构与准备条件
请求链路为:

浏览器 → Nginx(80/443)→ Kestrel(127.0.0.1:5000)→ ASP.NET Core 8 应用
Kestrel 只监听回环地址,公网只开放 SSH 管理端口和 Web 服务端口。systemd 以专用低权限用户运行应用;程序包保存在版本目录中,便于应用发布失败时切换回上一版本。
面向 ASP.NET Core 网站、业务后台和接口服务的部署需求,A5idc数据提供韩国首尔物理服务器资源,并配备不同 CPU、内存、存储及优化/国际线路方案,可为 Linux 环境下的 Kestrel 应用、Nginx 入口和持续运行的业务进程提供相应的硬件与网络基础,覆盖常规站点到多任务业务服务等部署场景。
核对系统、域名和防火墙
先确认发行版、架构、网络和时区:
cat /etc/os-release
dpkg --print-architecture
timedatectl status
getent ahosts app.example.kr
确认域名解析到这台服务器的公网地址。如果域名配置了 AAAA 记录,也要确认它指向可用的 IPv6 地址;错误的 AAAA 记录可能导致部分客户端访问到错误的服务器。应用使用韩国本地时间时,可在应用配置中指定 Asia/Seoul;若没有业务要求,不必为了部署而修改整台服务器的时区,日志和数据库通常也应明确区分存储时间与展示时区。
在服务器提供商的防火墙中,允许公网访问 TCP 80 和 443;SSH 端口应仅对运维来源开放。ASP.NET Core 示例端口 5000 不应对公网开放。若服务器已启用 UFW,可先查看现有规则:
sudo ufw status verbose
只有在确认 SSH 已有放行规则且 UFW 已启用时,才按需增加 Web 端口规则:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
不要在远程管理会话中贸然启用 UFW,否则可能因 SSH 规则缺失而失去连接。若之后需要撤销上述规则,可执行:
sudo ufw delete allow 80/tcp
sudo ufw delete allow 443/tcp
准备应用与发布版本
应用项目应以 net8.0 为目标框架,并在发布前完成配置检查。连接字符串、API 密钥等敏感信息不要写进源码或发布包;准备通过服务器上的环境变量或受限权限的配置文件注入。若应用有上传文件、SQLite 数据库或其他运行时写入内容,应放在独立的数据目录,而不是版本目录。
发布前保留当前运行版本和必要的数据备份。应用升级若包含数据库结构变更,还需要单独确认迁移是否兼容旧版本;切回旧程序文件并不能自动撤销已经执行的数据库迁移。
部署与配置
1. 安装 ASP.NET Core 8 运行时和 Nginx
以下命令适用于对应版本的软件源可用的 Ubuntu 22.04/24.04。先安装 Nginx 和下载工具,再添加微软的软件包源:
sudo apt update
sudo apt install -y nginx ca-certificates wget
. /etc/os-release
wget "https://packages.microsoft.com/config/ubuntu/${VERSION_ID}/packages-microsoft-prod.deb" \
-O /tmp/packages-microsoft-prod.deb
sudo dpkg -i /tmp/packages-microsoft-prod.deb
sudo apt update
安装 ASP.NET Core 8 运行时:
apt-cache policy aspnetcore-runtime-8.0
sudo apt install -y aspnetcore-runtime-8.0
dotnet --list-runtimes
输出中应能看到 Microsoft.AspNetCore.App 8.0.x,并且系统能够找到 dotnet。如果软件源中没有对应包,先核对发行版版本、架构和软件源配置,不要从不明来源下载运行时文件。
2. 发布应用并上传到版本目录
在开发机或构建机的项目目录中执行发布。此示例生成依赖服务器运行时的文件:
dotnet publish ./MyApp.csproj \
-c Release \
-f net8.0 \
--no-self-contained \
-o ./publish
把发布目录打包并上传到服务器。包名中的版本号只是示例,实际部署时应使用每次发布唯一的标识:
tar -czf myapp-20250308.tar.gz -C ./publish .
scp myapp-20250308.tar.gz admin@服务器公网地址:/tmp/
在服务器上创建专用运行用户、版本目录和应用数据目录。useradd 只需在首次部署时执行;如果用户已经存在,先用 id myapp 核对后跳过该命令。
sudo useradd --system --user-group \
--home-dir /opt/myapp \
--shell /usr/sbin/nologin \
myapp
sudo install -d -o root -g myapp -m 0750 /opt/myapp
sudo install -d -o root -g myapp -m 0750 /opt/myapp/releases
sudo install -d -o myapp -g myapp -m 0750 /var/lib/myapp
解压发布包,并让运行用户所属的组可以读取应用文件,但不允许应用进程修改程序版本:

REL=20250308
sudo install -d -o root -g myapp -m 0750 "/opt/myapp/releases/$REL"
sudo tar -xzf /tmp/myapp-20250308.tar.gz \
-C "/opt/myapp/releases/$REL"
sudo chown -R root:myapp "/opt/myapp/releases/$REL"
sudo chmod -R go-w "/opt/myapp/releases/$REL"
创建供 systemd 使用的当前版本链接:
sudo ln -s "/opt/myapp/releases/$REL" /opt/myapp/current
确认发布目录中存在应用主程序集,并检查运行用户可读取文件:
sudo ls -l /opt/myapp/current/MyApp.dll
sudo -u myapp test -r /opt/myapp/current/MyApp.dll \
&& echo "应用文件可读"
如果项目生成的主程序集并非 MyApp.dll,后续配置中也要使用实际文件名。
3. 使用 systemd 托管 Kestrel 进程
创建 /etc/systemd/system/myapp.service:
[Unit]
Description=MyApp ASP.NET Core 8 service
Wants=network-online.target
After=network-online.target
[Service]
WorkingDirectory=/opt/myapp/current
ExecStart=/usr/bin/dotnet /opt/myapp/current/MyApp.dll
User=myapp
Group=myapp
Restart=on-failure
RestartSec=5
KillSignal=SIGINT
SyslogIdentifier=myapp
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=ASPNETCORE_URLS=http://127.0.0.1:5000
EnvironmentFile=-/etc/myapp/myapp.env
[Install]
WantedBy=multi-user.target
ASPNETCORE_URLS 将 Kestrel 固定到本机地址,Nginx 才能连接;不要改成 0.0.0.0:5000 后再把 5000 对公网开放。可将连接字符串等运行配置放入 /etc/myapp/myapp.env,文件格式为每行一个环境变量,例如使用 ConnectionStrings__Default 对应 ASP.NET Core 的分层配置键。该文件可能包含机密信息,应由 root 管理并限制读取权限;不要把真实密码写进命令历史或公开的部署文档中。
创建环境变量文件并限制权限:
sudo install -d -o root -g myapp -m 0750 /etc/myapp
sudoedit /etc/myapp/myapp.env
sudo chown root:myapp /etc/myapp/myapp.env
sudo chmod 0640 /etc/myapp/myapp.env
启用服务并立即启动:
sudo systemctl daemon-reload
sudo systemctl enable --now myapp
sudo systemctl status myapp --no-pager
状态应显示服务处于运行状态。查看应用启动日志:
sudo journalctl -u myapp -n 100 --no-pager
服务进程的标准输出和错误输出由 systemd 日志接收。应用自身的文件日志若有需要,应设置明确的目录和轮转策略,不要把可写日志放进只读的版本目录。
4. 配置 Nginx 反向代理
创建 /etc/nginx/sites-available/myapp,将域名替换为实际值:
server {
listen 80;
listen [::]:80;
server_name app.example.kr;
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;
proxy_read_timeout 60s;
}
}
启用配置并检查语法:
sudo ln -s /etc/nginx/sites-available/myapp \
/etc/nginx/sites-enabled/myapp
sudo nginx -t
sudo systemctl reload nginx
只有 nginx -t 检查通过后才执行重载。如果同一台服务器上已有站点,应先核对现有的监听端口和 server_name,避免改动其他站点的配置。
5. 配置 HTTPS 和转发头
申请证书前,域名必须解析到该服务器,公网 TCP 80 端口应可达。安装 Certbot 的 Nginx 插件并申请证书:
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d app.example.kr
按提示完成邮箱和条款确认。完成后检查 Nginx 配置并验证 HTTPS:
sudo nginx -t
curl -I https://app.example.kr/
sudo certbot renew --dry-run
应用部署在 Nginx 后面时,需要正确识别由 Nginx 转发的原始协议和客户端地址。否则,应用生成的绝对链接、安全 Cookie 或 HTTPS 重定向可能出现错误。ASP.NET Core 8 项目可在 Program.cs 中配置可信代理地址,并确保转发头中间件尽早执行:
using System.Net;
using Microsoft.AspNetCore.HttpOverrides;
var builder = WebApplication.CreateBuilder(args);
builder.Services.Configure<ForwardedHeadersOptions>(options =>
{
options.ForwardedHeaders =
ForwardedHeaders.XForwardedFor |
ForwardedHeaders.XForwardedProto;
options.KnownProxies.Add(IPAddress.Loopback);
});
// 其他服务注册
var app = builder.Build();
app.UseForwardedHeaders();
// 如应用使用 HTTPS 重定向,应放在转发头处理中间件之后
app.UseHttpsRedirection();
// 其余中间件和路由
app.Run();
这里的可信代理地址必须与 Nginx 实际连接应用时使用的地址一致。示例中的 Nginx 通过 127.0.0.1 连接 Kestrel,因此信任回环地址即可;不要无条件信任所有代理或来自公网的转发头。修改应用代码后需要重新发布,并通过 systemd 重启服务。
部署后的逐项验证
先确认服务管理和监听地址:
sudo systemctl is-enabled myapp
sudo systemctl is-active myapp
sudo ss -lntp
应能看到应用监听 127.0.0.1:5000,而不是对公网监听;Nginx 则负责对外监听 80 和 443。再分别验证应用、Nginx 和 HTTPS。若项目实现了健康检查端点,可以用 /health;若没有,应改用应用实际存在的路由:
curl -i http://127.0.0.1:5000/health
curl -i -H 'Host: app.example.kr' http://127.0.0.1/health
curl -i https://app.example.kr/health
成功状态码取决于应用路由:健康检查端点通常返回 200;未实现的路径可能返回 404,这本身不能说明服务故障。重点是本机请求、经 Nginx 的 HTTP 请求和 HTTPS 请求分别到达预期的应用路由,且日志中没有持续的异常或重启记录。
常见异常处理
| 现象 | 优先检查 | 可能原因 |
|---|---|---|
systemctl status 显示启动失败或反复重启 | sudo journalctl -u myapp -n 100 --no-pager | 主程序集路径或名称错误、运行时未安装、环境变量缺失、应用启动时发生异常 |
| 本机请求失败 | sudo ss -lntp 和应用日志 | 服务未运行、端口配置不一致,或应用实际监听地址与 ASPNETCORE_URLS 不同 |
| Nginx 返回 502 | 先请求 http://127.0.0.1:5000,再检查 Nginx 错误日志 | Kestrel 未启动、Nginx 上游地址或端口配置不匹配、服务进程启动后立即退出 |
| HTTPS 页面循环跳转或生成 HTTP 链接 | 检查 Nginx 的 X-Forwarded-Proto 和应用的转发头中间件顺序 | 应用未识别外部 HTTPS,或可信代理地址与实际连接地址不一致 |
| 证书申请失败 | 检查域名解析、提供商防火墙、UFW 和 TCP 80 可达性 | DNS 指向错误、验证流量无法到达 Nginx,或域名并未解析到这台服务器 |
| 应用报权限错误 | 检查 User、Group 和具体文件或数据目录权限 | 应用把运行时写入内容放在只读发布目录,或运行用户没有访问数据目录的权限 |
Nginx 日志可用于区分入口故障和应用故障:
sudo tail -n 100 /var/log/nginx/error.log
sudo tail -n 100 /var/log/nginx/access.log
本机请求已失败时,优先处理应用服务和 Kestrel;本机请求正常但域名访问失败时,再检查 Nginx、域名解析、证书和网络防火墙。不要通过开放 5000 端口来绕过 Nginx 故障。

回滚到上一版本
保留上一版本目录,并记下它的实际路径,例如 /opt/myapp/releases/20250301。回滚前确认该版本仍兼容当前数据库结构和环境变量。下面的操作假设 /opt/myapp/current 是指向版本目录的符号链接:
PREVIOUS_RELEASE=/opt/myapp/releases/20250301
NEW_LINK="/opt/myapp/current.rollback.$(date +%s)"
sudo ln -s "$PREVIOUS_RELEASE" "$NEW_LINK"
sudo mv -Tf "$NEW_LINK" /opt/myapp/current
sudo systemctl restart myapp
sudo systemctl status myapp --no-pager
sudo journalctl -u myapp -n 100 --no-pager
确认服务恢复后,再检查本机健康端点和外部 HTTPS 访问。若问题由 Nginx 配置变更造成,应在修改配置前保留旧配置;回滚时恢复对应站点配置,先运行 sudo nginx -t,通过后再执行 sudo systemctl reload nginx。不要为回滚应用程序而删除证书配置或改动其他站点。
验收与回滚检查项
- [ ]
dotnet --list-runtimes中存在 ASP.NET Core 8 运行时。 - [ ]
myapp服务已启用,运行用户不是 root,进程没有持续重启。 - [ ] Kestrel 仅监听
127.0.0.1:5000,公网防火墙未开放 5000。 - [ ] Nginx 配置通过
nginx -t,域名 HTTP/HTTPS 请求到达预期应用路由。 - [ ] 证书申请成功,
certbot renew --dry-run未报告续期失败。 - [ ] 应用日志、Nginx 日志和必要的数据目录均可按权限读取或写入。
- [ ] 上一版本目录仍保留,已明确切换回旧版本的操作步骤。
- [ ] 若发布包含数据库迁移,已单独确认数据备份和迁移回退方案;不能只依赖切换应用版本完成恢复。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9506.html



