SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor · 更新于 2026-10-28

单台 VPS 自托管 secrets manager 怎么选?

比较 OpenBao、Infisical、SOPS 配合 age、systemd credentials 与 600 权限环境变量文件,说明单台 VPS 的维护成本、解封风险和凭据泄露边界。

自托管 secrets manager 能做什么,而密码管理器不能做什么

自托管 secrets manager 将凭据提供给进程。密码管理器将凭据提供给人。其他差异都源于这一点。密码管理器由在场且专注的人解锁。secrets manager 则必须在凌晨 03:00、无人醒着时,将数据库密码提供给应用程序。

两者的故障模式不同,而且这种差异很重要。密码管理器处于锁定状态只是不便:重新输入主密码即可。secrets manager 处于密封状态则会导致中断:所有在密封期间重启的服务都无法获取凭据,并会保持停止状态。将 Vaultwarden 作为您自己的密码管理器运行可以很好地解决人的问题。但它无法解决机器的问题,也从未为此设计。如果您同时运行这两类服务,应重点加固其管理员令牌和备份文件,而不是由客户端负责加密的 vault 内容;对 Vaultwarden 进行加固会同时涵盖这两项。

对于一台服务器,实际可行的选项分为两类。OpenBao 和 Infisical 是服务:包含 API、数据库、TLS(传输层安全)、登录步骤,以及一个现在必须持续运行的进程。SOPS 配合 age、systemd credentials 和 Docker secrets 则是文件:静态加密,由已在运行的组件解密,不需要额外监控其他组件。

先直接给出结论。对于只有一台服务器、由一两个人使用的环境,基于文件的选项通常更合适。一个没人能正确解封、也没人轮换凭据的 OpenBao,不如 mode 600 的环境变量文件,因为它增加了一个需要维护的环节,也增加了一个您很可能会错误处理的备份,而且不会带来任何您原本无法手动完成的轮换能力。

mode 600 的环境变量文件是否足够安全?

通常足够。它防范的是同一台主机上的其他用户读取数据库密码。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 组,并且文件未授予任何其他用户权限。这就是完整的安全模型,而且确实有效。

泄露发生在后续步骤。包含 EnvironmentFile= 的 systemd 单元会将这些值复制到进程环境中,而进程环境是可读取的。

[Service]
User=myapp
EnvironmentFile=/etc/myapp/env
ExecStart=/usr/local/bin/myapp
sudo cat /proc/$(pgrep -n myapp)/environ | tr '\0' '\n'

该命令会以明文输出您的密钥,因为 root 和运行该进程的用户都可以读取 /proc/<pid>/environ。将环境变量附加到报告中的崩溃报告工具也能看到相同内容。任何以同一账户运行的工具也一样。因此,让 AI 代理无法访问密钥首先要将密钥移出环境变量。将该文件与专用的低权限服务用户配合使用,确保“运行该进程的用户”不是 root。

使用 age 和 SOPS:将加密密钥提交到 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: age1s3cqcks5genc6ru8chl0hkkd04zmxvczsvdxq99ekffe4gmvjpzsedk23c
sops 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。请在单元中使用 Environment=SOPS_AGE_KEY_FILE=/etc/sops/age.txt 显式设置路径。另一个问题是,编辑 .sops.yaml 不会重新加密已经存在的文件:添加同事的公钥只会影响新文件,因此请对每个现有文件运行 sops updatekeys secrets.enc.yaml。如果您的配置已经通过 Ansible 运行,使用 Ansible Vault 加密相同的值 可以实现相同结果,而无需引入第二个工具。

systemd 凭据:机密不会进入环境变量

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

服务会从 $CREDENTIALS_DIRECTORY 指定的目录中的 db_password 文件读取该值。该值不在环境变量中,因此 /proc/<pid>/environ 不会显示有用信息,明文也不会写入根文件系统。

将单元指向该文件前,先验证文件可以解密:

sudo systemd-creds decrypt /etc/myapp/db_password.cred -

请确认用于加密的密钥,因为这决定备份是否可用。默认的 --with-key=auto 会在找到 TPM2(受信任的平台模块版本 2)芯片且未运行在容器中时使用该芯片;如果 /var/lib/systemd/ 位于持久化介质上,则使用主机密钥。在同时满足这两个条件的机器上,凭据会同时绑定到二者,解密时二者都必须存在。大多数 VPS 实例没有 TPM2。

systemd-analyze has-tpm2

no 表示只使用了主机密钥。该密钥位于 /var/lib/systemd/credential.secret,只有 root 可读取。将 db_password.cred 恢复到没有该文件的新 VPS 后,任何情况下都无法解密。请将 credential.secret 一并复制到同一份备份中,或者将明文保存在仍可访问的位置。如果输出 yes,则凭据还绑定到了该机器的芯片;即使有 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.txt
docker compose exec app cat /run/secrets/db_password
docker compose exec app env | grep -i password

