Node.js使用SSL pfx文件启动服务器报unsupported错误

报错信息 #

运行server.js启动Node.js服务器时出现以下错误：

node:internal/tls/secure-context:277
      context.loadPKCS12(toBuf(pfx), toBuf(passphrase));
              ^

Error: unsupported
    at configSecureContext (node:internal/tls/secure-context:277:15)
    at Object.createSecureContext (node:_tls_common:117:3)
    at Server.setSecureContext (node:_tls_wrap:1354:27)
    at Server (node:_tls_wrap:1218:8)
    at new Server (node:https:74:3)
    at Object.createServer (node:https:112:10)
    at Object.<anonymous> (/home/user/nodeserver/server.js:21:27)
    at Module._compile (node:internal/modules/cjs/loader:1254:14)
    at Module._extensions..js (node:internal/modules/cjs/loader:1308:10)
    at Module.load (node:internal/modules/cjs/loader:1117:32)

Node.js v18.14.2

证书信息排查 #

执行以下命令查看PFX文件信息：

openssl pkcs12 -info -in ssl/pfxFile.pfx -noout

命令输出：

MAC: sha1, Iteration 1024
MAC length: 20, salt length: 20
PKCS7 Encrypted data: pbeWithSHA1And40BitRC2-CBC, Iteration 1024
Certificate bag
Certificate bag
PKCS7 Data
Shrouded Keybag: pbeWithSHA1And3-KeyTripleDES-CBC, Iteration 1024

问题 #

已重新生成两次PFX文件，也尝试过无密码方式，但问题依旧。更新Node.js后服务器无法启动，请问Node.js是否有证书相关变更导致该问题？

解答 #

是的，Node.js在v17及以后版本中移除了对弱加密算法的默认支持，这正是问题的核心原因。

从你的证书信息能看到：

• PKCS7加密使用了pbeWithSHA1And40BitRC2-CBC
• 密钥包使用了pbeWithSHA1And3-KeyTripleDES-CBC

这些都属于被废弃的弱加密算法，Node.js v17+不再默认兼容这类算法，因此加载PFX时会抛出unsupported错误。

解决办法 #

1. 重新生成强加密标准的PFX证书（推荐）
   使用现代安全算法生成证书，比如用AES-256-CBC替代RC2或3DES。示例OpenSSL命令：

   openssl pkcs12 -export -in cert.pem -inkey key.pem -out new_pfxFile.pfx -certfile chain.pem -iter 20000 -macalg sha256
   

   该命令使用SHA256作为MAC算法，提升迭代次数至20000，符合现代加密安全标准。

2. 临时启用弱算法（仅临时应急）
   如果暂时无法重新生成证书，可通过环境变量或代码配置临时允许弱算法，但会降低服务安全性：

   • 通过环境变量启动：

     NODE_OPTIONS=--tls-min-v1.0 node server.js
     

   • 在代码中配置：

     const https = require('https');
     const fs = require('fs');
     const options = {
       pfx: fs.readFileSync('./ssl/pfxFile.pfx'),
       passphrase: 'your-passphrase',
       secureOptions: require('constants').SSL_OP_LEGACY_SERVER_CONNECT
     };
     https.createServer(options, (req, res) => {
       // 服务器业务逻辑
     }).listen(443);
     

内容的提问来源于stack exchange，提问作者Alkä