用VS写的程序发布到服务器,核心就两步:在Visual Studio里生成发布文件,再到服务器上搭好运行环境并部署,具体走哪条路,取决于你的项目是网站、桌面程序还是后台服务。
visual studio发布网站到服务器,先分清这三类项目
很多人在VS里写完代码,点一下运行,浏览器弹出来,认为这就算完事了,等真正要发布到服务器,才发现完全不是一回事,VS里的“F5运行”是开发模式,服务器上跑的是“发布模式”,两者差别非常大。
Web项目:发布依赖IIS还是Nginx
ASP.NET Core Web应用是目前的主流,它跨平台,能部署到Windows Server配IIS,也能部署到Linux配Nginx,而老牌的ASP.NET(非Core版)只能跑在Windows的IIS上,选服务器之前先搞清楚自己用的是哪种。
判断方法:打开项目文件(.csproj),看里面有没有<TargetFramework>net8.0</TargetFramework>,如果有,说明是Core版,随便选平台,如果只有<TargetFramework>net48</TargetFramework>之类的老版本框架,那服务器必须配Windows + IIS,没得选。
非Web项目:控制台服务和桌面应用怎么处理
桌面应用(WinForms、WPF)发布后仍然带图形界面,只能通过远程桌面登录到服务器上运行,控制台程序(也叫后台服务)不带界面,发布后更适合配合Windows计划任务或者Linux的systemd在后台常驻。
| 项目类型 | 可部署平台 | 运行方式 | 复杂度 |
|---|---|---|---|
| ASP.NET Core Web | Windows / Linux | IIS或Nginx反向代理 | 中等 |
| 传统ASP.NET Web | 仅Windows | IIS | 简单 |
| 控制台程序 | Windows / Linux | 计划任务或systemd | 简单 |
| WinForms / WPF | 仅Windows | 远程桌面运行 | 有诸多限制 |
用VS发布程序到服务器,最稳的方式是“发布文件夹”
行业共识认为,生成发布文件夹是Visual Studio最可靠的发布方式,不依赖网络连接,不依赖目标服务器上的特殊服务,出了问题也好排查,下面按步骤来,你跟着操作就行。
第一步:确认运行模式,框架依赖还是自包含
这是VS发布时最常见的选项,选错了,到服务器上就各种“莫名其妙的错误”。
- 框架依赖:发布包小,但要求服务器上提前装好对应版本的.NET环境,多版本并存容易出问题,比如装了.NET 6又装.NET 8,系统有时会搞混。
- 自包含:发布包自带运行时,服务器上不用装.NET,但包体积大,一个简单的控制台程序可能就有百来兆。
建议:服务器是你自己掌控的,用框架依赖即可,反正环境都归你管,如果是要交付给客户部署,客户服务器环境不可控,直接用自包含模式,免去装运行时的麻烦。
第二步:还原依赖,确认本地能跑通
发布之前先确认,项目目录下bin\Release\net8.0\文件夹里能正常生成可执行文件,在VS里右键项目,选“生成”,看“输出”窗口有没有红色报错。生成通过再进行发布,这步不能跳。
第三步:右键发布,向导选择“文件夹”
具体操作路径:
- 在“解决方案资源管理器”里右键项目,选择“发布”
- 首次发布会弹出目标选择窗口,选“文件夹”
- 选择发布路径,默认是
bin\Release\net8.0\publish\ - 点击“发布”按钮,等待完成
发布完以后,把这个publish文件夹整个复制到服务器上,就完成了部署的一半,剩下一半是配置服务器环境,下面细说。
网站项目怎么直接发布到远程服务器
如果不想每次都用U盘或远程拷贝文件夹,VS也支持直接发布到远程服务器,这里有两种方案,按场景选。
Web Deploy直连发布
Web Deploy是微软出的部署工具,只支持Windows + IIS环境,适合服务器不多、偶尔更新一次的开发者,操作流程:
- 在目标Windows服务器上安装“Web Deploy 3.6”和“IIS管理服务”
- 在IIS“管理服务”中启用远程管理,设置允许连接的IP列表
- 回到VS的“发布”窗口,选择“Web Deploy”作为发布方式
- 填上服务器地址、站点名、凭据信息,点“验证连接”后即可发布
这个方案的好处是,以后每次改完代码,点一次“发布”就自动推送到服务器上。坏处是Web Deploy要求服务器开额外端口(默认8172),多数云服务器默认是封掉这个端口的,你需要在安全组策略里手动放行。
FTP方式上传发布文件
如果你用的是虚拟主机,或者不想在服务器上装额外组件,直接选择FTP方式。
在VS发布目标里选“FTP/FTPS”,填上服务器IP、端口、目录和账号密码,发布时把publish文件夹里的内容全部覆盖到你服务器的站点根目录,发布完成后,到服务器IIS管理器里给站点设置“应用程序池”的.NET CLR版本为“无托管代码”,并配置好物理路径指向你上传的目录。
核心提醒:IIS默认是启动的,但新绑定域名的站点,别忘了在“绑定”里添加80端口和对应域名,绑定完浏览器访问域名,能看到页面就说明基础部署通了。
vs怎么部署项目到Linux服务器
Linux现在是用VS发布程序的一个热门选择,毕竟省了Windows Server的授权费,怎么部署到Linux服务器?完整路径如下。
安装.NET运行时
在Ubuntu或CentOS上执行对应命令:
# Ubuntu 22.04 示例 sudo apt-get update sudo apt-get install -y aspnetcore-runtime-8.0
这里装的是ASP.NET Core运行时,能跑Web应用和普通控制台程序,如果你只需要不带Web功能的控制台程序,装dotnet-runtime-8.0即可。装完用dotnet --info验证一下版本,目录对得上再继续。
上传发布文件并启动
把本地的publish文件夹上传到服务器任意目录,比如/var/www/myapp/,然后在项目目录里执行:
cd /var/www/myapp dotnet MyApp.dll
看到Now listening on: http://localhost:5000这样的输出,就说明程序跑起来了,这是最简单的启动方式,但有个问题,一旦你关掉SSH终端,程序就停了。
systemd守护进程,保证后台常驻
要让程序在后台永远运行,需要配置systemd服务,新建一个服务文件:
sudo vim /etc/systemd/system/myapp.service
写入:
[Unit] Description=My ASP.NET Core Application After=network.target [Service] WorkingDirectory=/var/www/myapp ExecStart=/usr/bin/dotnet /var/www/myapp/MyApp.dll Restart=always RestartSec=10 KillSignal=SIGINT Environment=ASPNETCORE_ENVIRONMENT=Production [Install] WantedBy=multi-user.target
保存后执行:
sudo systemctl daemon-reload sudo systemctl enable myapp sudo systemctl start myapp
进程后台运行的问题解决了,外网访问还差一步。
Nginx反向代理配置
Linux服务器上,你的程序默认监听5000端口,要让浏览器通过80端口访问,用Nginx做个反向代理,在/etc/nginx/sites-available/default里改:
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;
}
}
改完执行sudo nginx -s reload,再访问你的服务器IP或域名,页面就能正常显示了。
发布后打不开,八成是这几个原因
程序发布到服务器,浏览器打不开,这种现象极其常见,业内专家指出,多数情况下问题不在代码,而是出在部署环境这套环节里。
端口没开或防火墙拦截
这一条是最高频的坑,你本地访问localhost:5000没问题,服务器上访问也通,但外面一访问就超时,先查云服务器的安全组,确认80端口(HTTP)和443端口(HTTPS)是放行状态,如果项目监听的是其他端口,比如8080,那安全组和系统防火墙都得放行。
运行环境版本对不上
本机用的是.NET 8 SDK编译,服务器上装的是.NET 6运行时,那一定会报错误“Framework not found”之类的提示,在服务器上执行dotnet --list-runtimes,看看装了哪些版本,跟发布时选的版本对准。
数据库连接串写死了
很多人在本地开发时,把连接串直接写在appsettings.json里,连的是本地的SQL Server,地址是localhost或,发布到服务器后,这个地址指向服务器本身,如果数据库是另一台机器,或者用的是云数据库,连接串里的服务器地址、账号、密码都要改。建议发布后先检查一下生产环境的连接串,确认数据库能被应用服务器访问到,很多时候页面能打开,但一登录就报500错误,就是这个问题。
vs发布程序到服务器:三个高频问题
Q1: 用VS发布到服务器,提示“无法连接到远程服务器”怎么办?
先本地确认网络能通,用命令行telnet 服务器IP 8172测试Web Deploy端口是否开放,连接失败就去云安全组里放行该端口,再确认IIS的“管理服务”已启动,“IIS管理器权限”中已经添加了当前登录的Windows用户并授予了“完全控制”权限,这两步都验证通过,VS再点“验证连接”就能成功。
Q2: 用VS发布的网站部署到IIS后,显示“HTTP 500.19”错误?
19是IIS配置错误,先在IIS管理器中选中你的站点,点击“基本设置”,确认物理路径的权限中,IIS_IUSRS用户组对该目录有“读取和执行”权限,如果路径包含中文或空格,也会触发这个错误,建议把文件放到纯英文目录下,检查过权限后,在IIS的“应用程序池”管理中重启对应池,然后刷新页面看结果。
Q3: VS发布的程序部署到Linux服务器后,访问显示502 Bad Gateway?
502说明Nginx是正常的,但代理的后端服务没起来,先到项目目录手动执行dotnet MyApp.dll看有没有报错信息,能正常启动后,再检查myapp.service文件里ExecStart的路径和WorkingDirectory是否写对,最后用sudo systemctl status myapp查看服务运行状态,看到Active: active (running)就说明服务没问题,这时候刷新浏览器就能通了。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/798808.html


