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/s | p99 |
|---|---|---|
| zeroserve | 36,681 | 5.4 ms |
| nginx | 31,226 | 7.8 ms |
| Caddy | 12,830 | 22 ms |
zeroserve 在單核上小檔案比 nginx 快約 17%,且尾延遲更緊。
大靜態檔(100 KB):
| 伺服器 | req/s | 吞吐量 | p99 |
|---|---|---|---|
| zeroserve | 8,000 | 782 MB/s | 22 ms |
| nginx | 7,600 | 773 MB/s | 28 ms |
| Caddy | 6,084 | 590 MB/s | 44 ms |
三者接近,zeroserve 略勝。值得一提的是 nginx 的招牌 sendfile() 在 TLS 場景下其實沒用武之地:byte 反正要在 userspace 加密,所以三個伺服器都被同一個「加密 + 寫入」迴圈綁住,zeroserve 的 io_uring 讀寫路徑在這裡略佔上風。
eBPF vs Lua(nginx + ngx_http_lua_module 對比):
作者做了一件值得尊敬的事——把兩個場景用 Lua 改寫後直接比:
| 引擎 | req/s | p99 |
|---|---|---|
| zeroserve eBPF(10 ms 搶佔) | 43,709 | 5.1 ms |
| zeroserve eBPF(2 ms 預設) | 31,334 | 6.7 ms |
| nginx Lua(header_filter) | 28,653 | 8.4 ms |
預設 2 ms 搶佔粒度是保守的(用來快速 throttle 失控腳本),但這會懲罰乖腳本。把搶佔間隔拉到 10 ms 之後,eBPF 在 middleware 場景比 nginx + LuaJIT 快約 50%,尾延遲也更緊。生產環境建議跑 10 ms。
反向代理小響應(174 B):
| 代理 | req/s | p50 | p99 |
|---|---|---|---|
| zeroserve | 26,486 | 3.3 ms | 8 ms |
| nginx | 21,761 | 4.2 ms | 10.5 ms |
| Caddy | 7,683 | 10.3 ms | 33 ms |
zeroserve 的 pooled io_uring proxy 比 nginx 快約 22%,大約是 Caddy 的 3.4 倍。
不過反向代理大響應時 nginx 翻盤:
| 代理 | req/s | 吞吐量 |
|---|---|---|
| nginx | 5,882 | 585 MB/s |
| Caddy | 4,285 | 406 MB/s |
| zeroserve | 3,631 | 359 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)