v0.7.0

架構

最後更新


HakoRun 的模組層級與一次請求經過的元件。

系統概覽


graph TB
    Main[cmd/api 進入點] --> Checker[checker 相依檢查]
    Main --> DB[database 初始化]
    Main --> Slice[sandbox.NewSlice]
    Main --> Router[internal 路由]
    Client[客戶端] --> Router
    Router --> Handler[handler Upload / Run / RunNow]
    Handler --> Store[(ToriiDB / Redis)]
    Handler --> Sandbox[sandbox.SandboxCommand]
    Sandbox --> Wrapper[internal/resource wrapper]
    Wrapper --> Handler
    Handler --> Client
  1. graph TB
  2. Main[cmd/api 進入點] --> Checker[checker 相依檢查]
  3. Main --> DB[database 初始化]
  4. Main --> Slice[sandbox.NewSlice]
  5. Main --> Router[internal 路由]
  6. Client[客戶端] --> Router
  7. Router --> Handler[handler Upload / Run / RunNow]
  8. Handler --> Store[(ToriiDB / Redis)]
  9. Handler --> Sandbox[sandbox.SandboxCommand]
  10. Sandbox --> Wrapper[internal/resource wrapper]
  11. Wrapper --> Handler
  12. Handler --> Client

分層


層路徑職責
進入點cmd/api/main.go依序執行相依檢查、儲存初始化、建立 slice、啟動 HTTP;處理訊號與 5 秒關閉
路由internal/router.go建立 Gin 引擎,註冊 /upload、/run/*targetPath、/run-now,綁定 HTTP_PORT
Handlerinternal/handler/驗證請求、讀取腳本、選擇一次性或 SSE 執行、標註回應型別
儲存internal/database/backend 介面;建置標籤選擇 ToriiDB 或 Redis
沙箱internal/sandbox/依平台組出 systemd-run + bwrap 或 sandbox-exec 指令;Linux 寫入 hakorun.slice
相依檢查internal/checker/Linux 偵測並安裝執行環境;macOS 為 no-op
Wrapperinternal/resource/各語言從 stdin 讀 {code, input} 並執行使用者程式碼

跨切原則


  • 平台差異以 Go build tag 切分(_linux.go/_darwin.go),不在執行期判斷。
  • 儲存後端以 build tag 切分(!redis/redis),兩者實作同一 backend 介面。
  • 使用者程式碼一律經 stdin 傳入 wrapper,不寫入檔案系統。
  • 每次執行都是新的子行程;不保留暖機行程或狀態。

OpenFaaS、Fn Project 與 fx 將每個函式打包成容器執行;HakoRun 不建置映像檔,每次呼叫都以伺服器子行程的形式在 Bubblewrap(Linux)或 sandbox-exec(macOS)中執行。judge0 與 dify-sandbox 是沙箱化的程式碼執行服務,Orva 是以 nsjail 隔離、執行 Node.js 與 Python 的自架 FaaS;HakoRun 的重點則是以路徑儲存並以時間戳版本化的函式、Python/JavaScript/TypeScript 三種執行環境,以及可選的 SSE 串流輸出。

延伸閱讀


EN