自架密鑰管理器怎麼選?OpenBao、Infisical 與檔案方案比較
比較單一 VPS 適用的 OpenBao、Infisical、SOPS 搭配 age、systemd credentials 與 600 權限 env 檔案,說明維護成本、備份風險與適用情境。
自架密鑰管理器與密碼管理器的差異
自架密鑰管理器負責將憑證交付給處理程序,而密碼管理器則是交付給使用者。其餘所有差異皆源於此。密碼管理器由在場且保持專注的人類解鎖;密鑰管理器則必須在凌晨 03:00 無人值守時,將資料庫密碼提供給應用程式。
兩者的故障模式有顯著差異。密碼管理器被鎖定僅造成不便,只需重新輸入主密碼即可;密鑰管理器若處於密封狀態則會導致服務中斷,任何在此期間重啟的服務都會因無法取得憑證而無法運作。以 Vaultwarden 作為個人密碼管理器 能妥善解決人類使用者的需求,但它並非為解決機器自動化需求而設計。若您同時部署此類服務,應加強保護的重點是管理權杖(admin token)與備份檔,而非保險庫內容(客戶端已對其加密)。Vaultwarden 加固指南 涵蓋了上述兩者的防護措施。
單機伺服器的實務選擇可分為兩類。OpenBao 與 Infisical 屬於服務型:包含 API、資料庫、TLS(傳輸層安全性協定)、登入步驟,以及您必須持續維護的背景處理程序。SOPS 搭配 age、systemd credentials 與 Docker secrets 則屬於檔案型:資料在靜態儲存時加密,由已執行的處理程序解密,無需額外監控。
以下是直接的建議:對於僅有一至兩位使用者的單機環境,檔案型方案通常是正確選擇。若部署了 OpenBao 卻無法正確解鎖或執行輪替,其安全性反而不如權限設為 600 的 env 檔案。因為前者增加了維護成本與備份風險,卻未提供任何您原本無法手動完成的輪替功能。
使用 600 權限的 env 檔案是否足夠?
通常足夠。此權限可防範伺服器上的其他使用者讀取您的資料庫密碼。Unix 檔案權限能達成此目的,且在網路啟動前即已生效。
sudo install -d -m 750 -o root -g myapp /etc/myapp
sudo install -m 640 -o root -g myapp /dev/null /etc/myapp/env
sudoedit /etc/myapp/env請從兩方面進行驗證:
sudo -u myapp cat /etc/myapp/env
sudo -u nobody cat /etc/myapp/env第一行指令會印出檔案內容。第二行指令會印出 cat: /etc/myapp/env: Permission denied,因為 nobody 不屬於 myapp 群組,且該檔案未設定任何全域(world)存取位元。這就是完整的安全模型,且確實有效。
洩漏發生在後續步驟。若 systemd 單元設定了 EnvironmentFile=,這些數值會被複製到處理程序的環境變數中,而處理程序的環境變數是可讀的。
[Service]
User=myapp
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/local/bin/myappsudo cat /proc/$(pgrep -n myapp)/environ | tr '\0' '\n'上述指令會以明文印出您的機密資訊,因為 /proc/<pid>/environ 可由 root 以及執行該處理程序的使用者讀取。若崩潰報告程式(crash reporter)將環境變數附加至報告中,也會發生同樣的情況。任何以相同帳號執行的工具亦然,這正是為何 將機密資訊移出 AI 代理 的第一步,就是先將其從環境變數中移除。請將此檔案與 專用的低權限服務使用者 搭配使用,確保「執行該處理程序的使用者」並非 root。
使用 age 搭配 SOPS:將加密的 secret 提交至 git
SOPS(secrets operations)會加密 YAML 或 JSON 檔案中的值,並保留未加密的鍵。age 是精簡的加密工具,提供一組金鑰對,且不需要金鑰伺服器。兩者搭配後,您可以將 secrets.enc.yaml 與程式碼一起提交至 git,而 git diff 仍能告訴您哪項設定有所變更,卻不會透露變更後的內容。
Ubuntu 24.04 已提供 age 套件。SOPS 則未包含在內,因此請從發行頁面取得 .deb。截至 2026 年 10 月,最新版本為 3.13.3。
sudo apt update && sudo apt install -y age
curl -LO https://github.com/getsops/sops/releases/download/v3.13.3/sops_3.13.3_amd64.deb
sudo apt install -y ./sops_3.13.3_amd64.deb
sops --version產生金鑰對。age-keygen 會將私密金鑰寫入檔案,並輸出公開金鑰,因此您會看到以 Public key: age1... 開頭的行。
mkdir -p ~/.config/sops/age
age-keygen -o ~/.config/sops/age/keys.txt
chmod 600 ~/.config/sops/age/keys.txt
age-keygen -y ~/.config/sops/age/keys.txt將公開金鑰放在存放庫根目錄的 .sops.yaml 中,這樣就不必在命令列上記住接收者。
creation_rules:
- age: age1s3cqcks5genc6ru8chl0hkkd04zmxvczsvdxq99ekffe4gmvjpzsedk23csops encrypt secrets.yaml > secrets.enc.yaml
sops decrypt secrets.enc.yaml沒有 path_regex 的規則會比對所有內容,這是初期需要的行為。之後若要新增規則,請讓規則比對傳遞給 sops 的檔案,因為規則是根據輸入路徑檢查,而不是根據您重新導向輸出的檔案檢查。
在執行階段,只將值交給一個程序:
sops exec-env secrets.enc.yaml './myapp'sops exec-env 會在記憶體中解密,並將值設定到子程序的環境中,因此不會將明文寫入磁碟。上一節提到的環境變數限制,同樣適用於該子程序。
這裡有兩個常見問題。使用 systemd 時,錯誤 Failed to get the data key required to decrypt the SOPS file 幾乎總是表示 SOPS 查找了錯誤的 home 目錄,因為 unit 不會繼承您的 HOME。請在 unit 中使用 Environment=SOPS_AGE_KEY_FILE=/etc/sops/age.txt 明確設定路徑。另一方面,編輯 .sops.yaml 不會重新加密已存在的檔案:新增同事的公開金鑰只會影響新檔案,因此請對每個既有檔案執行 sops updatekeys secrets.enc.yaml。如果您的設定已經透過 Ansible 管理,也可以使用 以 Ansible Vault 加密相同的值,達到相同目的而不需再使用另一項工具。
systemd credentials:永不進入環境的機密
Ubuntu 24.04 內建 systemd 255,因此不需要安裝。systemd-creds 會在主機上加密機密,systemd 會將其解密到只有該服務能讀取的私有目錄。
sudo systemd-creds setup
sudo install -d -m 700 /etc/myapp
echo -n 'hunter2' | sudo systemd-creds encrypt --name=db_password - /etc/myapp/db_password.cred[Service]
User=myapp
LoadCredentialEncrypted=db_password:/etc/myapp/db_password.cred
ExecStart=/usr/local/bin/myapp服務會從名為 db_password 的檔案讀取值;該檔案位於 $CREDENTIALS_DIRECTORY 所指定的目錄中。此值不會存在於環境變數,因此 /proc/<pid>/environ 不會顯示有用資訊,明文也不會寫入 root 檔案系統。
在讓 unit 使用該檔案前,先確認檔案可以解密:
sudo systemd-creds decrypt /etc/myapp/db_password.cred -請確認加密時使用的是哪個金鑰,因為這會決定備份是否可用。預設的 --with-key=auto 會在找到 TPM2(trusted platform module version 2)晶片且未在容器中執行時使用該晶片;若 /var/lib/systemd/ 位於持久性媒體上,則會使用主機金鑰。在兩者都適用的機器上,credentials 會同時繫結至兩者,解密時兩者都必須存在。大多數 VPS 執行個體沒有 TPM2。
systemd-analyze has-tpm2no 表示只使用了主機金鑰。該金鑰位於 /var/lib/systemd/credential.secret,只有 root 能讀取。若在沒有該檔案的新 VPS 上還原 db_password.cred,它將永遠無法解密。請將 credential.secret 一併存入相同的備份,或將明文保存在仍可存取的位置。若輸出 yes,表示該 credential 也繫結至該機器的晶片;即使有 credential.secret,也無法在其他位置解密,只有明文副本能派上用場。
Docker secrets:位於 /run/secrets 下的檔案
Compose 會讀取主機上的檔案,並將其掛載至容器內的 /run/secrets/<name>。
services:
app:
image: myapp:latest
environment:
DB_PASSWORD_FILE: /run/secrets/db_password
secrets:
- db_password
secrets:
db_password:
file: ./db_password.txtcat /run/secrets/db_password
docker compose exec app cat /run/secrets/db_password
docker compose exec app env | grep -i passwordenv | grep DB_PASSWORD_FILE=/run/secrets/db_password
第一個指令會印出 secret。第二個指令僅會印出 DB_PASSWORD_FILE=/run/secrets/db_password,這正是重點所在:該值從未出現在容器的環境變數中,因此不會顯示於 docker inspect 的輸出結果。許多官方映像檔已預期此種結構,例如 Postgres 映像檔即是以此方式讀取 POSTGRES_PASSWORD_FILE。
請務必釐清此機制的本質。在 Swarm 模式之外,任何層級皆無加密:./db_password.txt 僅為主機上的純文字檔案,其唯一的保護機制在於檔案權限模式與擁有者。請務必自行設定這兩者,因為 Compose 不會檢查並會直接掛載權限為全域可讀的檔案。關於此機制與簡易 env_file 捷徑之間的權衡取捨,請參閱 Compose 環境變數檔案與 secrets 指南。
執行 OpenBao 與 Vault 的實際成本
OpenBao 是 Linux Foundation 維護的 HashiCorp Vault 分支。HashiCorp 在 2023 年將 Vault 改用 Business Source License 授權後,OpenBao 隨之啟動。OpenBao 仍採用 MPL 2.0(Mozilla Public License)。我們在 27 October 2026 查閱時,26 October 2026 發布的 Release 2.7.2 是最新版本。以下內容幾乎也都適用於 Vault,因為此分支保留了相同的命令介面。
docker pull docker.io/openbao/openbao如果希望使用 apt 管理安裝,GitHub 會將 Debian 和 Ubuntu .deb packages 附加在每個 release 中。伺服器需要一個包含 listener 和 storage backend 的設定檔:
listener "tcp" {
address = "127.0.0.1:8200"
tls_cert_file = "/path/to/full-chain.pem"
tls_key_file = "/path/to/private-key.pem"
}
storage "raft" {
path = "/path/to/raft/data"
node_id = "raft_node_1"
}接著啟動一次:
bao operator init預設設定會將 root key 分割成 5 份,並要求其中 3 份才能解除封存;這兩項設定就是 -key-shares 和 -key-threshold flags。OpenBao 會輸出這些分片和初始 root token。請在當下記錄兩者,因為沒有這些分片就無法解密 storage。
接下來是多數比較文章略過的部分。重新啟動的伺服器會處於封存狀態。 OpenBao 只會將 root key 保存在記憶體中,因此重新啟動後,除非有人提供達到門檻數量的分片,否則它無法解密自己的 storage。因此,kernel 更新或 out of memory kill 最終都會讓伺服器處於封存狀態,應用程式也無法登入。
在單人 VPS 上,Shamir split 不會提供實質保護,因為 5 份分片最後都會存放在同一個人的同一個 password manager 中。Auto unseal 會將 key 移至受信任的裝置或服務。大型 cloud 通常會使用 managed key service;在 VPS 上,通常則是將 key file 放在與受保護資料相同的磁碟上。這確實降低了安全性,換來伺服器在重新開機後能自行恢復。請明確了解這項取捨,並記錄你選擇的方式。
Infisical:你仍持有的 UI、資料庫與 master key
Infisical 是 secrets platform,提供 web interface、projects、environments 及 per user access control。使用 Compose 自行託管的步驟很短:
curl -o docker-compose.prod.yml https://raw.githubusercontent.com/Infisical/infisical/main/docker-compose.prod.yml
curl -o .env https://raw.githubusercontent.com/Infisical/infisical/main/.env.example
docker compose -f docker-compose.prod.yml up -d在執行最後一個 command 前,先編輯 .env。其中兩個值必須使用你自己的值,而且這兩個值中的一個之後絕對不能手動變更:
openssl rand -hex 16
openssl rand -base64 32第一個是 ENCRYPTION_KEY,長度為 16 byte 的 hex string。這是 PostgreSQL 內用來加密 secrets 的 key。因此,遺失這個 key,完整的 database backup 也只會變成一堆 ciphertext;在執行中的 instance 換成你自行指定的值,則會使既有 secrets 無法解密。若要輪替,請改為遵循 Infisical 的文件化程序:server console 會產生新的 key,舊 key 會持續有效,直到所有 instance 都切換完成,且你將其移除為止。若你始終不移除舊 key,Infisical 會在 retention period 預設為 7 days 後的第一次每週清理時自行刪除它。因此,如果之後仍需要舊 key,請在那之前儲存它。第二個是 AUTH_SECRET,用於 sessions 的 32 byte base64 string。SITE_URL 必須是你實際會連線到的 absolute URL,且必須包含 protocol,否則 login redirect 會失效。
如果你實際需要的是人員使用的功能,Infisical 會比 OpenBao 更適合:它提供小型團隊使用的 web interface,以及環境之間的隔離,而不是自行到期的 database credentials。代價是必須使用 PostgreSQL、Redis 和 TLS certificate,而這些元件現在都需要由你負責 patch 與 backup。
當 secrets service 停止且應用程式重新啟動時會發生什麼事
這個問題能決定 secrets service 是否適合放在單一主機上。檔案可以在網路啟動前讀取。服務則不行。
重新啟動主機後,應用程式與 OpenBao 會在同一時間啟動。應用程式要求取得資料庫密碼時,OpenBao 仍處於 sealed 狀態,因此請求失敗。如果 unit 設定了 Restart=,systemd 會持續重新啟動應用程式,直到有人手動輸入 unseal shares,或是由 StartLimitIntervalSec= 與 StartLimitBurst= 設定的啟動速率限制中止重試,並將服務標記為 failed。如果未設定 Restart=,而其預設值為 no,服務就會保持停止狀態。沒有任何元件損壞,但也沒有任何服務在運作。
有兩種可行的處理方式。先排序各 unit,讓應用程式自行重試:使用 After= 依賴 secrets service,並設定 Restart=on-failure,以及足夠長的 RestartSec=,避免持續對 API 發送請求;同時設定不會在有人完成 unseal 前放棄的啟動速率限制。另一種方式是在部署時取得 secret,而不是在開機時取得:將 secret 寫入 mode 600 的檔案或 systemd credential,讓執行中的系統依賴檔案,而不是依賴 API。
Token 過期是相同問題,只是發生在較慢的時間尺度上。OpenBao token 與 lease 都有存留時間,因此不會自動續期的長時間執行程序,可能在與任何部署無關的時間點失去存取權限。這類故障特別令人困惑,正因為當天沒有任何變更。
備份儲存區本身
這裡的每個選項都有一組金鑰,沒有該金鑰的備份毫無價值。請記下金鑰的存放位置。
對於 env 檔案,檔案本身就是秘密,因此備份必須加密。使用 SOPS 時,加密檔案可以放在任何公開位置;位於 ~/.config/sops/age/keys.txt 的 age 私密金鑰才是絕對不能遺失的項目。使用 systemd credentials 時,請將 /var/lib/systemd/credential.secret 與 .cred 檔案一併備份。使用 Infisical 時,請建立 PostgreSQL 傾印,並將 ENCRYPTION_KEY 儲存在與傾印分開的位置。輪替金鑰後,請將舊金鑰與輪替前建立的任何傾印一併保存,因為還原該傾印需要舊金鑰。
使用 raft 儲存的 OpenBao 有專用的快照命令:
bao operator raft snapshot save backup.snap
bao operator raft snapshot restore backup.snap快照包含加密的儲存資料,因此將快照還原至全新的伺服器時,仍需要 bao operator init 中的解封存分片。若夜間工作會將快照複製到物件儲存,卻未在任何地方保存這些分片,這等同於沒有備份。正式依賴前,請先在用完即丟的 VPS 上測試還原。
稽核日誌:誰讀取了哪個 secret
檔案無法提供稽核軌跡。檔案模式與擁有者只能表示誰可能讀取 secret,無法表示實際讀取者。搭配監看該路徑的 auditd 是最接近的替代方案,但它只能回報檔案曾被開啟,無法指出實際使用了哪個值。
OpenBao 會將每個請求記錄到明確啟用的稽核裝置。自 2.3.2 起,透過 API 建立稽核裝置(bao audit enable 正是如此)時,只有在伺服器設定中設為 unsafe_allow_api_audit_creation = true 才能運作,而此選項預設為關閉。請改在伺服器設定中、listener 旁宣告該裝置。OpenBao 會在重新啟動時或執行 SIGHUP 時啟用它:
audit "file" "local" {
description = "Local audit log"
options {
file_path = "/var/log/openbao_audit.log"
}
}這項日誌設定會影響伺服器的執行方式,原因有二。請求與回應中的大多數字串都會使用 HMAC-SHA256 與 salt 進行雜湊,因此可以將已知的值與日誌比對,而不必讓日誌本身包含明文。整數與布林值會以明文寫入,因此數值型 secret 不會受到這項雜湊機制保護。
接著是操作上的陷阱:如果沒有任何已啟用的稽核裝置能記錄請求,OpenBao 就不會回應請求;若裝置以阻塞方式失效,請求會持續掛起,直到有人修復問題。/var/log 磁碟空間用盡,會按照設計使 secrets API 停止運作。請在第一天就為稽核日誌配置獨立空間及 logrotate 規則,不要等到第一次中斷服務後才處理。
應該執行哪一種自架 secrets manager?
先統計機器數量與人員數量,再據此選擇。
- 1 台機器、1 位使用者:使用由 root 擁有、僅服務所屬群組可讀取的環境變數檔(mode 640,如上所述),或使用 mode 600 的檔案,讓 systemd 透過
EnvironmentFile=為服務讀取。若不希望值出現在程序環境中,請加入 systemd credentials。 - 1 台機器、2 到 5 位使用者,且設定已存在 git:使用 SOPS 搭配 age。每位使用者各自取得一組金鑰對,並由
.sops.yaml列出所有獲准解密的公開金鑰。 - 多台機器、1 個設定儲存庫,且不需要會過期的 credentials:仍使用 SOPS 搭配 age,為每台主機設定 1 個 recipient key。如此一來,即使主機金鑰遭竊,也只能解密該主機的檔案。
- 多台機器、數個團隊確實需要具有效期限的資料庫 credentials,且有人會查看稽核記錄:使用 OpenBao,並在預算中每月安排 1 小時的操作時間,用於解除封存與還原演練。
以上 4 種情境遵循相同原則。執行能滿足明確需求的最小方案,因為停止運作的 secrets manager,和內容為空的 secrets manager 沒有可區分之處。
FAQ
對單一 VPS 而言,自行代管 secrets manager 是否值得?
通常不值得,若你指的是 OpenBao 或 Infisical 這類服務。在只有一台主機、由 1 或 2 人使用的情況下,權限設為 mode 600 的環境變數檔案,或 systemd 的加密認證資料,對防止其他本機使用者存取已提供相同保護,而且不需要解封步驟,也不必額外修補另一項服務。當你開始管理數台機器、由數人共同操作,或確實需要讓認證資料自動過期而不必由任何人手動輪替時,secrets service 才開始具有實際效益。
password manager 與 secrets manager 有何不同?
password manager 儲存由人員輸入的認證資料,並由人在場時解鎖。secrets manager 則將認證資料提供給程序,因此必須在 03:00、無人監看時仍能運作。兩者的差異就在於此:鎖定的 password manager 會要求你重新輸入主密碼;已封存的 secrets manager 則會停止所有在封存期間重新啟動的服務。
重新開機後若 OpenBao 已封存,我的應用程式會怎樣?
它們無法取得 secrets,因此會啟動失敗。若其 unit 設定了 Restart=,systemd 會持續重試,直到有人提供解封所需的門檻值;預設為 5 份 share 中的 3 份,或直到 unit 的啟動速率限制停止重試。OpenBao 只會將 root key 保存在記憶體中,因此每次重新啟動都會再次封存。你可以啟用 auto unseal,但必須接受在單一 VPS 上,解封金鑰最終會與資料位於同一個磁碟;或者在部署時將 secrets 寫入檔案,讓開機不再依賴 API。
我可以將 SOPS 加密檔案提交至公開 repository 嗎?
檔案內容已加密,因此沒有 age private key 的人無法取得其中值。金鑰並未加密:讀者可以看出你持有 STRIPE_SECRET_KEY 與 SMTP_PASSWORD,也能知道兩者變更的頻率。對大多數專案而言,這些 metadata 可以接受;但少數專案可能無法接受。請勿將 age private key 放入 repository;每當新增或移除 recipient 時,請對所有現有檔案執行 sops updatekeys。