敏感配置和密钥必须由 Kubernetes Secret 管理并以环境变量注入,禁用 config.yaml 硬编码;Kratos 通过 env.NewSource() 和变量替换实现安全解耦,JWT 密钥需运行时加载且不驻留内存。

敏感配置和密钥不能写进 config.yaml 或硬编码在代码里,必须由 Secret 管理并按需注入——这是 Kratos 微服务上线前的强制红线。
为什么不能把密钥写在 config.yaml 里
Kratos 的 config 组件默认支持 YAML/JSON 文件加载,但文件一旦提交到 Git,就等于把数据库密码、JWT 私钥、API Token 全部暴露。哪怕加了 .gitignore,也挡不住本地误提交、CI 日志泄露、镜像层残留等现实路径。
更关键的是:config.Scan() 会把整个结构体(含敏感字段)反序列化进内存,如果日志或 pprof 泄露,私钥可能直接出现在堆栈 dump 中。
常见错误现象:
- CI 构建日志里打印出
jwt.private_key: -----BEGIN RSA PRIVATE KEY----- - 用
kratos run -conf configs/prod.yaml启动后,ps aux | grep kratos能看到完整配置路径,攻击者可尝试读取该文件 - 容器镜像中保留了 configs/ 目录,
docker history或docker export可提取原始配置
用 Kubernetes Secret + 环境变量注入最稳妥
Kratos 原生不绑定任何密钥管理方案,但它的 config 支持多源合并,环境变量天然优先级高于文件——这正是解耦密钥与配置的关键。
实操建议:
- 把 config.yaml 中所有敏感字段删掉或占位,例如把
jwt.private_key改成jwt.private_key: "${JWT_PRIVATE_KEY}" - 在 Helm
values.yaml中定义secrets.jwtPrivateKey,并通过Secret资源 base64 编码后挂载 - 容器启动时用
env:将 Secret 键映射为环境变量:JWT_PRIVATE_KEY - 初始化 config 时显式加入
env.NewSource():config.New(config.WithSource(file.NewSource(flagconf), env.NewSource())) - 确保
config.Decoder支持变量替换(Kratos v2.10+ 默认启用,旧版需手动 wrapdecoder.WithEnvVar())
这样 config.Scan(&bc) 时,${JWT_PRIVATE_KEY} 会被自动替换成环境变量值,且该值不会出现在任何配置文件或日志中。
生产环境必须用非对称算法 + 外部密钥管理
即使环境变量注入安全,硬编码密钥本身仍是单点风险。Kratos 的 JWT 中间件支持运行时加载密钥,这才是正确姿势:
- 禁用
WithSigningKey([]byte("xxx"))这类字面量方式 - 改用
WithSigningMethod(jwt.SigningMethodRS256)+WithSigningKeyFunc(func(t *jwt.Token) (interface{}, error) { ... }) - 函数体内通过
os.Getenv("JWT_PRIVATE_KEY_PATH")读取挂载的 Secret 文件路径,再用ioutil.ReadFile加载(注意权限:Secret 挂载文件默认 0444,不可写) - 密钥文件本身由外部 KMS(如 HashiCorp Vault、AWS KMS)动态下发,Pod 启动时通过 initContainer 注入
这种模式下,密钥不经过 Kratos 配置系统,不进内存字符串,只在签名瞬间加载并立即丢弃句柄,满足 PCI DSS 和等保三级要求。
容易忽略的三个细节
很多人做完上述步骤仍被审计打回,问题往往出在这些地方:
-
config.Value("jwt.private_key")返回的是已替换后的字符串,但如果后续用fmt.Printf或log.Debugw打印整个结构体,私钥仍会明文输出——务必对敏感字段做log.String("jwt_private_key", "******")掩码 - Helm 的
Secret模板中若用{{ .Values.secrets.jwtPrivateKey | b64enc }},要确认该值本身未被 base64 编码过,否则会双重编码导致解析失败 - Kratos 的
env.NewSource()默认只读取大写环境变量,而某些 K8s 注入器(如 Vault Agent)默认小写 key,需显式调用env.NewSource(env.WithStripPrefix("APP_"))或统一命名规范
真正的安全不是“没出事”,而是让密钥在任何环节都不以明文形态驻留超过必要时间——Kratos 提供了足够灵活的钩子,但每一步都得亲手拧紧。


















