← 返回 Siami 首頁

Zeroserve:可用 eBPF 寫腳本的零設定網頁伺服器,速度還贏過 nginx

▲ 150 💬 39
Zeroserve:可用 eBPF 寫腳本的零設定網頁伺服器,速度還贏過 nginx

Zeroserve:可用 eBPF 寫腳本的零設定網頁伺服器,速度還贏過 nginx

原文:https://su3.io/posts/introducing-zeroserve(作者 Heyang Zhou,2026-06-06 發表,聲明本文由 GPT-5.5 與 Claude Opus 4.8 共同撰寫)

如果你曾經用 nginx 或 Caddy 架過網站,一定經歷過這種痛苦:先寫一段宣告式設定檔(location 區塊、rewrite 規則、map 指令、try_files),當設定語言碰到極限就外掛一個腳本執行環境(Lua、Caddy plugin),結果一個請求的行為被切成兩層互相搶著控制的邏輯。Heyang Zhou 推出的開源專案 zeroserve 試圖把這兩層合而為一:用一個 eBPF 程式取代整個設定檔,這支腳本決定每個請求的命運——路由、標頭、認證、限流、反向代理,全部一支程式搞定。

三大設計亮點

一、一個 tarball 撐起整個網站

zeroserve 不是「把網站解開放在某個 document root」這種老派做法,而是把整個靜態網站打包成單一 tar 檔,伺服器啟動時建立「路徑 → 位元組範圍」索引,之後用 byte-range read 直接從 tar 裡撈檔案,連解開到硬碟都不用。部署新版只要換掉 tarball 再送 SIGHUP,整個 hot-reload 在同一行程式內原子完成,新 TLS 憑證、新網站、新腳本一次到位,且不會有任何連線掉包。包裝指令超直覺:

zeroserve --pack ./public site.tar
zeroserve --addr 0.0.0.0:8080 site.tar

二、eBPF 腳本作為設定檔(重點中的重點)

zeroserve/scripts/ 目錄下任何 .c 檔都會在打包時被 clang + llc 編譯成 eBPF bytecode,zeroserve 載入這段 bytecode 到 userspace 的 async-ebpf runtime(它內含 uBPF)並 JIT 編譯成原生機器碼。這代表你的「設定」實際上是以原生 x86-64 速度執行——而且完全在一般使用者行程內運行,完全不碰核心的 BPF 子系統、不需要 CAP_BPF。一套指標籠(pointer cage)取代了核心 verifier 的角色,所有記憶體存取都被遮罩在腳本自己的 arena 內,越界存取頂多打到自己。

腳本之間的關係是一條鏈,依檔名排序執行、共享 per-request metadata map。如果某一支呼叫 zs_respond 或 zs_reverse_proxy,鏈就提前短路。這樣的好處是:你可以讓一支腳本只負責塞 response header,另一支處理認證,再一支做限流——各自獨立、各自沙箱化。

zeroserve 的腳本 API 相當完整,覆蓋了大多數你想得到的場景:

  • 請求檢查與改寫:讀 method、路徑、query、headers、peer 位址;改寫 URI 或增刪回應標頭
  • 加密與編碼:SHA-256、HMAC-SHA256、base64、hex、getrandom
  • JSON:解析請求 body、建構與修改文件樹、用 zs_json_respond 回應
  • 限流:per-key token bucket,可以依 peer IP、API key 等任意維度分桶,狀態在 hot-reload 之間還能存活
  • AWS SigV4:簽章 Authorization 標頭與 presigned URL,可以直接跟 S3 對接
  • OIDC 登入:完整的依賴方流程(Authorization Code + PKCE),整個登入 session 用 XChaCha20-Poly1305 密封 cookie 攜帶,伺服器本身保持無狀態——意思是你可以「請用 Google 登入」守住一個純靜態網站

最妙的是動態 endpoint 寫起來跟寫個 hello world 一樣簡單:

ZS_ENTRY zs_u64 entry(void) {
  char path[64];
  zs_req_path(path, sizeof(path));
  if (zs_strcmp(path, "/health") != 0) return 0;
  zs_meta_set(ZS_STR("zs.response.header.content-type"), ZS_STR("application/json"));
  zs_respond(200, ZS_STR("{\"status\":\"ok\"}\n"));
  return 0;
}

每支腳本有 256 KB 記憶體上限(可調),執行環境有搶佔計時器,一支腳本卡住只會卡住自己那一個請求,不會拖死整個事件迴圈。

三、現代 TLS 開箱即用

雖然主打「零設定」,底層的 TLS 故事其實比包裝出來看更完整:只支援 TLS 1.3、由 BoringSSL 處理終止、原生 Encrypted Client Hello(真實 SNI 從不出現於明文)、支援從目錄自動選 SNI 憑證、暴露 JA4 client fingerprint 給腳本、還有透明的 ECH relay 模式——無法解密的 handshake 會逐字節轉給真正的上游,讓「受保護的名稱」與「公開名稱」自然混在同樣的流量中。

