1. Node.js crypto模块概述
Node.js的crypto模块是内置的加密功能库，提供了包括哈希、HMAC、加密、解密、签名和验证等功能的封装。这个模块实际上是OpenSSL加密库的JavaScript接口，让开发者能够在Node.js环境中轻松实现各种安全相关的功能。
在实际开发中，crypto模块常用于：
- 密码哈希存储
- 数据加密传输
- 数字签名验证
- 安全随机数生成
- 证书处理等安全场景
2. 核心功能解析
2.1 哈希与HMAC
哈希是crypto模块最基础的功能之一，用于生成数据的固定长度摘要。常用的哈希算法包括SHA-256、SHA-512等。
const crypto = require('crypto'); // 创建SHA-256哈希 const hash = crypto.createHash('sha256'); hash.update('some data to hash'); console.log(hash.digest('hex'));HMAC（Hash-based Message Authentication Code）是基于密钥的哈希算法，比普通哈希更安全：
const hmac = crypto.createHmac('sha256', 'secret-key'); hmac.update('some data to hash'); console.log(hmac.digest('hex'));注意：在实际项目中，永远不要使用简单的哈希（如MD5）来存储密码，应该使用专门的密码哈希算法如PBKDF2或argon2。
2.2 加密与解密
crypto模块支持多种对称加密算法，如AES：
// 加密 const cipher = crypto.createCipheriv('aes-256-cbc', key, iv); let encrypted = cipher.update('some data', 'utf8', 'hex'); encrypted += cipher.final('hex'); // 解密 const decipher = crypto.createDecipheriv('aes-256-cbc', key, iv); let decrypted = decipher.update(encrypted, 'hex', 'utf8'); decrypted += decipher.final('utf8');关键点：
- 必须使用createCipheriv而不是废弃的createCipher
- IV（初始化向量）应该是随机且唯一的
- 密钥长度必须与算法匹配（如AES-256需要32字节密钥）
2.3 数字签名与验证
数字签名用于验证数据的完整性和来源：
// 生成密钥对 const { privateKey, publicKey } = crypto.generateKeyPairSync('rsa', { modulusLength: 2048, }); // 签名 const sign = crypto.createSign('SHA256'); sign.update('some data'); const signature = sign.sign(privateKey, 'hex'); // 验证 const verify = crypto.createVerify('SHA256'); verify.update('some data'); console.log(verify.verify(publicKey, signature, 'hex')); // true3. 高级功能详解
3.1 密钥交换
crypto模块支持Diffie-Hellman和ECDH密钥交换协议：
// ECDH密钥交换示例 const alice = crypto.createECDH('secp256k1'); const bob = crypto.createECDH('secp256k1'); alice.generateKeys(); bob.generateKeys(); const aliceSecret = alice.computeSecret(bob.getPublicKey()); const bobSecret = bob.computeSecret(alice.getPublicKey()); // 双方现在拥有相同的共享密钥 console.log(aliceSecret.toString('hex') === bobSecret.toString('hex'));3.2 证书处理
Node.js v15.6.0引入了X509Certificate类，方便处理证书：
const cert = new crypto.X509Certificate(fs.readFileSync('cert.pem')); console.log(cert.subject); // 证书主题 console.log(cert.issuer); // 颁发者 console.log(cert.validFrom); // 有效期开始 console.log(cert.validTo); // 有效期结束3.3 密码哈希算法
对于密码存储，推荐使用argon2或PBKDF2：
// PBKDF2示例 crypto.pbkdf2('password', 'salt', 100000, 64, 'sha512', (err, derivedKey) => { console.log(derivedKey.toString('hex')); }); // Argon2示例（Node.js v15+） const parameters = { message: 'password', nonce: crypto.randomBytes(16), parallelism: 4, tagLength: 32, memory: 65536, passes: 3 }; crypto.argon2('argon2id', parameters, (err, derivedKey) => { console.log(derivedKey.toString('hex')); });4. 安全实践与常见问题
4.1 安全注意事项
密钥管理：永远不要将密钥硬编码在代码中，应该使用环境变量或专门的密钥管理服务。
随机数生成：使用
crypto.randomBytes()而不是Math.random()来生成加密安全的随机数。算法选择：避免使用不安全的算法如MD5、SHA1、DES等。
错误处理：加密操作可能因各种原因失败，必须妥善处理错误。
4.2 常见问题排查
问题1：解密失败，报错"bad decrypt"
- 检查密钥和IV是否正确
- 确保加密和解密使用相同的算法
- 检查是否遗漏了final()调用
问题2：签名验证失败
- 确认使用的是同一对密钥
- 检查签名和验证时使用的数据是否完全相同
- 确保没有修改过公钥或私钥
问题3：性能问题
- 对于大量数据，考虑使用流式处理
- 调整PBKDF2或argon2的迭代次数以平衡安全性和性能
4.3 性能优化技巧
对于CPU密集型操作（如密码哈希），考虑使用worker线程避免阻塞事件循环。
重复使用的密钥可以缓存为KeyObject以提高性能：
const keyObject = crypto.createPrivateKey({ key: privateKeyPem, format: 'pem' }); // 后续直接使用keyObject而不是每次解析PEM- 对于大量数据的哈希计算，使用流式接口：
const hash = crypto.createHash('sha256'); fs.createReadStream('bigfile.txt') .on('data', (chunk) => hash.update(chunk)) .on('end', () => console.log(hash.digest('hex')));5. 实际应用案例
5.1 JWT实现
使用crypto模块实现简单的JWT：
function signJWT(payload, secret) { const header = { alg: 'HS256', typ: 'JWT' }; const encodedHeader = Buffer.from(JSON.stringify(header)).toString('base64url'); const encodedPayload = Buffer.from(JSON.stringify(payload)).toString('base64url'); const hmac = crypto.createHmac('sha256', secret); hmac.update(`${encodedHeader}.${encodedPayload}`); const signature = hmac.digest('base64url'); return `${encodedHeader}.${encodedPayload}.${signature}`; } function verifyJWT(token, secret) { const [encodedHeader, encodedPayload, signature] = token.split('.'); const hmac = crypto.createHmac('sha256', secret); hmac.update(`${encodedHeader}.${encodedPayload}`); const expectedSignature = hmac.digest('base64url'); return crypto.timingSafeEqual( Buffer.from(signature), Buffer.from(expectedSignature) ); }5.2 文件加密工具
实现一个简单的文件加密工具：
function encryptFile(inputPath, outputPath, password) { const salt = crypto.randomBytes(16); const key = crypto.scryptSync(password, salt, 32); const iv = crypto.randomBytes(16); const cipher = crypto.createCipheriv('aes-256-cbc', key, iv); const input = fs.createReadStream(inputPath); const output = fs.createWriteStream(outputPath); output.write(salt); output.write(iv); input.pipe(cipher).pipe(output); } function decryptFile(inputPath, outputPath, password) { const input = fs.createReadStream(inputPath); let salt, iv; input.once('readable', () => { salt = input.read(16); iv = input.read(16); const key = crypto.scryptSync(password, salt, 32); const decipher = crypto.createDecipheriv('aes-256-cbc', key, iv); const output = fs.createWriteStream(outputPath); input.pipe(decipher).pipe(output); }); }5.3 安全密码重置令牌
生成安全的密码重置令牌：
function generateResetToken(userId) { const token = crypto.randomBytes(32).toString('hex'); const expires = Date.now() + 3600000; // 1小时后过期 // 创建签名防止篡改 const hmac = crypto.createHmac('sha256', process.env.SECRET); hmac.update(`${userId}${expires}`); const signature = hmac.digest('hex'); return `${userId}.${expires}.${signature}`; } function validateResetToken(token) { const [userId, expires, signature] = token.split('.'); if (Date.now() > parseInt(expires)) { return false; // 令牌过期 } const hmac = crypto.createHmac('sha256', process.env.SECRET); hmac.update(`${userId}${expires}`); const expectedSignature = hmac.digest('hex'); return crypto.timingSafeEqual( Buffer.from(signature), Buffer.from(expectedSignature) ); }在实际项目中，crypto模块是构建安全应用的基石。理解其工作原理并正确使用各种加密功能，可以显著提高应用的安全性。
