zophos

← Notes · 24-「存進 OS keyring」的隱藏重量.md

「存進 OS keyring」的隱藏重量

把秘密「好好地」存進作業系統的鑰匙圈,聽起來是顯然正確的選擇。但在 Linux 上,那個「標準」後端會拖來將近七十個傳遞依賴——一整套非同步 D-Bus,外加一套加密——而且還需要一個你機器上不一定有的常駐程式。換一個更輕的後端(核心 keyutils),反而又小又免常駐。一個「安全又標準」的選擇,成本常不在那個函式庫本身,而在它為了達成目標拖進來的那條你沒看見的長尾。

場景:一個本機跑的 agent,原本每次開機都叫使用者互動輸入 API key、不存檔。現在想「輸入一次、之後重用」——那把 key 要放哪裡?

明文檔(就算權限鎖成只有你能讀)把秘密攤在磁碟上。顯然「正確」的答案是作業系統的鑰匙圈:系統代管、加密落盤、有既成的函式庫。於是你加一行依賴,選它。

然後 lock 檔多了快七十個 package。


拆開那七十個

這些依賴幾乎不是鑰匙圈函式庫本身,而是它在 Linux 上的後端。Linux 的標準秘密儲存叫 Secret Service,走 D-Bus,於是:

  • 一整套非同步 D-Bus 實作(連同它自帶的、跟你主程式不同的那一套非同步執行環境)。
  • 一套加密,用來把 D-Bus session 加密:對稱加密、雜湊、還有做金鑰交換的大整數運算。
  • 一堆為這些而來的巨集、建置期工具。

換句話說,那七十個依賴 ≈「在 Linux 上用 OS keyring」的代價,不是這個抽象本身大。你以為加的是「一個存秘密的函式庫」,實際拉進來的是「一個 D-Bus 客戶端 + 一套加密協定」。


還有個諷刺:它需要一個常駐程式

這個最重的後端,runtime 還需要一個鑰匙圈常駐程式在背景跑(桌面環境通常有,精簡的容器、WSL、無頭機器通常沒有)。

於是最糟的組合成立了:你付了七十個依賴的編譯重量,runtime 還不保證能用——因為機器上根本沒有那個 daemon。


換一個後端:核心 keyutils

同一個鑰匙圈抽象,通常容許你挑後端。Linux 上還有一個選項:核心提供的 keyutils——秘密存在 kernel 管的鑰匙圈裡,透過幾個 syscall 存取。沒有 D-Bus、沒有加密握手、沒有常駐程式。

換上去之後,上面那一大坨(D-Bus + 加密 + 大整數 + 多一套非同步執行環境)整串消失,剩下三四個。而且因為走 kernel、不需要 daemon,它反而在那些精簡環境裡更可能真的能用。

代價要誠實講:keyutils 的 key 在核心記憶體裡、同一個使用者的行程讀得到、而且 persistent 鑰匙圈有逾時語意。它的安全性介於「加密常駐」和「明文檔」之間——存一把開發用的 token 綽綽有餘,但不是給你存公司金庫的。

用了一陣子之後,還有兩個代價是實際碰到才看清的:

  • 重開機就沒了。 key 只活在核心記憶體裡:重開機、或在 WSL 上 wsl --shutdown,存過的 key 全部消失,一陣子沒用也會過期。設定檔裡還記得你有哪些 provider,但 key 不在了。Zophos 現在會直接說「沒有存 key,Linux 的鑰匙圈重開機會清空」,讓你用 /provider 再輸入一次;一開始只說「沒有設定 provider」,使用者看不出原因。
  • 容器裡不能用。 Docker 預設的安全設定會擋掉存取核心鑰匙圈的系統呼叫(因為核心鑰匙圈沒有依容器隔離)。所以在預設的容器裡,key 根本存不進去。Zophos 遇到這種情況會照常啟動、只是沒有接上 provider,並在畫面上說明鑰匙圈讀不到;一開始是直接啟動失敗。

所以「免 daemon、在精簡環境更能用」只說對了一半:它不需要常駐程式,但它的「精簡環境」不包括預設的容器,而且它換來的是一個每次重開機都要重新輸入的流程。


教訓

重點不是「keyring 不好」或「keyutils 比較好」。重點是那個反射動作:聽到「存秘密」就伸手去拿「標準、安全」的那個選項,而沒看它帶進來什麼。

  • 一個選擇的成本,常不在那個 crate 本身,而在它為了達成目標拖進來的傳遞依賴長尾。
  • 這是可量的:lock 檔會告訴你真相。接受一個依賴之前,看一眼它實際多了幾個 package,不要只看你加的那一行。
  • 而且「更輕」有時同時更合身,不是妥協:這裡 keyutils 又小、又免 daemon。但更輕的選項也有它自己的代價(重開機清空、容器裡不能用),一樣要量清楚、寫明白。選輕的不是選最弱的方案,是接受一個依賴前先量清楚,然後常常發現那個龐然大物你根本用不到。

(附帶一條一致性:既然 key 是互動輸入、刻意不落檔的,就別又把它塞進一個 .env 之類的檔案——那等於把同一個秘密以明文寫回磁碟,和當初的立場相反。秘密要嘛在記憶體、要嘛在鑰匙圈,別在一個會被 commit 進倉庫的檔案裡。)


總結

  1. 「存進 OS keyring」在 Linux 上不是免費的。 標準後端(Secret Service)走 D-Bus,拖來一整套非同步 D-Bus + 加密,近七十個傳遞依賴——那是「用 OS keyring」的代價,不是抽象本身大。

  2. 它還需要一個常駐程式,精簡環境常常沒有:你付了重量,runtime 還不保證能用。

  3. 換核心 keyutils:同一個抽象、更輕的後端,D-Bus 與加密整串消失,剩三四個,而且免 daemon。代價是安全模型較弱(存 dev token 夠用)、重開機就清空、預設的 Docker 容器裡不能用——後兩個要在使用者碰到時說清楚原因,而不是讓程式啟動失敗或只說「沒有設定」。

  4. 一個依賴的成本在它的長尾,而長尾可量。 加一行之前看 lock 檔;「安全又標準」的反射選擇,常背著你沒看見的重量,而更輕的選項有時同時更合身。