萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 網站發布至 IIS 完整指南:四種部署方式、權限設定與常見錯誤排查

前言

將 ASP.NET 網站發布到 IIS 是上線關鍵步驟。本文整理四種主流部署方式、IIS 功能啟用、資料夾權限、應用程式集區設定、預設文件、SSL/綁定,並提供上線後常見錯誤排查清單。

零、前置條件:啟用 ASP.NET 功能

# PowerShell 管理員執行
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ASPNET45 -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-NetFxExtensibility45 -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ISAPIExtensions -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ISAPIFilter -All
Enable-WindowsOptionalFeature -Online -FeatureName IIS-ASPNET -All
# 或透過「開啟或關閉 Windows 功能」GUI 勾選:
# IIS → Web 服務 → 應用程式開發 → ASP.NET 4.x

確認 IIS 管理員 → 「ISAPI 和 CGI 限制」→ ASP.NET v4.0 狀態為「允許」。

一、方式 1:直接複製到 wwwroot (最簡單、適合測試)

  1. 將 Visual Studio 發布輸出資料夾 (含 .aspx、.dll、web.config、bin、Images 等) 整個複製到 C:\inetpub\wwwroot\MyApp。
  2. 右鍵資料夾 → 「屬性」→「安全性」→ 確認 IIS_IUSRS (或 IUSR) 擁有 讀取 & 執行、列出資料夾內容、讀取 權限。
  3. IIS 管理員 → 「網站」→ 右鍵「預設網站」→「加入應用程式」:
    • 別名:MyApp
    • 實體路徑:C:\inetpub\wwwroot\MyApp
    • 應用程式集區:選 .NET CLR v4.0 整合模式 (或 No Managed Code 若為 Core)。
  4. 瀏覽 https://localhost/MyApp/ 測試。

二、方式 2:Visual Studio 「發布」功能 (Web Deploy / 檔案系統)

  1. 專案右鍵 → 「發布」→ 目標選 資料夾 或 Web Deploy。
  2. 設定檔案:Configuration=Release、Target Framework、刪除現有檔案 勾選。
  3. 若用 Web Deploy:伺服器需安裝 Web Deploy 3.6+、開放 8172 埠、建立發布使用者帳號。
  4. 點擊「發布」,VS 自動編譯、轉換 web.config (Release 轉換)、複製至目標。

三、方式 3:虛擬目錄 / 應用程式 (傳統手動建立)

  1. 將專案檔案放置任意路徑 (建議 D:\WebApps\MyApp)。
  2. IIS → 「預設網站」右鍵 → 「加入應用程式」 (而非虛擬目錄,應用程式擁有獨立應用程式集區)。
  3. 設定實體路徑、應用程式集區 (建議每站一池)。
  4. 「基本設定」→「連線身分」→ 選「應用程式使用者 (傳遞驗證)」或指定有讀取權限的自訂帳號。

四、方式 4:資料夾「Web 共享」 (舊版 IIS 6 風格,不建議生產環境)

  1. 資料夾右鍵 → 「屬性」→ 「共用」頁籤 → 「進階共用」→ 勾選「共用此資料夾」。
  2. 「權限」→ 加入 IIS_IUSRS 讀取權限。
  3. IIS 管理員會自動建立虛擬目錄指向此共用路徑。
  4. 缺點:權限管理分散、難以版本控制、不支援 Web Deploy、已淘汰。

五、應用程式集區最佳實踐

設定建議值說明
.NET CLR 版本v4.0 (整合模式)ASP.NET 4.x 必須;Core 選「無受控碼」
受控管線模式整合支援模組管線、URL 重寫、ASP.NET Core 模組
身分識別ApplicationPoolIdentity虛擬帳戶,自動建立、最小權限、無須管理密碼
啟動模式AlwaysRunning配合預載避免冷啟動延遲
閒置逾時0 (停用)避免夜間回收導致首次請求慢
定期回收固定時間 (如 03:00)釋放記憶體碎片,避免長期運行洩漏
CPU 限制視情況設定防止失控進程佔滿資源

六、常見部署後錯誤排查清單

  1. HTTP 500.19 / 500.21:web.config 格式錯誤、缺少模組 (URL Rewrite)、ASP.NET 未註冊 → 執行 aspnet_regiis -i (舊版) 或重新啟用 Windows 功能。
  2. HTTP 403.14:目錄瀏覽被拒、無預設文件 → 「預設文件」加入 index.aspx/default.aspx、或啟用目錄瀏覽 (不建議)。
  3. HTTP 401.3:資料夾 ACL 缺少 IIS_IUSRS/IUSR 讀取權限。
  4. 無法載入檔案或組件:bin 目錄缺 DLL、版本衝突、目標框架不匹配 → 檢查發布輸出、bindingRedirect、copy local=true。
  5. 資料庫連線失敗:連線字串錯誤、防火牆阻擋、SQL Server 遠端連線未啟用、信任連線 vs SQL 驗證不符。
  6. 靜態檔案 404:StaticFile 模組未安裝、web.config <staticContent> 衝突、副檔名 MIME 對應缺失。
  7. 驗證/授權失敗:<authentication mode="Forms"> 設定錯誤、machineKey 叢集不一致、authorization 規則順序錯誤。

七、上線前核對清單 (Checklist)

  • [ ] `debug="false"` 在 ``。
  • [ ] `` 或 ``。
  • [ ] 移除 `trace.axd`、移除測試頁面、關閉目錄瀏覽。
  • [ ] `machineKey` 固定 (叢集必須一致)。
  • [ ] SSL 憑證綁定、HSTS、HTTP→HTTPS 重導向。
  • [ ] 連線字串加密 (`aspnet_regiis -pef connectionStrings`)。
  • [ ] 記錄目錄權限 (寫入權限給 `IIS_IUSRS`)。
  • [ ] 備份/還原腳本、資料庫遷移腳本已驗證。
copyright © 萬盛學電腦網 all rights reserved