第一个命令会输出 secret。第二个命令只输出 DB_PASSWORD_FILE=/run/secrets/db_password,这正是关键:该值从未写入容器环境,因此不会出现在 docker inspect 的输出中。许多官方镜像已经按这种方式读取 secret,Postgres 镜像也正是通过 POSTGRES_PASSWORD_FILE 读取。

请明确这一机制的边界。在 Swarm mode 之外,任何层都不会加密:./db_password.txt 是主机上的明文文件,唯一的保护措施是文件权限和所有者。请自行设置这两项,因为 Compose 会直接挂载对所有用户可读的文件,且不会报告错误。与直接使用 env_file 这一简便方式相比,完整的权衡说明请参阅Compose 环境文件和 secrets 指南。

运行 OpenBao 和 Vault 的实际成本

OpenBao 是 HashiCorp Vault 的 Linux Foundation 分支,始于 2023 年 HashiCorp 将 Vault 重新授权为 Business Source License 之后。OpenBao 遵循 MPL 2.0 (Mozilla Public License)。我们在 2026 年 10 月 27 日核查时,2026 年 10 月 26 日发布的 2.7.2 版本为最新版本。下文所述内容几乎同样适用于 Vault,因为该分支保留了相同的命令接口。

docker pull docker.io/openbao/openbao

如果您希望通过 apt 管理安装,GitHub 上的每个发布版本都附带了 Debian 和 Ubuntu .deb 软件包。服务器需要一个包含监听器和存储后端的配置文件:

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

默认情况下,该操作会将根密钥拆分为 5 个分片,并需要其中 3 个才能解除密封,这由 -key-shares 和 -key-threshold 标志决定。它会打印出这些分片和初始根令牌。请务必在此时记录这两项内容,因为如果没有分片,任何人都无法解密存储内容。

现在是大多数对比文章都会忽略的部分。重启后的服务器即为已密封的服务器。 OpenBao 仅在内存中保存根密钥,因此重启后,除非有人提供达到阈值数量的分片,否则它无法解密自身的存储。因此,内核更新或内存溢出导致的进程终止,最终都会导致服务器处于密封状态,且应用程序无法登录。

在单人 VPS 上,Shamir 拆分无法提供任何保护,因为所有五个分片最终都会存放在同一个人的同一个密码管理器中。自动解除密封(Auto unseal)将密钥移至受信任的设备或服务;在大型云环境中,这意味着使用托管密钥服务,而在您的 VPS 上,通常意味着将密钥文件存放在与受保护数据相同的磁盘上。这确实降低了安全性,但换取了服务器在重启后能自动恢复的能力。请务必在知情的情况下进行权衡,并记录下您选择了哪种方案。

Infisical:一个 UI、一个数据库以及仍由您掌握的主密钥

Infisical 是一个包含 Web 界面、项目、环境和用户访问控制的密钥管理平台。使用 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

在执行最后一条命令前,请编辑 .env。其中有两个值必须由您设置,且其中一个在设置后绝不能手动更改:

openssl rand -hex 16
openssl rand -base64 32

第一个是 ENCRYPTION_KEY,一个 16 字节的十六进制字符串。它是用于在 PostgreSQL 中加密密钥的密钥,因此丢失它会使完美的数据库备份变成一堆密文,而在运行中的实例上替换该值会导致现有密钥无法解密。如需轮换该密钥,请遵循 Infisical 的文档流程:由服务器控制台生成新密钥,旧密钥在所有实例切换完成并移除之前保持有效。如果您从不移除旧密钥,Infisical 会在默认 7 天保留期后的首次每周清理中自动删除它,因此如果您仍需使用,请在此之前保存旧密钥。第二个是 AUTH_SECRET,一个用于会话的 32 字节 base64 字符串。SITE_URL 必须是您实际访问的绝对 URL(包含协议),否则登录重定向将会失效。

当您真正需要的是人员管理功能时,Infisical 比 OpenBao 更合适:它为小团队提供了 Web 界面和环境隔离,而不是自动过期的数据库凭据。它需要您维护 PostgreSQL、Redis 和 TLS 证书,这些都需要您自行打补丁并备份。

密钥服务停止时,应用重启会发生什么

这个问题决定了密钥服务是否适合部署在单台主机上。文件在网络启动前就可以读取。服务则不行。

重启主机后,应用和 OpenBao 同时启动。应用请求数据库密码时,OpenBao 仍处于 sealed 状态,请求因此失败。如果单元设置了 Restart=,systemd 会持续重启应用,直到人工输入 unseal shares,或者 StartLimitIntervalSec= 和 StartLimitBurst= 设置的启动速率限制触发,停止重试并将服务标记为 failed。如果未设置 Restart=(其默认值为 no),应用会一直处于停止状态。系统没有损坏,但应用也没有运行。

