加密私钥为什么加载失败
私钥带口令时，文件本身是加密的，服务进程启动时需要有人提供口令。nginx、Apache 这类常驻服务无法在启动时交互输入，于是报出 cannot load private key 或 bad decrypt。可选路径有两条：把私钥解密成明文文件并严格限制权限（600、专用账号），或使用服务自带的密码文件机制（nginx 的 ssl_password_file）。前者简单但把保护落在文件权限上，后者把口令落盘又削弱了加密私钥的意义，最终方向仍是接入 KMS 或 HSM。
基本信息
| 判断是否加密 | 文件头部含 ENCRYPTED，或老的 PEM 含 Proc-Type / DEK-Info |
|---|---|
| 解密命令 | openssl pkey -in key.enc.pem -out key.pem |
| 权限要求 | 解密后立即 chmod 600，属主设为服务运行账号 |
| nginx 机制 | ssl_password_file 指向口令文件，注意该文件权限 |
| PKCS#12 场景 | 证书与私钥打包在 p12 里时同样需要口令参数 |
| 长期方向 | 接入 KMS/HSM，避免私钥明文落盘 |
典型使用场景
- 服务启动报错排查：确认是口令问题而不是路径或格式问题。
- 证书交付后部署：外部交付的加密私钥需要转成服务可加载的形式。
- 迁移与兼容：从支持密码文件的版本迁到不支持的服务时重新规划。
- 权限整改：清理历史上权限过宽的私钥文件。
- 合规说明：向评审方解释私钥保护方式与访问控制。
判断与解密私钥
判断与解密私钥
# 判断私钥是否加密（输出大于 0 说明带口令）
grep -c 'ENCRYPTED' key.pem
# 解密为明文私钥并立即收紧权限
openssl pkey -in key.enc.pem -out key.pem
chmod 600 key.pem
# 校验私钥与证书是否配对，避免加载后才发现不匹配
# openssl pkey -in key.pem -pubout | openssl sha256
# openssl x509 -in cert.pem -noout -pubkey | openssl sha256nginx 密码文件用法
nginx 密码文件用法
server {
listen 443 ssl;
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 证书链
ssl_certificate_key /etc/nginx/ssl/private.key; # 加密私钥
ssl_password_file /etc/nginx/ssl/pass.txt; # 口令文件，权限必须收紧
}口令文件落盘会削弱加密私钥的意义：拿到文件的人等于拿到私钥。仅在无法集成 KMS/HSM 时作为过渡手段，限制权限与备份范围，并记录在案。
报错信息里 bad decrypt 通常意味着口令不对或文件损坏，cannot load private key 也可能是格式或权限问题；先用 openssl pkey 单独加载一次，把问题范围缩小到钥匙本身。