萬盛學電腦網

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

NetBox 編譯 ASP 為獨立執行檔:完全擺脫 IIS、跨平台部署指南

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. 測試執行 (未編譯前)

  1. 確保 8080 埠未被佔用 (停止 IIS 或改埠)
  2. 雙擊 `main.box`,系統托盤出現 NetBox 圖示
  3. 瀏覽器開啟 `https://localhost:8080/` 驗證 ASP 正常運作

4. 編譯為獨立執行檔

  1. 執行 NetBox 安裝目錄下的 `nbdw.exe` (NetBox Deploy Wizard)
  2. **Select Folder** → 選擇 `D:\MyAspApp`
  3. **Browse** → 設定輸出檔名 `D:\Output\MyAspApp.exe`
  4. 點擊 **Build...** 開始編譯
  5. 完成後獲得 `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 位相容元件

實戰遷移清單

  1. 盤點所有 `Server.CreateObject` 呼叫,分類為:
    ① 內建 (ADODB、Scripting、MSXML) → 保留
    ② 第三方 COM (ASPUpload、Dundas、自訂 DLL) → 尋找 NetBox 內建替代或純腳本重寫
    ③ .NET 互通 (無支援) → 重寫為 VBScript/JScript 或外部 API 呼叫
  2. 檢查 `global.asa` 事件邏輯,確認無長時間阻塞操作
  3. 資料庫連線字串:確保目標機器安裝相同版本 ODBC/OLEDB 驅動 (32 位)
  4. 測試檔案上傳、郵件發送、圖片處理等關鍵流程
  5. 壓力測試:`wrk -t4 -c100 -d30s https://localhost:8080/` 觀察記憶體/CPU

替代方案對比

方案原理相容性維護狀態推薦度
NetBoxASP 腳本編譯為 EXE + 內建 HTTP ServerASP 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容器化原生 IIS100% 相容支援中⭐⭐⭐⭐ (不想改碼)
結語:NetBox 是 **ASP 3.0 系統「零改碼」快速脫離 IIS 的最佳捷徑**,適合「必須下周上線」、「原團隊已散」、「無預算重寫」的場景。但請視為**過渡方案**,並行規劃 **ASP.NET Core / Node.js / Go** 重寫路線圖,逐步剝離業務邏輯至 API 服務,前端改用 Vue/React/Blazor,最終實現技術棧現代化。
copyright © 萬盛學電腦網 all rights reserved