效能實測

作者在 8 核 Ryzen 7 3700X 上用 wrk -t4 -c100 對 zeroserve、nginx 1.26、Caddy 2.11 做 HTTPS 比較,所有伺服器都 taskset 釘在單一 CPU 上,nginx 強制 worker_processes 1、Caddy 強制 GOMAXPROCS=1,每個項目跑三次取中位數。wrk 是 HTTP/1.1,所以這是 HTTP/1.3 over TLS 1.3 的穩態數字(keep-alive 已建立、handshake 攤提過)。

小靜態檔(174 bytes)—— 靜態站最常見的場景:

伺服器req/sp99
zeroserve36,6815.4 ms
nginx31,2267.8 ms
Caddy12,83022 ms

zeroserve 在單核上小檔案比 nginx 快約 17%,且尾延遲更緊。

大靜態檔(100 KB):

伺服器req/s吞吐量p99
zeroserve8,000782 MB/s22 ms
nginx7,600773 MB/s28 ms
Caddy6,084590 MB/s44 ms

三者接近,zeroserve 略勝。值得一提的是 nginx 的招牌 sendfile() 在 TLS 場景下其實沒用武之地:byte 反正要在 userspace 加密,所以三個伺服器都被同一個「加密 + 寫入」迴圈綁住,zeroserve 的 io_uring 讀寫路徑在這裡略佔上風。

eBPF vs Lua(nginx + ngx_http_lua_module 對比):

作者做了一件值得尊敬的事——把兩個場景用 Lua 改寫後直接比:

引擎req/sp99
zeroserve eBPF(10 ms 搶佔)43,7095.1 ms
zeroserve eBPF(2 ms 預設)31,3346.7 ms
nginx Lua(header_filter)28,6538.4 ms

預設 2 ms 搶佔粒度是保守的(用來快速 throttle 失控腳本),但這會懲罰乖腳本。把搶佔間隔拉到 10 ms 之後,eBPF 在 middleware 場景比 nginx + LuaJIT 快約 50%,尾延遲也更緊。生產環境建議跑 10 ms。

反向代理小響應(174 B):

代理req/sp50p99
zeroserve26,4863.3 ms8 ms
nginx21,7614.2 ms10.5 ms
Caddy7,68310.3 ms33 ms

zeroserve 的 pooled io_uring proxy 比 nginx 快約 22%,大約是 Caddy 的 3.4 倍。

不過反向代理大響應時 nginx 翻盤:

代理req/s吞吐量
nginx5,882585 MB/s
Caddy4,285406 MB/s
zeroserve3,631359 MB/s

一旦代理的 body 變大,nginx 的緩衝機制開始佔便宜。所以作者結論很務實:代理小而多的請求,zeroserve 較快;代理大檔案,nginx 還是首選。

記憶體與多程序

閒置時單一 zeroserve 行程約 15 MB PSS,比 nginx 的 6 MB 多、比 Caddy 的 60 MB 少。但有意義的是多程序時:當你一個核心跑一份 zeroserve,這些行程共享同一份 binary 的程式頁,新增一份行程多花的記憶體只有自己的 working set。zeroserve 內部所有 I/O 都走 io_uring(透過 monoio runtime),每個行程是單執行緒事件迴圈。

這個專案適合誰?

如果你架的網站是「小而多」的靜態資源、API gateway、需要 hot-reload 又不想停機、腳本邏輯比純路由複雜但又不到需要獨立應用伺服器的程度,zeroserve 的「一支 eBPF 程式搞定一切」模型會非常順手。OIDC 登入保護靜態網站、AWS SigV4 簽 S3、per-IP 限流——這些都是寫幾十行 C 就能搞定的功能,不需要再拉一個 Node 應用。

反過來,如果你的工作負載是大檔案 proxy(例如影音、大檔下載),nginx 的緩衝模型仍勝出,作者自己也承認這一點。zeroserve 不是要消滅 nginx,是要成為「小檔案 + 邏輯複雜」這個甜蜜點的更好選項。

專案開源在 GitHub,倉庫是 losfair/zeroserve——有興趣的開發者可以抓下來跟自家的 nginx fleet 對照打一輪。

網友熱門留言 (5)

#1 Hacker News ▲ 87
Finally, someone collapses config + scripting into one program. nginx with LuaJIT always felt like two layers fighting each other.
#2 Hacker News ▲ 64
io_uring + eBPF in userspace, JIT'd to native code. The author clearly knows their systems programming. Excited to benchmark this against our edge fleet.
#3 Hacker News ▲ 52
Hot-reload a 50MB tarball atomically with SIGHUP and no dropped connections? That's the killer feature for me. nginx reload still has that brief moment of pain.
#4 Hacker News ▲ 41
Single-threaded per process scaling is the right call. We run 64 nginx workers per box; this model is cleaner and shares binary pages anyway.
#5 Hacker News ▲ 33
Trailing nginx on large body proxying is expected without kernel TLS. Still impressive that small/JSON proxying wins. Different tool for different job.