处理这种情况有两种直接的方法。为单元设置启动顺序,并让应用自动重试:使用 After= 确保密钥服务先启动,并设置 Restart=on-failure,将 RestartSec= 设为足够长的时间,避免持续请求 API;同时设置启动速率限制,确保在有人完成 unseal 前不会停止重试。另一种方法是在部署时而不是启动时获取密钥:将密钥写入权限模式为 600 的文件或 systemd credential,使运行中的系统依赖文件,而不是依赖 API。

Token 过期也是同一类问题,只是发生在更长的时间尺度上。OpenBao token 和 lease 都有生存时间,因此长期运行且从不续期的进程可能在与任何部署无关的时间失去访问权限。这种故障之所以难以排查,正是因为当天没有任何配置变化。

备份存储本身

这里的每种方案都有一个密钥,没有该密钥的备份毫无价值。请记录密钥的存放位置。

对于 env 文件,文件本身就是机密,因此备份必须加密。对于 SOPS,加密文件可以存放在任何公开位置,而 ~/.config/sops/age/keys.txt 中的 age 私钥是绝对不能丢失的内容。对于 systemd 凭据,请将 /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 上测试恢复。

审计日志:谁读取了哪个机密

文件不会提供审计记录。权限模式和所有者只能说明谁可能读取该机密,无法说明谁实际读取了它。使用 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 进行哈希,因此可以将已知值与日志进行匹配,而无需让日志包含明文。整数和布尔值会以明文写入,因此数字机密不会受到该哈希保护。

还要注意一个运维陷阱:如果没有任何已启用的审计设备能够记录请求,OpenBao 将不会响应请求;如果设备以阻塞方式失败,请求会一直挂起,直到有人修复问题。/var/log 磁盘已满会按设计导致机密 API 停止服务。请在第一天就为审计日志分配独立空间并配置 logrotate 规则,不要等到第一次中断后再处理。

应运行哪种自托管密钥管理器?

先统计机器数量和人员数量,再做选择。

  1. 一台机器、一名用户:使用由 root 所有、仅服务所属组可读取的环境变量文件(权限为 640,如上所述);或者使用权限为 600 的文件,由 systemd 通过 EnvironmentFile= 为服务读取。需要避免将值放入进程环境时,再添加 systemd 凭据。
  2. 一台机器、两到五名用户,且配置已经存储在 git 中:使用 SOPS 配合 age。为每名用户分配一对密钥,.sops.yaml 列出所有获准解密的公钥。
  3. 多台机器、一个配置仓库,且不需要会过期的凭据:仍使用 SOPS 配合 age,为每台主机配置一个接收者密钥。这样,即使某台主机的密钥被盗,也只能解密该主机的文件。
  4. 多台机器、多个团队确实需要具有有效期的数据库凭据,并且有人会查看审计记录:使用 OpenBao,并在预算中每月安排一小时的运维时间,用于解除密封和执行恢复演练。

这四种情况遵循同一条规则。运行能够满足明确需求的最小方案,因为已停止的密钥管理器与空的密钥管理器无法区分。

FAQ

对于单个 VPS,自托管 secrets manager 是否值得?

通常不值得,前提是您指的是 OpenBao 或 Infisical 之类的服务。在只有一台主机、只有一两名用户的情况下,权限为 mode 600 的环境变量文件或 systemd 加密凭据可以为您提供相同的本地用户隔离保护,而且无需执行解封步骤,也无需维护额外服务。当您拥有多台机器和多名用户,或确实需要凭据在无人手动轮换的情况下自动过期时,secrets service 才开始体现价值。

password manager 和 secrets manager 有什么区别?

password manager 存储由人员输入的凭据,用户在场时手动解锁。secrets manager 将凭据提供给进程,因此必须在 03:00、无人监控的情况下正常工作。两者的区别就在于此:锁定的 password manager 会要求您重新输入主密码,而已封存的 secrets manager 会阻止所有在封存期间重启的服务启动。

OpenBao 在重启后被封存时,我的应用会发生什么?

应用无法获取 secrets,因此会启动失败。如果其单元设置了 Restart=,systemd 会持续重试,直到有人提供解封阈值(默认需要 5 个共享密钥中的 3 个),或者单元启动速率限制停止重试。OpenBao 只将 root key 保存在内存中,因此每次重启都会再次封存。您可以启用自动解封,但在单个 VPS 上,这意味着解封密钥最终会与数据存储在同一块磁盘上;也可以在部署时将 secrets 写入文件,使系统启动不再依赖 API。

可以将 SOPS 加密文件提交到公共仓库吗?

文件中的值已加密,因此没有 age 私钥的人员无法读取。密钥本身未加密:读取者可以看到您持有 STRIPE_SECRET_KEY 和 SMTP_PASSWORD,以及它们各自的变更频率。对于大多数项目而言,这些元数据可以接受,但少数项目可能无法接受。请勿将 age 私钥放入仓库;每次添加或删除接收者时,都应对所有现有文件运行 sops updatekeys。

这篇文章对您有帮助吗?