在虚拟主机上部署 ASP.NET 站点:环境、权限与常见 500
把 ASP.NET 站点传到 Windows 虚拟主机,第一次打开大概率是 500。原因通常不是代码,而是应用池版本、web.config 配置或目录权限。这篇按排查顺序列清楚。
先确认主机支持什么
下单前问清四件事:
- 支持 .NET Framework 哪个版本(4.6 / 4.8),还是支持 .NET Core / .NET 8。
- 应用池是 32 位还是 64 位,能否切换。
- 是否允许自定义
web.config(有些主机锁定了system.webServer节点)。 - 是否支持伪静态(URL Rewrite 模块)。
这四项里任何一项不满足,部署都会卡住。尤其是第三项:共享主机常出于安全考虑锁定配置节,导致你的 rewrite 规则无效。
部署的五个步骤
1. 本地先发布成 Release
用 Visual Studio 的「发布」功能生成发布包,而不是直接把整个项目目录传上去。发布包只包含运行需要的文件,能避免源码泄露。
关键:把 <compilation debug="false"> 设好,生产环境不要开 debug。
2. 上传到站点根目录
注意根目录的层级:如果主机面板里站点根是 wwwroot,就把 bin、Content、web.config 直接放在 wwwroot 下,不要再套一层项目名文件夹。
3. 配置应用池
在主机面板里选对 .NET 版本与管道模式(Integrated)。Classic 模式只用于很老的程序。
4. 给目录写权限
需要写入的目录(上传目录、日志目录、App_Data)要给应用池账户(通常是 IIS_IUSRS 或 Network Service)修改权限。虚拟主机一般提供「目录权限」面板。
5. 配数据库连接串
把连接串写在 web.config 的 connectionStrings 里,不要硬编码在代码里。SQL Server 数据库要先在面板里建好、开好远程权限。
三个高频 500 错误
| 错误码 | 含义 | 怎么修 |
|---|---|---|
| 500.19 | 配置节被锁定或格式错误 | 删掉不被允许的节点,或让主机商解锁 |
| 500.21 | 处理程序未识别(Handler 未安装) | 应用池的 .NET 版本与程序不匹配 |
| 500.30 | 应用启动失败(.NET Core) | 看 stdout 日志,常见是连接串或运行时版本 |
排查方法:先在 web.config 里临时打开详细错误,看到具体堆栈再改。生产环境记得改回去。
<system.web> <customErrors mode="Off" /> <compilation debug="true" targetFramework="4.8" /> </system.web>
伪静态配置
ASP.NET 站点做静态化 URL,需要在 web.config 里写 rewrite 规则。前提是主机装了 URL Rewrite 模块。
<system.webServer>
<rewrite>
<rules>
<rule name="RemoveExt" stopProcessing="true">
<match url="^article/([0-9]+)/?$" />
<action type="Rewrite" url="/article.aspx?id={R:1}" />
</rule>
</rules>
</rewrite>
</system.webServer>
如果主机不给改配置
三个替代方案:换一家允许自定义配置的 Windows 主机;改用 Windows VPS 自己装 IIS;或者把站点迁到 .NET(跨平台)跑在 Linux 上。第三条长期成本最低,但要改代码。
web.config 里的 debug 设置、关闭详细错误、删除 elmah 一类调试页面的公网访问。ASP.NET 的详细错误页会暴露物理路径和堆栈,是攻击者的路标。