如何部署ASP.NET Core Web API？如何打包实现跨平台安装？

架构老林

2026-7-23

1. 如何部署ASP.NET Core Web API？

以下是几种主流部署方式的核心步骤：

自托管部署
1. 发布项目：在项目根目录执行命令 dotnet publish -c Release，默认生成**依赖框架部署（FDD）**包，需要目标机器预先安装对应版本的.NET Runtime。
2. 启动服务：进入发布目录，Windows环境执行 dotnet YourApiName.dll，Linux/macOS环境执行 ./YourApiName 即可启动API服务。
IIS部署（Windows专属）
1. 准备环境：确保服务器安装IIS，以及对应.NET版本的ASP.NET Core Hosting Bundle（包含IIS模块和.NET Runtime）。
2. 发布并复制文件：执行 dotnet publish -c Release，将发布目录下的所有文件复制到IIS站点的物理路径。
3. 配置站点：在IIS管理器中创建新站点，绑定端口/域名，将应用程序池的托管管道模式设置为无托管代码。

Linux部署（Nginx反向代理）

发布上传：执行 dotnet publish -c Release，将发布包通过SCP等工具上传到Linux服务器。
安装依赖：根据项目的.NET版本，安装对应的Linux版.NET Runtime。

配置Nginx：创建Nginx配置文件，添加反向代理规则指向API的监听端口（默认5000），示例配置片段：

server {
    listen 80;
    server_name yourdomain.com;

    location / {
        proxy_pass http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection keep-alive;
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

重启Nginx服务使配置生效。

设置开机自启：用systemd创建服务单元（如/etc/systemd/system/yourapi.service），内容示例：

[Unit]
Description=Your ASP.NET Core API

[Service]
WorkingDirectory=/path/to/publish/dir
ExecStart=/usr/bin/dotnet /path/to/publish/dir/YourApiName.dll
Restart=always
User=www-data
Environment=ASPNETCORE_ENVIRONMENT=Production

[Install]
WantedBy=multi-user.target

执行 systemctl daemon-reload 和 systemctl enable --now yourapi 完成配置。

容器化部署（跨平台通用）

编写Dockerfile：采用多阶段构建减小镜像体积，示例：

# 构建阶段
FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /src
COPY ["YourApiName.csproj", "."]
RUN dotnet restore "./YourApiName.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "YourApiName.csproj" -c Release -o /app/build

# 发布阶段
FROM build AS publish
RUN dotnet publish "YourApiName.csproj" -c Release -o /app/publish /p:UseAppHost=false

# 运行阶段
FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "YourApiName.dll"]

构建镜像：执行 docker build -t yourapi-image .。
运行容器：执行 docker run -d -p 5000:80 yourapi-image，将容器内的80端口映射到主机的5000端口。

2. 如何打包ASP.NET Core Web API以支持任意操作系统安装？

针对跨操作系统的分发需求，推荐以下几种方案：

自包含部署包（SCD）
自包含部署会将.NET Runtime与应用程序打包在一起，目标机器无需预先安装.NET Runtime，可针对不同平台单独打包：
1. 发布指定平台的包：
  - Windows x64：dotnet publish -c Release -r win-x64 --self-contained true
  - Linux x64：dotnet publish -c Release -r linux-x64 --self-contained true
  - macOS x64：dotnet publish -c Release -r osx-x64 --self-contained true
2. 分发：将每个平台的发布目录压缩为zip（Windows）或tar.gz（Linux/macOS），用户解压后直接运行对应平台的可执行文件（Windows为.exe，Linux/macOS为无后缀可执行文件）。
Docker容器镜像
Docker镜像可在任何支持Docker的操作系统（Windows/Linux/macOS）上运行，完全消除环境差异：
1. 构建跨平台镜像：使用多阶段Dockerfile（参考上一问题的容器化部署示例），通过docker buildx可构建支持多架构的镜像，命令示例：
```
docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64,windows/amd64 -t yourusername/yourapi:latest --push .
```
2. 用户使用：只需安装Docker，执行 docker pull yourusername/yourapi:latest 和 docker run -d -p 5000:80 yourusername/yourapi:latest 即可启动服务。
跨平台安装器
若需要类似传统安装包的体验，可使用工具生成对应平台的安装程序：
- Windows：用Inno Setup或WiX Toolset生成.exe安装包，可配置快捷方式、服务注册、环境变量等。
- Linux：用Flatpak或Snap打包，用户可通过系统包管理器一键安装，自动处理依赖。
- 跨平台通用：使用Paketo Buildpacks，无需编写Dockerfile，直接将项目打包为OCI标准的容器镜像，支持多平台分发。

内容的提问来源于stack exchange，提问作者John Butler