GeekIt

Vault命令速查

服务启停、初始化解封、登录与 Token、KV 读写、Secrets Engine、策略、认证方法、数据库凭据、PKI 与 Transit、审计运维与报错排查等 173 条命令

共 173 条命令 · 12 类场景 · 点击右侧图标可复制

命令 / 配置说明复制
vault version查看 CLI 与服务端兼容版本
vault server -dev开发模式启动:自动初始化解封、内存存储,切勿用于生产
vault server -dev -dev-root-token-id=root -dev-listen-address=0.0.0.0:8200开发模式指定 root token 与监听地址
vault server -config=/etc/vault.d/vault.hcl按配置文件启动,生产标准方式
systemctl start vaultsystemd 方式启动
systemctl status vault查看服务状态与最近日志
journalctl -u vault -f实时查看服务日志
ss -lntp | grep -E "8200|8201"确认 API 8200 与集群 8201 端口
export VAULT_ADDR=https://vault.example.com:8200设置服务端地址,CLI 与 SDK 都依赖
export VAULT_TOKEN=hvs.xxxxxxxx设置访问令牌,脚本中可用但注意泄露风险
export VAULT_CACERT=/etc/vault/ca.pem指定自定义 CA,自签证书场景使用
export VAULT_SKIP_VERIFY=true跳过证书校验(仅测试环境)
export VAULT_NAMESPACE=team-a指定命名空间(企业版多租户)
vault status查看初始化、封存、高可用与版本信息
命令 / 配置说明复制
vault operator init -key-shares=5 -key-threshold=3初始化:5 份解封密钥,任意 3 份可解封
vault operator init -key-shares=5 -key-threshold=3 -recovery-shares=3 -recovery-threshold=2自动解封模式下的恢复密钥配置
vault operator init -format=json > init.jsonJSON 输出保存,密钥与 root token 必须离线保管
vault operator unseal <unseal-key-1>提交一份解封密钥,凑够阈值才能解封
vault operator unseal交互式输入解封密钥,避免进入命令历史
vault operator seal手动封存,立即停止所有数据访问
vault operator step-down让当前 active 节点让位,触发主备切换
vault operator generate-root -init发起生成新 root token 流程(root 丢失时)
vault operator generate-root -decode=<encoded> -otp=<otp>解码生成新的 root token
vault read sys/seal-status查看封存状态与解封进度
vault read sys/health健康检查,返回 sealed/standby 等状态码
vault read sys/leader查看当前 leader 节点地址
解封密钥与 root token 必须离线分人保管拿到阈值数量的密钥即可解密全部数据
命令 / 配置说明复制
vault login交互式输入 token 登录
vault login -method=userpass username=app password="P@ssw0rd"用户名密码登录,需先启用 userpass
vault login -method=approle role_id=xxx secret_id=yyyAppRole 登录,服务端程序最常用
vault login -method=kubernetes role=app jwt=$(cat /var/run/secrets/kubernetes.io/serviceaccount/token)K8s 内 Pod 通过 ServiceAccount 登录
vault login -method=oidc role=devOIDC 单点登录,浏览器授权后获取 token
vault login -method=ldap username=appLDAP/AD 域账号登录
vault token create -policy=app-policy -ttl=24h -renewable=true创建受限 token
vault token create -policy=app-policy -use-limit=1 -ttl=5m一次性 token,适合临时任务
vault token create -orphan -policy=app-policy -period=24h孤儿周期性 token,不随父 token 失效
vault token lookup查看当前 token 的策略、TTL 与续期能力
vault token lookup <token>查看指定 token 的信息
vault token renew续期当前 token
vault token renew -increment=1h按增量续期
vault token revoke <token>吊销指定 token
vault token revoke -accessor=<accessor>通过 accessor 吊销(不知道明文 token 时)
vault token revoke -self吊销当前 token,脚本退出前清理
vault token capabilities secret/data/app查看当前 token 对某路径的权限
vault token capabilities <token> secret/data/app查看指定 token 的权限,排查 403 常用
vault token lookup -format=json | jq .data.policies提取策略列表,脚本校验用
命令 / 配置说明复制
vault kv put secret/app username=app password="S3cr3t!"写入键值(路径无需写 data/)
vault kv put secret/app @data.json从 JSON 文件批量写入
vault kv get secret/app读取全部字段与版本元数据
vault kv get -field=password secret/app只取单个字段,便于脚本使用
vault kv get -format=json secret/app | jq .data.dataJSON 输出并剥离元数据
vault kv get -version=2 secret/app读取指定历史版本
vault kv patch secret/app password="NewP@ss"只更新部分字段,保留其他键
vault kv put -cas=3 secret/app password="x"乐观锁写入:版本不等于 3 时失败,防并发覆盖
vault kv delete secret/app软删除最新版本(数据仍可恢复)
vault kv delete -versions=1,2 secret/app删除指定版本
vault kv undelete -versions=2 secret/app恢复被软删除的版本
vault kv destroy -versions=1 secret/app彻底销毁指定版本,不可恢复
vault kv metadata get secret/app查看版本列表、最大版本数与自定义元数据
vault kv metadata put -max-versions=10 secret/app限制保留版本数,控制存储增长
vault kv metadata delete secret/app删除全部版本与元数据
vault kv rollback -version=1 secret/app把历史版本内容写为新版本
vault kv list secret/列出某路径下的键
vault kv list -format=json secret/ | jq -r .[]JSON 列表,便于批量巡检
命令 / 配置说明复制
vault secrets list列出已启用的引擎与挂载路径
vault secrets list -detailed含配置参数与访问器
vault secrets enable -path=secret -version=2 kv启用 KV v2 引擎
vault secrets enable -path=kv kv启用 KV v1 引擎(路径独立)
vault secrets enable database启用数据库动态凭据引擎
vault secrets enable -path=pki pki启用 PKI 证书引擎
vault secrets enable transit启用加密即服务(Transit)
vault secrets tune -max-lease-ttl=87600h pki调整引擎最大租期
vault secrets disable secret/禁用引擎并删除其下全部数据(危险)
vault write kv/app password=xxxKV v1 写入(路径直接拼键名)
vault read kv/appKV v1 读取
vault list kv/KV v1 列目录
vault delete kv/appKV v1 删除
vault read sys/mounts查看全部挂载及其配置,排查路径冲突
命令 / 配置说明复制
path "secret/data/app/*" { capabilities = ["create", "read", "update", "list"] }KV v2 策略必须写到 data/ 层
path "secret/metadata/app/*" { capabilities = ["list", "read"] }需要列目录或看版本时单独授权 metadata
path "database/creds/app" { capabilities = ["read"] }允许读取动态数据库凭据
path "sys/health" { capabilities = ["read"] unauthenticated = true }允许未认证访问健康检查
vault policy write app-policy app.hcl创建或更新策略
vault policy list列出全部策略
vault policy read app-policy查看策略内容
vault policy fmt app.hcl格式化策略文件
vault policy delete app-policy删除策略(使用中的 token 立即受影响)
vault token capabilities secret/data/app验证策略是否按预期生效
default 策略不能修改所有 token 默认带 default 策略,权限从这里继承
最小权限:只给需要的 path 与 capabilities避免 path "secret/*" 这类通配授权
命令 / 配置说明复制
vault auth list -detailed查看已启用的认证方法与配置
vault auth enable userpass启用用户名密码认证
vault auth enable approle启用 AppRole,适合服务间认证
vault auth enable kubernetes启用 Kubernetes 认证
vault auth enable -path=jwt oidc自定义挂载路径启用 OIDC
vault write auth/userpass/users/app password="P@ssw0rd" policies=app-policy创建 userpass 用户并绑定策略
vault write auth/approle/role/app token_policies=app-policy token_ttl=1h token_max_ttl=4h创建 AppRole 并限制 TTL
vault read auth/approle/role/app/role-id获取 role_id(可写入配置)
vault write -f auth/approle/role/app/secret-id生成 secret_id(必须保密并定期轮换)
vault write auth/kubernetes/role/app bound_service_account_names=app bound_service_account_namespaces=prod policies=app-policy ttl=1hK8s 角色:限定 ServiceAccount 与命名空间
vault auth tune -default-lease-ttl=1h approle/调整认证方法的默认租期
vault auth disable approle/禁用认证方法并吊销其签发的 token
AppRole 的 secret_id 要定期轮换长期不换的 secret_id 泄露后等于永久后门
命令 / 配置说明复制
vault secrets enable database启用数据库引擎
vault write database/config/mysql plugin_name=mysql-database-plugin connection_url="{{username}}:{{password}}@tcp(10.0.0.21:3306)/" allowed_roles=app username=vault password="V@ultP@ss"配置 MySQL 连接(Vault 用管理账号动态建号)
vault write database/config/pg plugin_name=postgresql-database-plugin connection_url="postgresql://{{username}}:{{password}}@10.0.0.22:5432/app?sslmode=disable" allowed_roles=app username=vault password="xxx"配置 PostgreSQL 连接
vault write database/roles/app db_name=mysql creation_statements="CREATE USER '{{name}}'@'%' IDENTIFIED BY '{{password}}'; GRANT SELECT ON app.* TO '{{name}}'@'%';" default_ttl=1h max_ttl=24h创建角色:按语句动态创建账号并授权
vault read database/creds/app申请动态凭据,返回用户名、密码与租期
vault read -format=json database/creds/app | jq -r .data.username脚本中提取用户名
vault lease list -prefix=database/creds查看未过期的动态凭据租约
vault lease renew <lease_id>续期租约,延长凭据有效期
vault lease revoke <lease_id>立即吊销凭据,Vault 会在数据库上删号
vault lease revoke -prefix database/creds/app按前缀批量吊销,应急止血用
vault write -f database/rotate-root/mysql轮换 Vault 自身使用的管理账号密码
轮换根账号前确认没有其他系统在用rotate-root 会直接改数据库密码
命令 / 配置说明复制
vault secrets enable -path=pki pki启用 PKI 引擎
vault secrets tune -max-lease-ttl=87600h pki把根证书有效期调到 10 年
vault write pki/root/generate/internal common_name="example.com" ttl=87600h生成内部根 CA
vault write pki/config/urls issuing_certificates="http://vault:8200/v1/pki/ca" crl_distribution_points="http://vault:8200/v1/pki/crl"配置证书下载与 CRL 地址
vault write pki/roles/web allowed_domains=example.com allow_subdomains=true max_ttl=72h创建签发角色并限制域名与有效期
vault write pki/issue/web common_name=app.example.com ttl=24h签发证书,返回 cert/key/issuing_ca
vault write -format=json pki/issue/web common_name=app.example.com ttl=24h | jq -r .data.certificate > app.crt脚本中直接落盘证书
vault read pki/cert/ca获取 CA 证书
vault secrets enable transit启用 Transit 加密即服务
vault write -f transit/keys/app type=aes256-gcm96创建加密密钥
vault write transit/encrypt/app plaintext=$(base64 <<< "hello")加密数据,返回 vault:v1:... 密文
vault write -field=ciphertext transit/encrypt/app plaintext=$(base64 <<< "hello")只取密文字段,便于写库
vault write -field=plaintext transit/decrypt/app ciphertext=vault:v1:xxxxx解密并返回 base64 明文
vault write -f transit/keys/app/rotate轮换密钥版本,旧密文仍可解
vault read transit/keys/app查看密钥版本、类型与轮换时间
vault write transit/keys/app/config auto_rotate_period=720h开启自动轮换周期
vault write transit/rewrap/app ciphertext=vault:v1:xxxx用最新密钥版本重加密旧密文
命令 / 配置说明复制
vault audit enable file file_path=/var/log/vault/audit.log启用文件审计(记录所有请求,敏感字段已脱敏)
vault audit list -detailed查看审计设备与配置
vault audit disable file/禁用审计设备
vault list sys/leases/lookup查看租约前缀树
vault lease renew <lease_id>续期租约
vault lease revoke -prefix auth/approle/login批量吊销某前缀下的租约
vault operator raft snapshot save /backup/vault-20261102.snapRaft 快照备份(含全部数据与配置)
vault operator raft snapshot restore /backup/vault-20261102.snap从快照恢复,需在未初始化节点执行
vault monitor -log-level=debug实时查看服务端日志流
vault debug -duration=2m -output=/tmp/vault-debug采集诊断包,提交工单或深度排障
vault read sys/audit查看审计设备是否生效
vault write sys/raw/... 只作应急直接操作底层存储很危险,务必先快照
审计日志要异地保存本地磁盘被清空时审计线索也会一起丢失
命令 / 配置说明复制
vault status查看 HA 模式、active/standby 与集群地址
vault operator raft list-peers列出 Raft 集群成员与投票状态
vault operator raft join https://vault-1:8200新节点加入 Raft 集群
vault operator raft remove-peer <node-id>移除失效节点
vault operator raft autopilot state查看自动接管状态与健康节点
vault operator raft autopilot configuration查看 autopilot 参数
vault operator step-down主动切换 active,验证故障转移
retry_join { leader_api_addr = "https://vault-1:8200" }vault.hcl 中配置自动加入集群
storage "raft" { path = "/var/lib/vault/data" node_id = "vault-1" }Raft 存储配置,无需外部 etcd/Consul
listener "tcp" { address = "0.0.0.0:8200" tls_disable = 0 }监听与 TLS 配置,生产必须开 TLS
vault operator raft snapshot save升级前先做快照,出问题可快速回退
standby 节点不能写数据请求需经负载均衡或由客户端重定向到 active
命令 / 配置说明复制
Vault is sealed服务已封存:按阈值提交 unseal 密钥
Error making API request ... Code: 403. Errors: permission denied策略未覆盖该路径,用 token capabilities 核对
missing client token未登录或 VAULT_TOKEN 未设置
token is expiredtoken 已过期,重新登录或调整 TTL/续期
no handler for route / unsupported path路径写错或引擎未启用,先 secrets list
check-and-set parameter did not match the current versioncas 版本不匹配,先 kv get 取最新版本
x509: certificate signed by unknown authority需配置 VAULT_CACERT 或使用正确证书
connection refused(8200)服务未启动、地址错误或端口被防火墙拦截
namespace not found企业版命名空间不存在或 token 无权访问
lease not found or lease is not renewable租约已过期或被吊销,需重新申请凭据
failed to decrypt: cipher: message authentication failedTransit 密文被篡改或密钥版本不匹配
failed to unseal: invalid key解封密钥错误或属于其他集群
storage is already in use / 数据目录非空误用已有数据目录重新初始化,先确认并备份
no known peers in raft cluster节点未加入集群,检查 retry_join 与 8201 连通性
写入成功但读取 404KV v2 路径需带 data/,而 CLI kv 命令会自动拼
策略写了 secret/* 却读不到v2 的实际路径是 secret/data/* 与 secret/metadata/*

运维常用组合

开发环境快速验证vault server -dev → export VAULT_ADDR → vault kv put secret/app k=v → vault kv get secret/app
生产初始化vault operator init -key-shares=5 -key-threshold=3 → 分发密钥 → 逐个 unseal → vault status 确认
应用接入auth enable approle → policy write → role 绑定策略 → 取 role_id/secret_id → vault login -method=approle → 读 secret
数据库动态账号secrets enable database → config/mysql → roles/app → 应用 vault read database/creds/app → 租约到期自动回收
证书签发secrets enable pki → 生成根 CA → roles/web → pki/issue/web → 应用加载 cert/key
升级与备份vault operator raft snapshot save → 逐节点升级 → unseal → status/list-peers 校验 → 失败则 restore

常见问题排查

1. 先分清 v1 与 v2

KV v2 的数据在 <mount>/data/,元数据在 <mount>/metadata/,策略要分别授权

2. token 短 TTL + 续期

业务用短 TTL 并自动续期,泄露窗口小;长期 token 是最大风险

3. 动态凭据优先

数据库账号用 database 引擎动态生成,到期自动回收,避免共享静态密码

4. 解封密钥分开保管

5 份密钥交不同人持有,单点泄露无法解封;root token 只在应急时生成

5. 审计必须开启

audit 设备记录每次读写,是事后追溯与合规检查的唯一依据

6. 改配置先快照

Raft 快照可完整恢复,涉及存储与升级的操作前必须做

共 173 条 Vault 命令 · 示例中的地址、路径与策略名请替换为实际环境

关于Vault命令速查

在线 HashiCorp Vault 命令速查手册,按服务与启动、初始化与解封、登录与 Token、KV v2 读写、Secrets Engine 与挂载、策略 Policy、认证方法、数据库动态凭据、PKI 与 Transit 加密、审计租约与运维、集群与高可用、常见报错与排查等 12 类场景整理 170+ 条常用命令与配置,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 vault server -dev 与 -config 与 8200/8201 端口与 VAULT_ADDR/VAULT_TOKEN/VAULT_CACERT/VAULT_NAMESPACE 环境变量与 vault status、operator init 的 -key-shares/-key-threshold/-recovery-shares 与 operator unseal/seal/step-down 与 generate-root 与 sys/seal-status/sys/health/sys/leader、login 的 -method=userpass/approle/kubernetes/oidc/ldap 与 token create 的 -policy/-ttl/-renewable/-use-limit/-orphan/-period 与 token lookup/renew/revoke/-accessor/capabilities、kv put 与 @data.json 与 kv get 的 -field/-format=json/-version 与 kv patch 与 -cas 乐观锁 与 kv delete/-versions/undelete/destroy 与 kv metadata get/put/delete 与 kv rollback 与 kv list、secrets list/-detailed/enable 的 -path/-version=2 与 tune 与 disable 与 v1 的 read/write/list/delete、policy write/list/read/fmt/delete 与 data/metadata 双路径授权与 unauthenticated、auth list/enable/tune/disable 与 userpass 用户与 approle role-id/secret-id 与 kubernetes bound_service_account_names/namespaces、database config 的 plugin_name/connection_url/allowed_roles 与 roles creation_statements/default_ttl/max_ttl 与 creds 与 lease list/renew/revoke/-prefix 与 rotate-root、pki root/generate/internal 与 config/urls 与 roles/web 与 issue/web 与 transit keys/encrypt/decrypt/rotate/rewrap/auto_rotate_period、audit enable file 与 audit list/disable 与 raft snapshot save/restore 与 raft join/list-peers/remove-peer/autopilot 与 monitor/debug,以及 Vault is sealed、permission denied 403、missing client token、token is expired、no handler for route、check-and-set parameter did not match、x509 unknown authority、namespace not found、failed to decrypt、failed to unseal invalid key、no known peers 等报错排查。适用于 Vault 密钥管理平台部署与运维、KV 机密读写与应用接入、AppRole/Kubernetes 认证与最小权限策略、数据库动态凭据与租约治理、PKI 证书签发与 Transit 加密、审计合规与 Raft 集群高可用、备份恢复与升级演练,以及安全运维与面试复习。

核心能力

  • 涵盖 vault server -dev 与 -config 与 8200/8201 端口与 VAULT_ADDR/VAULT_TOKEN/VAULT_CACERT/VAULT_NAMESPACE 环境变量与 vault status、operator init 的 -key-shares/-key-threshold/-recovery-shares 与 operator unseal/seal/step-down 与 generate-root 与 sys/seal-status/sys/health/sys/leader、login 的 -method=userpass/approle/kubernetes/oidc/ldap 与 token create 的 -policy/-ttl/-renewable/-use-limit/-orphan/-period 与 token lookup/renew/revoke/-accessor/capabilities、kv put 与 @data.json 与 kv get 的 -field/-format=json/-version 与 kv patch 与 -cas 乐观锁 与 kv delete/-versions/undelete/destroy 与 kv metadata get/put/delete 与 kv rollback 与 kv list、secrets list/-detailed/enable 的 -path/-version=2 与 tune 与 disable 与 v1 的 read/write/list/delete、policy write/list/read/fmt/delete 与 data/metadata 双路径授权与 unauthenticated、auth list/enable/tune/disable 与 userpass 用户与 approle role-id/secret-id 与 kubernetes bound_service_account_names/namespaces、database config 的 plugin_name/connection_url/allowed_roles 与 roles creation_statements/default_ttl/max_ttl 与 creds 与 lease list/renew/revoke/-prefix 与 rotate-root、pki root/generate/internal 与 config/urls 与 roles/web 与 issue/web 与 transit keys/encrypt/decrypt/rotate/rewrap/auto_rotate_period、audit enable file 与 audit list/disable 与 raft snapshot save/restore 与 raft join/list-peers/remove-peer/autopilot 与 monitor/debug,以及 Vault is sealed、permission denied 403、missing client token、token is expired、no handler for route、check-and-set parameter did not match、x509 unknown authority、namespace not found、failed to decrypt、failed to unseal invalid key、no known peers 等报错排查

适用场景

适用于 Vault 密钥管理平台部署与运维、KV 机密读写与应用接入、AppRole/Kubernetes 认证与最小权限策略、数据库动态凭据与租约治理、PKI 证书签发与 Transit 加密、审计合规与 Raft 集群高可用、备份恢复与升级演练,以及安全运维与面试复习。Vault命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Vault命令速查是免费的吗?需要注册或安装吗?
Vault命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Vault命令速查支持哪些功能?
涵盖 vault server -dev 与 -config 与 8200/8201 端口与 VAULT_ADDR/VAULT_TOKEN/VAULT_CACERT/VAULT_NAMESPACE 环境变量与 vault status、operator init 的 -key-shares/-key-threshold/-recovery-shares 与 operator unseal/seal/step-down 与 generate-root 与 sys/seal-status/sys/health/sys/leader、login 的 -method=userpass/approle/kubernetes/oidc/ldap 与 token create 的 -policy/-ttl/-renewable/-use-limit/-orphan/-period 与 token lookup/renew/revoke/-accessor/capabilities、kv put 与 @data.json 与 kv get 的 -field/-format=json/-version 与 kv patch 与 -cas 乐观锁 与 kv delete/-versions/undelete/destroy 与 kv metadata get/put/delete 与 kv rollback 与 kv list、secrets list/-detailed/enable 的 -path/-version=2 与 tune 与 disable 与 v1 的 read/write/list/delete、policy write/list/read/fmt/delete 与 data/metadata 双路径授权与 unauthenticated、auth list/enable/tune/disable 与 userpass 用户与 approle role-id/secret-id 与 kubernetes bound_service_account_names/namespaces、database config 的 plugin_name/connection_url/allowed_roles 与 roles creation_statements/default_ttl/max_ttl 与 creds 与 lease list/renew/revoke/-prefix 与 rotate-root、pki root/generate/internal 与 config/urls 与 roles/web 与 issue/web 与 transit keys/encrypt/decrypt/rotate/rewrap/auto_rotate_period、audit enable file 与 audit list/disable 与 raft snapshot save/restore 与 raft join/list-peers/remove-peer/autopilot 与 monitor/debug,以及 Vault is sealed、permission denied 403、missing client token、token is expired、no handler for route、check-and-set parameter did not match、x509 unknown authority、namespace not found、failed to decrypt、failed to unseal invalid key、no known peers 等报错排查。
Vault命令速查适合哪些场景使用?
适用于 Vault 密钥管理平台部署与运维、KV 机密读写与应用接入、AppRole/Kubernetes 认证与最小权限策略、数据库动态凭据与租约治理、PKI 证书签发与 Transit 加密、审计合规与 Raft 集群高可用、备份恢复与升级演练,以及安全运维与面试复习。