别再用 base64 -d 拆 Secret 了:kubectl-view-secret 实战
技术教程 · K8s · 安全与权限 · 2026-11-11
别再用 base64 -d 拆 Secret 了:kubectl-view-secret 实战
上个月排查一个 Helm 发布回滚的问题,我在一个生产集群里连着敲了六七遍同一条管道:
kubectl get secret sh.helm.release.v1.myapp.v3 -n prod \
-o jsonpath='{.data.release}' | base64 -d | base64 -d | gunzip | jq .
敲到第四遍的时候我停了一下。这个动作我从 2019 年做到现在,中间换过四家公司、七八个集群,管道一个字都没变过。而且它还只是个特例——大多数 Secret 只需要一层 base64 -d,Helm 的要两层加 gunzip,dockerconfigjson 解出来还得再格式化一遍才看得懂。每次都得想一下"这个类型要解几层"。
后来我把这个重复劳动压缩成了一行命令,用的是 kubectl-view-secret——一个 2019 年就存在、但一直被低估的 kubectl 插件。它刚在 2026 年 11 月 9 日发布了 v0.17.0,改动里有一半是在修交互和边界问题,值得重新拿出来讲一遍。
它是什么,以及它不是什么
一句话:它按 Secret 的 type 字段选择解码方式,而不是无脑 base64。
这听起来平平无奇,但正是它和 base64 -d 的根本区别。Kubernetes 的 Secret 类型不止一种,每种背后的编码约定都不一样:
| 类型 | 实际编码 |
|---|---|
| Opaque | base64 一层 |
| kubernetes.io/tls | base64 一层,内容是 PEM |
| kubernetes.io/dockerconfigjson | base64 一层,内容是 JSON |
| kubernetes.io/ssh-auth | base64 一层 |
| helm.sh/release.v1 | base64 两层 + gzip |
view-secret 内部维护了这张表,看到 type 就知道该走哪条路。Helm 那条路它会自动做双层解码再 gunzip,而且 v0.17.0 给它加了个 64MB 的解压上限(maxHelmReleaseSize)——这是个安全修复,防止一个精心构造的 Secret 解压出个几 GB 把内存吃光。这种细节说明维护者是按生产环境在写,不是按 demo。
它不是密钥管理系统。它不加密、不解密 SealedSecret、不碰 Vault。它做的事只有一件:把已经在你集群里、你本来就有权限读的东西,用人能看的方式打出来。
能力一:一次调用拿到人能读的值
最常用的三种形态:
# 只看有哪些 key,不解码(相当于 kubectl describe secret 但更干净)
kubectl view-secret myapp-config
# 解某个具体的 key
kubectl view-secret myapp-config DATABASE_URL
# 全解
kubectl view-secret myapp-config -a
-a 的输出格式是 key='value',多 key 时每行一个。单 key 时它只打裸值,不套 key=''——这个行为是 v0.15.1 专门修的(issue #71),因为套上之后直接 $(...) 取出来就不能用了。
单 key 裸值这个细节在脚本里很值钱。以前我们拿数据库密码是这么写的:
PGPASS=$(kubectl get secret pg -n prod -o jsonpath='{.data.password}' | base64 -d)
现在:
PGPASS=$(kubectl view-secret pg password -q)
少一个 base64 子进程,少一次管道,出错时的报错信息也从 base64: invalid input 变成 provided key not found in secret。后者能直接告诉你是 key 名写错了还是 Secret 不存在——排查方向完全不同。
能力二:JSON / YAML 输出,让脚本有结构可依赖
-o json / -o yaml 是 v0.15.0 加进来的,输出长这样(我拿一个 dockerconfigjson 类型的 Secret 实测):
$ kubectl view-secret demo-app-tls -a -o json
{
"data": [
{
"key": ".dockerconfigjson",
"value": "{\n \"auths\": {\n \"registry.internal.example.com\": {\n \"auth\": \"ZGVtb191c2VyOnMzY3IzdC1wMXZyZA==\",\n \"password\": \"s3cr3t-p1vrd\",\n \"username\": \"demo_user\"\n }\n }\n}"
},
{
"key": "password",
"value": "s3cr3t-p1vrd"
},
{
"key": "username",
"value": "demo_user"
}
],
"name": "demo-app-tls",
"namespace": "prod",
"type": "kubernetes.io/dockerconfigjson"
}
data 是个数组而不是 map,key 是按字母排好序的(slices.Sorted(maps.Keys(...))),JSON 本身也是 deterministic 排序。这意味着 diff 两个集群的同名 Secret 时不会因为 key 顺序抖动产生噪音——这个设计是为了 CI 用的。
顺便注意 .dockerconfigjson 那个值:它是 JSON 字符串,插件把它 pretty-print 之后塞进了 value 字段(decodeDockerConfig 里做的)。所以你能直接读懂 registry 的账号密码,不需要再解一次。
但这里有个坑必须先说。 text 模式的输出不是 shell safe 的。它的格式是 key='value',只加了单引号,值内部的单引号不转义。我造了个恶意 Secret 试了一下:
$ kubectl view-secret tricky -q
Hello'; rm -rf /; echo pwned
如果谁把这个输出 eval 了或者拼进 shell 脚本,那就是教科书级的命令注入。v0.17.0 专门在 README 里加了一句"do not feed it to a shell"(PR #101),并明确建议脚本一律用 -o json 或 -o yaml。这个修复本身很轻,但它是这次发版里我最看重的一条——工具作者主动划清能力边界,比多加一个 feature 更让人放心。
能力三:交互模式和大集群上的一个隐性优化
不给 Secret 名字直接回车,它会弹一个可翻页的选择列表(基于 huh,也就是 charmbracelet 那套 TUI 库):
$ kubectl view-secret
? Available Secrets Found 12 secrets. Choose one. [Use arrows to move, type to filter]
> alertmanager-config
app-config
db-credentials
...
选完 Secret 再选 key,多 key 时列表里第一项是 all。补全也做了:kubectl view-secret <TAB> 出 Secret 名,第二个位置出 key 名,-n <TAB> 出 namespace,而且补全链路会正确转发 -n / -c / -k / --as / --as-group(v0.17.0 修的 #95)。
这里有个只有在几百个 namespace 的集群上才会暴露的问题,v0.17.0 修掉了,值得单独讲:
以前的实现为了列出 Secret 名,走的是 kubectl get secrets -o json,然后把整个 JSON 拉回来只取 metadata.name。在大集群上这意味着——你只是想看一眼名字,结果把所有 Secret 的完整数据都下载了一遍。几千个 Secret、每个几十 KB,几百 MB 的传输就为了一个下拉列表。而且每次翻页都可能重来一次(issue #88)。
修法很朴素:改成 kubectl get secrets --no-headers。默认的表格输出在 API server 侧就只返回元数据,data 字段根本不出集群。代码里那句注释写得很清楚:
Unlike -o json or -o jsonpath, the default output makes kubectl ask the API server for a table of metadata, so no secret data is downloaded just to list names.
这个优化听上去不起眼,但它把"交互模式能不能在生产集群用"这个问题从"不敢按"变成了"可以按"。同时它也是 RBAC 友好的——你的账号只需要 list 权限就能看到名字,不需要 get 到 data。
安装:三条路,别踩命名那个坑
Krew(推荐):
kubectl krew install view-secret
krew-index 里的版本已经是 v0.17.0,官方包,走 sha256 校验。
二进制直装(air-gapped 环境用这个):
VERSION=v0.17.0
curl -sL -o kvs.tar.gz \
"https://github.com/elsesiy/kubectl-view-secret/releases/download/${VERSION}/kubectl-view-secret_${VERSION}_darwin_arm64.tar.gz"
tar xzf kvs.tar.gz
sudo mv kubectl-view-secret /usr/local/bin/kubectl-view_secret # ← 注意下划线
chmod +x /usr/local/bin/kubectl-view_secret
kubectl view-secret --help
那个下划线是必须的。 kubectl 插件的查找规则是 kubectl-<子命令>,而子命令里的 - 会被替换成 _。所以文件名必须是 kubectl-view_secret,否则 kubectl view-secret 会报 unknown command。我见过不止一个人卡在这一步,README 里也专门写了这条。
架构支持很全:darwin/linux 的 amd64+arm64、windows amd64,另外 AUR、nixpkgs、Homebrew 都有。二进制 5.5MB,纯 Go 静态链接,没有任何运行时依赖——扔进 scratch 镜像当 initContainer 也能跑。
补全脚本(kubectl 1.26+):
cat << "EOF" | sudo tee /usr/local/bin/kubectl_complete-view_secret > /dev/null
#!/bin/bash
kubectl view-secret __complete "$@"
EOF
sudo chmod +x /usr/local/bin/kubectl_complete-view_secret
实战:一次 Helm release 排障的完整对照
上周有个客户报"回滚成功了但配置没变"。要查的是 Helm 存在 Secret 里的 release 记录——这是 Helm v3 唯一的存储后端,没有数据库,只有 Secret。
传统路径,三步:
# 1. 先找哪个 Secret 装着这个 release
kubectl get secret -n prod -l owner=helm,name=myapp
# 2. 取 base64 串(注意 jsonpath 里的点要转义)
kubectl get secret sh.helm.release.v1.myapp.v3 -n prod \
-o jsonpath='{.data.release}' | head -c 60
# SDRzSUFBcVQ5R29DLzMyTlVRcUFJQkFGcnhMdk80THFyOXNzdVZHUXVpZ1dp...
# 3. 得猜:这一串解一层还是两层?先解一层看看
kubectl get secret sh.helm.release.v1.myapp.v3 -n prod \
-o jsonpath='{.data.release}' | base64 -d | head -c 4
# H4sI ← gzip magic,说明还得再解一层 + gunzip
kubectl get secret sh.helm.release.v1.myapp.v3 -n prod \
-o jsonpath='{.data.release}' | base64 -d | base64 -d | gunzip | jq .info
第 3 步那个 H4sI 就是 gzip 的魔数。认不出这个 magic 的人会在这里卡半天,因为他 base64 -d 出来是一坨二进制,终端直接乱码,第一反应是"Secret 坏了"。
view-secret 路径,一步:
kubectl view-secret sh.helm.release.v1.myapp.v3 -n prod -q | jq .info
{
"first_deployed": "2026-10-28T09:12:33Z",
"last_deployed": "2026-11-09T14:02:11Z",
"status": "deployed",
"description": "Rollback to 12"
}
两行就拿到了 last_deployed 和 description。客户的真实原因是 Helm 记录回滚到了 revision 12,但 deployment.yaml 里的镜像 tag 用的是 latest——回滚了 chart 没回滚镜像。这个答案在 release 记录的 chart.metadata.version 和实际 Pod 的 image 对比里,二十秒就定位了。
性能对照: 我拿一个 3.24MB 明文的假 release(压成 35KB 的 Secret)在本机跑了对照,各 3 轮:
| 方式 | 耗时(3 轮) |
|---|---|
| jsonpath | base64 -d | base64 -d | gunzip | 0.045s / 0.039s / 0.039s |
| kubectl view-secret -q | 0.029s / 0.030s / 0.028s |
差的那 10 毫秒来自省掉的三个管道子进程。客观说,这点差距在你手动排障时毫无意义——人反应一次是 200ms 起。它的价值不在于快,而在于不用记:不用记这个类型解几层、不用认 magic number、不用在乱码面前猜。
但如果把同一条命令塞进 CI 跑几百次,或者塞进一个健康检查的循环里,那就不是毫秒的问题了。顺带说,-q 是必加的:不加的话它会往 stderr 打一行 Viewing only available key: release,混在 stdout 重定向的场景里会污染输出。
三个坑
坑一:非 TTY 环境下,多 key 且不给 -a,它会挂住。
这个坑我是实测踩出来的。CI 里(stdin 不是终端)跑:
kubectl view-secret demo-app-tls -o json </dev/null
结果是——数据其实已经打到 stdout 了,但进程不退出,一直等到超时(timeout 6 返回 124)。因为代码路径走进了交互式选择器 huh.NewForm(...),它要等用户选 key,非 TTY 下不报错、不 fallback,就是干等。
规避方法很简单:脚本里永远显式给 -a 或给具体 key 名。 但如果你在写一个包装脚本给别人用,最好自己先判断一下 key 数量,别指望它优雅降级。
坑二:text 输出不能进 shell。
前面演示过,值里的单引号不转义,eval 就是灾难。凡是脚本消费,一律 -o json,然后 jq -r '.data[] | select(.key=="password") | .value'。这条在 v0.17.0 之前根本没文档写,现在 README 明说了。
坑三:--version 不存在。
kubectl view-secret --version 会报 unknown flag: --version。想确认装了哪个版本只能 kubectl krew list 或看二进制。小问题,但升级后想验证版本时会被绊一下。
还有个容易被误读的行为:-a 和 -o json 一起用时,data 里是解码后的值;而 key 不存在的情况下,v0.16.0 及以前对单 key 的 Secret 会静默忽略(issue #96 修的)。如果你还在老版本,单 key Secret 传错 key 名会得到空白输出而不是报错——升级到 v0.17.0 才能拿到明确的 provided key not found in secret。
什么时候用它,什么时候别用
适合:
-
日常排障想快速看一眼配置值
-
CI 里取数据库密码、registry 凭据这类单值
-
审计某个 namespace 下所有 Secret 的类型分布(-o json | jq -r '.type' 一把过)
-
交接时给新人演示"这个集群里到底有什么配置"——交互模式比 kubectl get secret 友好太多
不适合:
-
多集群批量巡检。 每个 Secret 一次 kubectl 调用,几百个 Secret 就是几百次 API 往返。批量场景用 kubectl get secrets -A -o json | jq 一次拉全,或者上 external-secrets 这类管理面工具。
-
密钥轮转 / 写入。 它只读。写 Secret 还是 kubectl create secret 或 ExternalSecret。
-
需要审计留痕的场景。 它就是个本地解码器,谁什么时候看了哪个 Secret,它不管。这块得靠 API server audit log。
替代方案对照:
| 场景 | 更合适的选择 |
|---|---|
| 只要一次、临时看 | kubectl get secret x -o jsonpath='{.data.k}' | base64 -d,不装插件 |
| 要脱敏后给别人看 | kubeseal + SealedSecret,或 kubectl-neat 清 metadata |
| 想看 Helm 渲染后的 manifest 而不是 release 记录 | helm get manifest myapp -n prod,比解 Secret 直接得多 |
| 多集群批量 | kubectl get secrets -A -o json + jq |
| 密钥全生命周期管理 | External Secrets Operator / Vault / SOPS |
我的判断
这类工具的价值不在"高级",在"省一次思考"。
base64 -d 那三层管道我敲了七年,从来没觉得有问题——直到我意识到每次我都在心里跑一遍判断分支:"这个 Secret 是什么类型?要解几层?解出来是文本还是二进制?"。这个认知开销小到可以忽略,但它乘以七年、乘以每天几十次,就是实打实的损耗。而且它会在你最没余力的时候咬你一口:凌晨三点告警响、你困得眼睛睁不开、base64 -d 出来一片乱码,你还得先反应过来那是 gzip。
view-secret 做的就是把那个判断分支固化下来。431 star 不算火,2019 年就在了也没爆,但它一直在维护——v0.17.0 这次的 changelog 里全是 "reject invalid --output"、"limit decompressed size"、"fail on unknown key" 这种不出彩但真管用的条目。这种维护节奏比 star 数更能说明一个工具能不能进你的标准镜像。
我会把它加进团队的运维基础镜像,跟 kubectx、kubens、stern 放一起。三行安装,零运行时依赖,5.5MB,换掉一条敲了七年的管道。这个交换比,值。