OpenBao系列文章1-密钥管理别再裸奔了:RKE2 上部署 OpenBao 高可用集群,重启还能自动解封
OpenBao系列文章1-密钥管理别再裸奔了:RKE2 上部署 OpenBao 高可用集群,重启还能自动解封
数据库密码、API Key、证书私钥……你的这些"机密"现在放哪?ConfigMap?环境变量?还是某个人的笔记本?今天用一篇文章,带你在 RKE2 上搭一套 OpenBao 高可用集群,并让它重启后自己解封,再也不用半夜爬起来输密钥。
OpenBao 是什么?

一句话:开源的"企业级密码保险箱"。
它是 HashiCorp Vault 在许可证变更后,由 Linux 基金会主导的开源分支,用法和 Vault 基本一致,协议是真正的开源协议,能放心用。
它能干的事:
- 集中存放密码、Token、证书
- 给每个应用发"临时钥匙",过期自动作废
- 记录谁在什么时候取了什么密钥(审计)
先搞懂两个概念:密封和解封
OpenBao 有个很有意思的设计:启动后默认是"锁上"的(Sealed)。
打个比方:保险箱里的东西,是用一把"主钥匙"加密的。这把主钥匙本身不落盘,没人把它"装上去",保险箱就打不开,谁也读不了数据。"装上主钥匙"这个动作,就叫解封(Unseal)。
默认模式下,初始化时会生成 5 份钥匙碎片,凑够 3 份才能解封。安全是安全了,但有个大麻烦:
Pod 只要重启(节点维护、升级、OOM),就得人工输 3 次密钥。3 个副本就是 9 次。凌晨 3 点出故障,你还得先找齐 3 个人。
所以生产环境基本都会配自动解封(Auto-unseal):让主钥匙由一个"可信的外部来源"托管,OpenBao 启动时自己去取,不用人工参与。
自动解封方案怎么选?
| 方案 | 适合场景 | 说明 |
|---|---|---|
| 云 KMS(AWS/阿里云/GCP 等) | 在公有云上 | 最省心,钥匙交给云厂商 |
| Transit(另一个 OpenBao) | 已有中心化 OpenBao | 要先解决"解封者"本身的解封 |
| Static Key(静态密钥) | 自建机房 / 私有化 RKE2 | 用本地一把密钥自动解封,零外部依赖 |
RKE2 的用户大多是私有化部署,没有云 KMS 可用,所以本文选 Static Key 方案。
⚠️ Static Key 方案的代价:这把密钥你自己负责保管。它丢了且集群也坏了,数据就永远打不开。后面会讲怎么保管。该功能需要较新版本的 OpenBao,安装前请确认你所用版本的文档支持。
我们要搭的架构
- RKE2 集群(3 个 Server/Worker 节点以上更稳妥)
- OpenBao 3 副本,存储用内置 Raft(不用额外装 Consul、etcd)
- 自动解封:密钥放在 K8s Secret 里挂载给 Pod
- Longhorn 或其他存储:给 Raft 提供持久化卷
3 副本的好处:挂 1 个节点,集群照常工作(Raft 需要多数派存活)。
部署准备
检查存储,这是 RKE2 的第一个坑
K3s 自带 local-path 存储,但 RKE2 默认没有 StorageClass。不处理的话,Pod 的 PVC 会一直 Pending。
kubectl get storageclass
如果是空的,先装一个。生产推荐 Longhorn;测试可以用 local-path-provisioner:
kubectl apply -f https://raw.githubusercontent.com/rancher/local-path-provisioner/v0.0.37/deploy/local-path-storage.yaml
kubectl patch storageclass local-path \
-p '{"metadata":{"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'
local-path 的数据绑定在单个节点上,节点坏了数据就没了,仅限测试。生产请用 Longhorn、Ceph 等分布式存储。
生成自动解封密钥
在你自己的电脑上执行:
openssl rand -hex 32 > unseal.key
这就是那把"主钥匙",32 字节随机数。
需要找个其他渠道立刻备份它:
- 存进公司的密码管理器
- 另外离线保存一份(加密U盘、保险柜都行)
- 不要提交 Git,不要发群里
把密钥放进 K8s Secret
kubectl create namespace openbao
kubectl create secret generic openbao-unseal-key \
-n openbao \
--from-file=key=./unseal.key
然后删掉本地明文文件(确认已经备份好之后):
shred -u unseal.key
💡 Secret 默认只是 base64,并不加密。RKE2 支持开启 etcd 的 Secret 加密(
secrets-encryption: true),生产环境建议打开,这样密钥在 etcd 里也是密文。
添加 Helm 仓库
helm repo add openbao https://openbao.github.io/openbao-helm
helm repo update
编写 values.yaml
server:
ha:
enabled: true
replicas: 3
raft:
enabled: true
setNodeId: true
config: |
ui = true
listener "tcp" {
tls_disable = 1
address = "[::]:8200"
cluster_address = "[::]:8201"
}
storage "raft" {
path = "/openbao/data"
retry_join {
leader_api_addr = "http://openbao-0.openbao-internal:8200"
}
retry_join {
leader_api_addr = "http://openbao-1.openbao-internal:8200"
}
retry_join {
leader_api_addr = "http://openbao-2.openbao-internal:8200"
}
}
seal "static" {
current_key_id = "key-2026-10"
current_key = "file:///openbao/userconfig/openbao-unseal-key/key"
}
service_registration "kubernetes" {}
# 把前面创建的 Secret 挂载进 Pod
extraVolumes:
- type: secret
name: openbao-unseal-key
dataStorage:
enabled: true
size: 10Gi
# storageClass: longhorn
ui:
enabled: true
几个关键点,用人话解释:
seal "static":告诉 OpenBao"启动时去这个文件读主钥匙,自己解封"。retry_join:告诉每个节点"集群里还有这几位兄弟,启动后自己去找它们入伙"。有了它,不用再手动执行raft join。extraVolumes:把 Secret 挂到 Pod 的/openbao/userconfig/openbao-unseal-key/目录下,这样配置里的file://路径才能读到。current_key_id:密钥的标识,以后换密钥时用来区分新旧。
配置项细节(比如密钥格式要求)请以你所用版本的官方文档为准,版本更新后可能有调整。
⚠️
tls_disable = 1只适合测试。生产环境请启用 TLS(cert-manager 签发证书),否则节点间和客户端的通信都是明文。
安装
helm install openbao openbao/openbao -n openbao -f values.yaml
kubectl get pods -n openbao -w
你会看到 3 个 Pod 起来了,但状态是 0/1 Ready。别慌,这是因为还没初始化。
初始化(只需要做一次)
kubectl exec -n openbao openbao-0 -- bao operator init \
-recovery-shares=5 -recovery-threshold=3 \
-format=json > init-keys.json
注意这里用的是 recovery(恢复密钥),而不是传统模式的 unseal 密钥。因为解封的活已经交给 Static Key 了,所以这几份碎片的作用变成了"应急用":生成 root token 等敏感操作时需要它们。
init-keys.json 里有 Recovery Keys 和 Root Token,同样要分开保管,别提交 Git。
做完这步,神奇的事情发生了:
kubectl get pods -n openbao
3 个 Pod 全部变成 1/1 Ready,没有任何人工解封动作。openbao-0 读到密钥自动解封,另外两个通过 retry_join 自动加入集群并自动解封。
验证集群
kubectl exec -n openbao openbao-0 -- bao login # 输入 Root Token
kubectl exec -n openbao openbao-0 -- bao operator raft list-peers
kubectl exec -n openbao openbao-0 -- bao status
看到 3 个节点(1 个 leader + 2 个 follower),Sealed 为 false,Seal Type 为 static,就成功了。
见证奇迹:手动"搞破坏"
自动解封到底灵不灵?来做个测试,直接删掉 leader:
kubectl delete pod openbao-0 -n openbao
kubectl get pods -n openbao -w
你会看到:
- 另外两个节点迅速选出新 leader,服务不中断
- 新 Pod 启动后,自己读密钥、自己解封、自己重新加入集群
- 整个过程不需要你敲任何命令
这就是自动解封的价值:节点故障、滚动升级、集群重启,全都不用人管。
访问 UI
RKE2 默认自带 ingress-nginx,可以直接配 Ingress。快速验证用端口转发:
kubectl port-forward -n openbao svc/openbao 8200:8200
浏览器打开 http://localhost:8200,用 Root Token 登录。
踩坑清单
1. PVC 一直 Pending
RKE2 没有默认 StorageClass,回到第 0 步。
2. Pod 启动报找不到密钥文件
检查 Secret 名字、extraVolumes 的 name、current_key 里的路径,三者要对得上。可以进 Pod 确认:
kubectl exec -n openbao openbao-0 -- ls /openbao/userconfig/openbao-unseal-key/
3. 密钥丢了怎么办?
如果集群还活着,可以走密钥轮换流程迁移;如果集群和密钥都没了,数据无法恢复。所以第 1 步的备份不是建议,是必须。
4. 初始化后 root token 要不要一直留着?
不要。配置完成后,创建管理员策略和用户,然后撤销 root token:bao token revoke <root-token>。需要时,用 Recovery Key 可以重新生成。
5. 备份别忘了
自动解封不等于数据安全。定期执行:
bao operator raft snapshot save backup.snap
可以用 CronJob 自动化并上传到对象存储。
最后总结
| 目标 | 做法 |
|---|---|
| 高可用 | 3 副本 + Raft 内置存储 |
| 免手动加入集群 | retry_join |
| 免手动解封 | seal "static" + Secret 挂载 |
| 防数据丢失 | 备份解封密钥 + 定期 Raft 快照 |
| 加强安全 | 启用 TLS、RKE2 Secret 加密、撤销 root token |
整套流程核心就三件事:准备存储、准备密钥、写好配置。剩下的,交给 Raft 和 Helm。

文档信息
- 文章作者:运维技术团队 - Devin
- 发布日期:2026-10-14
- 适用平台:linux
- 参考链接:
https://openbao.org/docs/platform/k8s/helm/examples/ha-with-raft/
https://docs.rke2.io/
下一篇,我们聊聊怎么让业务 Pod 通过 ServiceAccount 自动拿到密钥,以及用 External Secrets Operator 把 OpenBao 的内容同步成 K8s Secret。感兴趣的朋友点个关注,我们下期见。
