Ubuntu下部署.NetCore WebApi的方法

摘要本文详细介绍了在Ubuntu系统上部署.Net Core WebApi的完整流程。主要内容包括：1) 安装指定版本的.Net Core SDK；2) 创建WebApi项目并进行本地测试；3) 发布项目到指定目录；4) 配置Systemd服务实现自动启动；5) 可选配置Nginx反向代理。文章提供了具体的命令示例和配置代码，并配有截图说明各步骤操作效果，帮助开发者快速完成.Net Core应用

罗马苏丹默罕默德

379人浏览 · 2026-01-10 23:05:45

罗马苏丹默罕默德 · 2026-01-10 23:05:45 发布

Ubuntu部署.NetCore WebApi的方法示例

1.安装.net core SDK

apt-cache search dotnet

searchdotnet

选择一个确定的SDK版本安装即可,已8.0版本为例

apt-get install dotnet-sdk-8.0

查看安装的.Net信息

dotnet --info

如何安装了多个版本，使用dotnet --info查询安装sdk列表

dotnet --version

显示当前使用的dotnet版本,如果要切换版本可参考:

linux安装.net8.0（极简版）+ .net多版本选择切换方法_51CTO博客_linux 安装.net core

wbt2

2.创建WebApi项目,然后运行发布

可以直接从现有的Git仓库直接拉取，这里直接创建一个为例：

dotnet new webapi -o TestProject

cd TestProject

wbt3

直接运行(先不要发布),查看是否可以在外部访问(服务器放开该端口连接)

dotnet run TestProject

wbt4

如果无法访问，请先修改launchsettings.json(Properties里)里的启动项

wbt6

查看是否正常访问：

wbt7

发布到目录下文件夹publish（自己创建可自定义发布路径）

sudo dotnet publish TestProject.csproj -o publish

wbt8

3.配置Systemd服务

sudo vim /etc/systemd/system/testproject.service

[Unit]
Description=.NET Core WebAPI
After=network.target

[Service]
Type=notify
WorkingDirectory=/home/ubuntu/repos/TestProject/publish
ExecStart=/usr/bin/dotnet /home/ubuntu/repos/TestProject/publish/TestProject.dll --urls "http://0.0.0.0:5000"
Restart=always
RestartSec=10
KillSignal=SIGINT
SyslogIdentifier=myapi
Environment=ASPNETCORE_ENVIRONMENT=Development
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

启动服务再使用外部访问:

sudo systemctl enable testproject.service
sudo systemctl start testproject.service

# 检查状态
sudo systemctl status testproject.service

wbt10

可选：配置NGINX

修改/etc/nginx/sites-available里的default为,重启NGINX

server {
    listen 80;
    server_name xxx.xxx.xxx.xxx;
    
    # 主代理配置
    location / {
        proxy_pass http://localhost:5000;
        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;
    }
    
    # 专门处理Swagger静态资源
    location ~ ^/swagger/(.*\.(js|css|png|jpg|json|html))$ {
        proxy_pass http://localhost:5000/swagger/$1;
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
}