IIS Express 完整配置指南：applicationhost.config 結構解析、多站點/虛擬目錄/SSL/避免管理員權限實戰

為何選擇 IIS Express？

• 輕量 (安裝包 < 5 MB)、無需管理員權限即可啟動/偵錯。
• 支援完整 IIS 7.x 功能：SSL、URL Rewrite、應用程式集區、虛擬目錄、web.config 完整相容。
• 可與完整 IIS、ASP.NET Development Server 共存無衝突。
• 支援 Windows XP 以上所有版本，提供一致開發體驗。

核心配置檔：applicationhost.config

預設位置：%USERPROFILE%\Documents\IISExpress\config\applicationhost.config (位於使用者文件夾，修改無需管理員權限)。

關鍵區段結構

<system.applicationHost>
  <applicationPools>          <!-- 5 內建集區：CLR 2.0/4.0 整合/經典 + 非受控 -->
  <listenerAdapters>          <!-- HTTP/HTTPS 協定適配器 -->
  <sites>                     <!-- 站點定義核心 -->
    <site name="WebSite1" id="1" serverAutoStart="true">
      <application path="/">
        <virtualDirectory path="/" physicalPath="%IIS_SITES_HOME%\WebSite1" />
      </application>
      <bindings>
        <binding protocol="http" bindingInformation=":8080:localhost" />
      </bindings>
    </site>
    <applicationDefaults applicationPool="Clr4IntegratedAppPool" />
    <virtualDirectoryDefaults allowSubDirConfig="true" />
  </sites>
  <webLimits />
</system.applicationHost>

站點 () 四大核心子元素詳解

1. 屬性

• name：站點唯一名稱 (啟動參數 /site:名稱 使用)。
• id：數字 ID (內部識別)。
• serverAutoStart：true 表示 IIS Express 啟動時自動載入 (未指定站點時)；false 僅明確指定時載入。

2. 綁定資訊

• 格式：bindingInformation="IP:PORT:HOSTNAME" (三段式)。
• 範例：*:8080:localhost (所有 IP、8080 埠、主機名 localhost)。
• 關鍵： localhost 限制僅本機回環介面可存取，若需區網存取需改為 *:8080: (主機名留空) 或具體 IP。
• 支援 protocol="https" + SSL 憑證綁定 (需預先 netsh http add sslcert)。

3. 應用程式定義

• 每站點至少一個 path="/" 根應用程式。
• 可新增平行應用程式：<application path="/api" applicationPool="Clr2IntegratedAppPool">...</application>。
• 屬性 applicationPool 指定專用集區 (預設繼承 applicationDefaults)。

4. 虛擬目錄映射

• 每 <application> 至少一個 path="/" 對應實體根目錄。
• 可新增額外虛擬目錄：<virtualDirectory path="/content/" physicalPath="D:\Projects\Content" />。
• allowSubDirConfig="true" 允許子目錄 web.config 覆蓋設定。

VS2010 整合 IIS Express 設定

1. 專案屬性 → Web → 伺服器 → 選 使用本地 IIS Web 伺服器 → 建立虛擬目錄 (或手動編輯 .csproj <UseIISExpress>true</UseIISExpress>)。
2. 專案右鍵 → 「使用 IIS Express...」 (需安裝 VS2010 SP1 + IIS Express 7.5+)。

避免「需要管理員權限」的三種情境

實用命令列參數

• IISExpress.exe /site:MySite：啟動指定站點。
• IISExpress.exe /path:"D:\Projects\MySite" /port:8080 /clr:v4.0：臨時啟動指定路徑站點 (不寫入 config)。
• IISExpress.exe /systray:true：顯示系統匣圖示，右鍵可快速啟停站點。
• IISExpress.exe /config:"D:\Custom\applicationhost.config"：使用自訂配置檔。

常見問題排查

• 無法存取體目錄： 檢查 physicalPath 路徑存在、IIS_IUSRS/當前使用者有讀取權限。
• SSL 憑證錯誤： 執行 netsh http delete sslcert ipport=0.0.0.0:44300 清除舊綁定，重新啟動 VS 讓 IIS Express 重新產生自我簽署憑證。
• 變更 config 不生效： 確認修改的是 %USERPROFILE%\Documents\IISExpress\config\ 下檔案，且已重新啟動 IIS Express (系統匣圖示 → 結束 → VS 重新啟動偵錯)。