Node.js中加密用户密码存库：算法选型与crypto最佳实践咨询

Hey there! Let's break down your questions about encryption in Node.js—especially the critical part of password storage. I'll keep this practical and straight to the point, like you'd expect from a Stack Overflow answer.

1. 如何在Node.js中进行数据加密？ #

Node.js自带的crypto模块是处理加密的核心工具，支持对称加密、非对称加密、哈希等多种操作。这里给你两种最常用场景的实用示例：

对称加密（AES-GCM - 适合可解密的敏感数据） #

对称加密用同一个密钥完成加解密，适合加密需要还原的内容（比如用户隐私数据、敏感配置）。推荐用AES-GCM模式，它自带数据认证，能有效防止篡改：

const crypto = require('crypto');

// 生成AES-256所需的32字节随机密钥
const generateSecretKey = () => crypto.randomBytes(32);
// GCM模式推荐12字节的随机初始化向量（IV）
const generateIV = () => crypto.randomBytes(12);

// 加密函数
const encryptData = (plainText, key) => {
  const iv = generateIV();
  const cipher = crypto.createCipheriv('aes-256-gcm', key, iv);
  
  let encrypted = cipher.update(plainText, 'utf8', 'hex');
  encrypted += cipher.final('hex');
  
  // 获取认证标签，解密时必须验证，防止数据被篡改
  const authTag = cipher.getAuthTag().toString('hex');
  return { iv: iv.toString('hex'), encryptedData: encrypted, authTag };
};

// 解密函数
const decryptData = (encryptedObj, key) => {
  const iv = Buffer.from(encryptedObj.iv, 'hex');
  const encryptedData = Buffer.from(encryptedObj.encryptedData, 'hex');
  const authTag = Buffer.from(encryptedObj.authTag, 'hex');
  
  const decipher = crypto.createDecipheriv('aes-256-gcm', key, iv);
  decipher.setAuthTag(authTag);
  
  let decrypted = decipher.update(encryptedData, 'hex', 'utf8');
  decrypted += decipher.final('utf8');
  return decrypted;
};

// 使用示例
const secretKey = generateSecretKey();
const originalData = "My super sensitive user data";
const encrypted = encryptData(originalData, secretKey);
const decrypted = decryptData(encrypted, secretKey);

console.log("Original:", originalData);
console.log("Decrypted:", decrypted);

非对称加密（RSA - 适合密钥交换、数据签名） #

非对称加密用公钥加密、私钥解密，适合不需要共享密钥的场景（比如API签名、安全传输小体量敏感数据）：

const crypto = require('crypto');

// 生成2048位RSA密钥对（推荐用4096位更安全）
const { publicKey, privateKey } = crypto.generateKeyPairSync('rsa', {
  modulusLength: 2048,
  publicKeyEncoding: { type: 'spki', format: 'pem' },
  privateKeyEncoding: { type: 'pkcs8', format: 'pem' }
});

// 用公钥加密
const encryptWithPublicKey = (plainText, pubKey) => {
  return crypto.publicEncrypt(pubKey, Buffer.from(plainText, 'utf8')).toString('base64');
};

// 用私钥解密
const decryptWithPrivateKey = (encryptedText, privKey) => {
  return crypto.privateDecrypt(privKey, Buffer.from(encryptedText, 'base64')).toString('utf8');
};

// 使用示例
const original = "Data to encrypt with public key";
const encryptedRSA = encryptWithPublicKey(original, publicKey);
const decryptedRSA = decryptWithPrivateKey(encryptedRSA, privateKey);

console.log("Original:", original);
console.log("Decrypted RSA:", decryptedRSA);

2. 用户密码加密存储的最佳实践 #

应该选用何种加密算法？ #

绝对不要用普通对称/非对称加密存储密码——你永远不需要还原用户的原始密码！正确的做法是使用带盐的慢哈希算法：

• 优先推荐：Argon2（2015年密码哈希竞赛冠军，抗GPU/ASIC攻击能力最强）
• 次选：bcrypt（久经生产环境考验，实现简单易维护）
• 若仅用Node.js内置crypto模块：pbkdf2（虽然不如前两者，但比MD5/SHA-1这类快速哈希安全得多）

划重点：绝对禁止使用MD5、SHA-1、SHA-256这类快速哈希算法！它们太容易被暴力破解了。

Node.js中使用crypto模块执行密码哈希的最佳方式 #

如果不想引入第三方库，crypto.pbkdf2是可靠的选择，核心要点：

1. 为每个用户生成唯一的随机盐（绝对不要共用盐）
2. 设置足够多的迭代次数（至少10000次，推荐100000+）
3. 哈希长度至少64字节

示例代码：

const crypto = require('crypto');

// 配置安全参数
const SALT_LENGTH = 16;
const ITERATIONS = 100000;
const KEY_LENGTH = 64;
const DIGEST = 'sha512';

// 生成密码哈希（存储时保存盐+哈希，用$分隔方便后续拆分）
const hashPassword = async (password) => {
  const salt = crypto.randomBytes(SALT_LENGTH).toString('hex');
  return new Promise((resolve, reject) => {
    crypto.pbkdf2(password, salt, ITERATIONS, KEY_LENGTH, DIGEST, (err, derivedKey) => {
      if (err) reject(err);
      resolve(`${salt}$${derivedKey.toString('hex')}`);
    });
  });
};

// 验证密码（用timingSafeEqual防止计时攻击）
const verifyPassword = async (password, storedHash) => {
  const [salt, hash] = storedHash.split('$');
  return new Promise((resolve, reject) => {
    crypto.pbkdf2(password, salt, ITERATIONS, KEY_LENGTH, DIGEST, (err, derivedKey) => {
      if (err) reject(err);
      resolve(crypto.timingSafeEqual(derivedKey, Buffer.from(hash, 'hex')));
    });
  });
};

// 使用示例
(async () => {
  const userPassword = 'MySecurePassword123!';
  const storedHash = await hashPassword(userPassword);
  console.log("Stored in database:", storedHash);
  
  const isMatch = await verifyPassword(userPassword, storedHash);
  console.log("Password match:", isMatch); // true
  
  const wrongMatch = await verifyPassword('WrongPassword123', storedHash);
  console.log("Wrong password match:", wrongMatch); // false
})();

为什么更推荐第三方库（bcrypt/Argon2）？ #

虽然pbkdf2能用，但bcrypt和Argon2对密码哈希做了更针对性的优化：

• bcrypt自动处理盐生成，且可通过成本因子调整哈希速度（越慢越抗暴力破解）
• Argon2针对现代硬件（GPU/ASIC）优化，支持内存成本、CPU成本等多维度配置，安全等级最高

比如用bcrypt的示例（先执行npm install bcrypt安装）：

const bcrypt = require('bcrypt');
const saltRounds = 10; // 成本因子，推荐10-12，值越高哈希越慢

// 哈希密码
bcrypt.hash('MySecurePassword', saltRounds)
  .then(storedHash => {
    console.log("Stored hash:", storedHash);
    // 验证密码
    return bcrypt.compare('MySecurePassword', storedHash);
  })
  .then(isMatch => console.log("Password match:", isMatch)) // true
  .catch(err => console.error(err));

内容的提问来源于stack exchange，提问作者Saurav Singh