v0.7.0

沙箱

最後更新


HakoRun 每次執行都把 runtime 包進作業系統原生的沙箱:Linux 用 Bubblewrap,macOS 用 seatbelt。

Linux:systemd-run + bwrap


指令由 internal/sandbox/command_linux.go 組成:systemd-run --scope --user --quiet --slice=hakorun.slice -- bwrap ... -- <runtime> /wrapper.<ext>。
面向設定
命名空間--unshare-all、--unshare-net(無網路)
權限--cap-drop ALL、--new-session、--die-with-parent
檔案系統唯讀掛載 /usr、/lib、/lib64 與 wrapper;/tmp、/home/sandbox 為 tmpfs;/proc、/dev 為新實例
工作目錄/tmp
環境變數HOME=/home/sandbox、PATH=/usr/local/bin:/usr/bin:/bin、TMPDIR=/tmp、LANG=C.UTF-8;移除 LD_PRELOAD、LD_LIBRARY_PATH
TypeScript 額外唯讀掛載專案根目錄,NODE_PATH 指向其 node_modules

因為只掛載 /usr,全域 tsx 必須安裝在 /usr 底下(npm 預設 prefix /usr/local 即可);系統缺 /lib64 時 bwrap 無法啟動。

macOS:sandbox-exec


指令為 sandbox-exec -p <profile> <runtime> <wrapper>,profile 由 seatbeltProfile() 產生:
  1. (version 1)
  2. (deny default)
  3. (allow process-exec)
  4. (allow process-fork)
  5. (allow sysctl-read)
  6. (allow mach-lookup)
  7. (allow signal)
  8. (allow ipc-posix*)
  9. (allow file-read*)
  10. (allow file-write* (subpath "<HOME>"))
  11. (allow network*)

兩平台對照


面向LinuxmacOS
網路停用允許
寫入僅 tmpfs僅 $HOME
讀取僅掛載路徑全域
資源上限hakorun.slice無
環境變數重設繼承伺服器

macOS 沙箱的邊界明顯較寬,適合開發;對外提供服務請部署在 Linux。

相關頁面


EN