將目錄快速轉為靜態網站 - 使用 ASP.NET Minimal API

昨天發現 Python3 有個 http.server 模組，能將包含 .html、.css、.js 的資料夾快速轉成靜態網站，遇到臨時性或簡單的測試需求，相當好用。

好巧不巧，馬上遇到類似的特殊需求：我有一批靜態網站檔案想請別人測試，若從本機開啟網頁時會觸發瀏覽器 Reason: CORS request not HTTP 錯誤，必須跑成網站才會正常。

【網頁豆知識】為何本機檔案會發生 CORS 錯誤 - Reason: CORS request not HTTP
Firefox、Chrome 等瀏覽器，基於安全將本機檔案視為 Opaque Origin (類似 DB null 的概念，具有無法比較的特性，即 null 與 null 也不會相等), 導致載入包含本機資源的本機檔案會觸發 CORS 錯誤。

如何讓非資訊相關使用者用最輕鬆的方法在 Windows 跑本機網站？安裝設定 IIS？裝 Python 敲指令？裝 Web Server for Chrome 套件？

以上對純使用者來說都太複雜，我想到最簡單的方法是提供一個 .exe 放在靜態網站資料夾下，點兩下跑起來，打 X 關掉。既然昨天提到 ASP.NET Core Minimal API 用一行 app.UseFileServer() 就能搞定，今天就來驗證我是不是在吹牛。

dotnet new web 開個 Minimal API 專案，改一下 Program.cs：

using Microsoft.Extensions.FileProviders;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.UseFileServer(new FileServerOptions() {
    FileProvider = new PhysicalFileProvider(
        Directory.GetCurrentDirectory()
    ),
    RequestPath = "",
    EnableDirectoryBrowsing = false   
});

app.Run();

.csproj 加入 PublishSingleFile、RuntimeIdentifier、Configuration、PublishTrimmed 等發佈參數，以產出不需安裝 .NET 6 SDK，複製到 Windows x64 可直接執行的單一瘦身版 .exe 檔：(延伸閱讀：使用 dotnet 命令列工具發行 .NET 6 專案)

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <PublishSingleFile>true</PublishSingleFile>
    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
    <Configuration>Release</Configuration>
    <PublishTrimmed>true</PublishTrimmed>
    <ApplicationIcon>app.ico</ApplicationIcon>
  </PropertyGroup>

</Project>

如此，用指令 dotnet publish 會產生約 36MB 的 dnFileWeb.exe：

將 dnFileWeb.exe 跟 index.html, .png 放在一起，點兩下跳出熟悉的 ASP.NET Core Logger 視窗，開瀏覽器連上 http://localhost:5000 即可檢視網頁內容。

進階使用者若想綁定不同 IP 或不同 Port，則下指令 dnFileWeb --urls http://xxx.xxx.xxx.xx:8000 或使用環境變數設定，做法與 ASP.NET Core 完全相同。(參考：指定 ASP.NET Core Kestrel 接聽 Port)

就醬，我們輕輕鬆鬆便實現跟 Python http.server 一樣方便的功能，.NET 6 的成熟度與完整性真沒讓人失望，讚!

Tutorial of how to create a simple static web server with ASP.NET Core minimal API.