NetBox** 是一款將 ASP (VBScript/JScript) 應用程式編譯為原生 Windows 執行檔 (`.exe`) 的工具,內建 HTTP 伺服器 (NetBox HttpServer),可在 **無 IIS、無註冊表、無 COM 元件註冊** 的環境下直接執行,支援 Windows 2000 至 Windows 11/Server 2022。適合舊系統快速容器化、離線部署、免安裝發佈。
快速開始:4 步驟產出 .exe
1. 建立專案目錄結構
D:\MyAspApp\
├── main.box # NetBox 服務進入點
└── wwwroot\ # 原 ASP 網站根目錄 (直接複製過來)
├── default.asp
├── conn.asp
├── style.css
└── images\
2. 編寫 main.box (服務定義)
Dim httpd
' 註冊為 Windows 服務
Shell.Service.RunService "NBWeb", "NetBox Web Server", "My ASP App on NetBox"
'====================== Service Events ======================
Sub OnServiceStart()
Set httpd = CreateObject("NetBox.HttpServer")
' 建立 HTTP 伺服器,監聽所有 IP (空字串) 的 8080 埠
If httpd.Create("", 8080) = 0 Then
Dim host
Set host = httpd.AddHost("", "wwwroot") ' 虛擬主機對應 wwwroot 目錄
host.EnableScript = True ' 啟用 ASP 腳本執行
host.AddDefault "default.asp" ' 預設文件
host.AddDefault "default.htm"
httpd.Start
Else
Shell.Quit 0
End If
End Sub
Sub OnServiceStop()
httpd.Close
End Sub
Sub OnServicePause()
httpd.Stop
End Sub
Sub OnServiceResume()
httpd.Start
End Sub
3. 測試執行 (未編譯前)
- 確保 8080 埠未被佔用 (停止 IIS 或改埠)
- 雙擊 `main.box`,系統托盤出現 NetBox 圖示
- 瀏覽器開啟 `https://localhost:8080/` 驗證 ASP 正常運作
4. 編譯為獨立執行檔
- 執行 NetBox 安裝目錄下的 `nbdw.exe` (NetBox Deploy Wizard)
- **Select Folder** → 選擇 `D:\MyAspApp`
- **Browse** → 設定輸出檔名 `D:\Output\MyAspApp.exe`
- 點擊 **Build...** 開始編譯
- 完成後獲得 `MyAspApp.exe` (約 1-3 MB + 依賴 DLL)
部署與運行
- **直接執行**:雙擊 `MyAspApp.exe` → 托盤圖示 → `https://localhost:8080`
- **安裝為服務** (開機自動啟動、無需登入):
`MyAspApp.exe -install`
服務名稱:`NBWeb` (對應 `RunService` 第一參數)
- **移除服務**:`MyAspApp.exe -remove`
- **命令列參數**:
`-install` 安裝服務
`-remove` 移除服務
`-debug` 前台除錯模式 (輸出到 Console)
關鍵限制與遷移注意事項
| 項目 | NetBox 行為 | 對應調整 |
| Server.CreateObject | 僅支援 **NetBox 內建物件** + **已註冊的 COM 元件** | 移除對 ASPUpload、ASPEmail、CDONTS 等第三方 COM 依賴,改用 NetBox 內建 `NetBox.Mail`、`NetBox.Upload` 或純 VBScript 實作 |
| Server.MapPath | 相對於 `wwwroot` 目錄 | 路徑邏輯不變,但絕對路徑需改相對 |
| Session/Application | 記憶體內進程級,重啟服務即失效 | 無法跨進程共享;需外掛 Redis/資料庫做分散式 Session |
| Global.asa | 支援 `Application_OnStart`、`Session_OnStart` 等事件 | 放在 `wwwroot\global.asa` 即可 |
| 元件註冊 | **免註冊** (Reg-Free COM via Manifest) | 將 COM DLL 放入 `wwwroot\bin\`,NetBox 自動載入 |
| 效能 | 單執行緒事件迴圈 (類似 Node.js) | 高併發場景建議反向代理 Nginx + 多實例負載均衡 |
| 64 位元 | NetBox 為 32 位進程 | 需 32 位 ODBC/OLEDB 驅動;或改用 64 位相容元件 |
實戰遷移清單
- 盤點所有 `Server.CreateObject` 呼叫,分類為:
① 內建 (ADODB、Scripting、MSXML) → 保留
② 第三方 COM (ASPUpload、Dundas、自訂 DLL) → 尋找 NetBox 內建替代或純腳本重寫
③ .NET 互通 (無支援) → 重寫為 VBScript/JScript 或外部 API 呼叫
- 檢查 `global.asa` 事件邏輯,確認無長時間阻塞操作
- 資料庫連線字串:確保目標機器安裝相同版本 ODBC/OLEDB 驅動 (32 位)
- 測試檔案上傳、郵件發送、圖片處理等關鍵流程
- 壓力測試:`wrk -t4 -c100 -d30s https://localhost:8080/` 觀察記憶體/CPU
替代方案對比
| 方案 | 原理 | 相容性 | 維護狀態 | 推薦度 |
| NetBox | ASP 腳本編譯為 EXE + 內建 HTTP Server | ASP 3.0 高 (VBScript/JScript) | 停止更新 (最後版 2010s) | ⭐⭐⭐ (舊系統急救) |
| ASP.NET Core + ASP.NET Core Legacy (Microsoft.AspNetCore.Mvc.ViewFeatures) | 重寫為 Razor Pages / MVC | 語法不同,需人工轉換 | 活躍開發 | ⭐⭐⭐⭐⭐ (長期) |
| Classic ASP on Linux (Apache + mod_asp / Sun ONE) | 舊版 Apache 模組 | 極低、極不穩定 | 已棄用 | ⭐ (不建議) |
| Docker + Windows Server Core + IIS | 容器化原生 IIS | 100% 相容 | 支援中 | ⭐⭐⭐⭐ (不想改碼) |
結語:NetBox 是 **ASP 3.0 系統「零改碼」快速脫離 IIS 的最佳捷徑**,適合「必須下周上線」、「原團隊已散」、「無預算重寫」的場景。但請視為**過渡方案**,並行規劃 **ASP.NET Core / Node.js / Go** 重寫路線圖,逐步剝離業務邏輯至 API 服務,前端改用 Vue/React/Blazor,最終實現技術棧現代化。