Node.js+Express下基于Multer实现上传文件直接加密存盘的方案问询

我之前也碰到过完全一样的需求——绝对不能让未加密的原始文件落到服务器磁盘上，直接在上传流的环节完成加密再存储才是正确的思路。你之前尝试crypto没成功，大概率是没把Multer的流式处理和加密流正确结合，而且req.cipher本身就不是Express或Multer提供的属性，这是你误解的地方。

下面是我验证过的完整解决方案，核心是自定义Multer的存储引擎，直接在文件上传的流过程中完成加密，全程不会产生未加密的临时文件：

核心思路 #

不用Multer默认的diskStorage直接存盘，也不建议用memoryStorage（大文件会占内存），而是自定义存储引擎，在_handleFile方法里拦截上传流，通过crypto创建加密流，再把加密后的流直接写入磁盘。同时要注意每个文件生成独立的IV（初始化向量），并把IV和加密文件绑定存储（我这里直接把IV写入文件开头，解密时再读取出来）。

完整代码实现 #

1. 依赖准备 #

确保你已经安装了所需模块：

npm install express multer crypto fs-extra

2. 配置加密与自定义存储引擎 #

const express = require('express');
const multer = require('multer');
const crypto = require('crypto');
const fs = require('fs');
const path = require('path');

// 加密配置（建议从环境变量读取，绝对不要硬编码！）
const ENCRYPTION_ALGORITHM = 'aes-256-cbc';
// 密钥需要是32字节（256位），可以用crypto.randomBytes(32).toString('hex')生成后存在环境变量
const ENCRYPTION_KEY = Buffer.from(process.env.ENCRYPTION_KEY, 'hex');
const IV_LENGTH = 16; // AES算法的IV固定为16字节

// 自定义Multer存储引擎：流式加密后存盘
const encryptedStorage = multer.diskStorage({
  destination: (req, file, cb) => {
    const uploadDir = './encrypted-uploads';
    // 确保存储目录存在
    if (!fs.existsSync(uploadDir)) {
      fs.mkdirSync(uploadDir, { recursive: true });
    }
    cb(null, uploadDir);
  },
  filename: (req, file, cb) => {
    // 生成唯一文件名，避免冲突
    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
    cb(null, `${file.originalname}-${uniqueSuffix}`);
  },
  _handleFile: function(req, file, cb) {
    const filePath = path.join(this.getDestination(req, file), this.getFilename(req, file));
    
    // 生成当前文件的专属IV（每个文件用不同IV更安全）
    const iv = crypto.randomBytes(IV_LENGTH);
    // 创建加密流
    const cipher = crypto.createCipheriv(ENCRYPTION_ALGORITHM, ENCRYPTION_KEY, iv);
    
    // 创建文件写入流，先写入IV，再写入加密后的文件内容
    const writeStream = fs.createWriteStream(filePath);
    writeStream.write(iv); // 把IV写入文件开头，解密时需要读取这部分
    
    // 管道流：上传流 -> 加密流 -> 文件写入流
    file.stream.pipe(cipher).pipe(writeStream);
    
    // 监听流完成/错误事件
    writeStream.on('finish', () => {
      cb(null, {
        path: filePath,
        size: writeStream.bytesWritten - IV_LENGTH, // 减去IV的长度，得到实际加密内容大小
        originalName: file.originalname
      });
    });
    
    writeStream.on('error', (err) => {
      // 出错时删除已写入的部分文件
      fs.unlink(filePath, () => cb(err));
    });
  }
});

// 初始化Multer上传实例
const upload = multer({ storage: encryptedStorage });
const app = express();

3. 上传路由 #

app.post('/upload', upload.single('file'), (req, res) => {
  res.status(200).json({
    message: '文件已加密并成功存储',
    encryptedFilePath: req.file.path,
    originalFileName: req.file.originalname
  });
});

app.listen(3000, () => {
  console.log('服务器运行在 http://localhost:3000');
});

4. 解密文件的方法（配套使用） #

之后需要读取加密文件时，用下面的方法解密：

function decryptEncryptedFile(encryptedFilePath, outputFilePath) {
  const readStream = fs.createReadStream(encryptedFilePath);
  const writeStream = fs.createWriteStream(outputFilePath);
  
  // 先读取文件开头的16字节IV
  let iv;
  readStream.once('data', (chunk) => {
    iv = chunk.slice(0, IV_LENGTH);
    const decipher = crypto.createDecipheriv(ENCRYPTION_ALGORITHM, ENCRYPTION_KEY, iv);
    
    // 把剩余的流管道到解密流，再写入输出文件
    readStream.pipe(decipher).pipe(writeStream);
  });
  
  writeStream.on('finish', () => {
    console.log('文件解密完成，已保存到:', outputFilePath);
  });
  
  writeStream.on('error', (err) => {
    console.error('解密出错:', err);
  });
}

你之前可能踩的坑 #

1. 错误使用req.cipher：Express的req对象本身没有cipher属性，加密流需要通过crypto.createCipheriv手动创建，然后处理Multer提供的file.stream。
2. 用了默认的diskStorage：默认的磁盘存储会先把原始文件写到磁盘，再触发后续回调，这就导致了未加密文件落地，完全违背需求。
3. 忽略IV的存储：AES加密必须搭配IV，而且每个文件要用不同的IV，否则加密安全性会大打折扣，必须把IV和加密文件绑定存储（我这里写入文件开头是最方便的方式）。

额外注意事项 #

• 密钥一定要通过环境变量或专业密钥管理服务存储，绝对不能硬编码在代码里。
• 如果需要更高的安全性，可以改用aes-256-gcm算法（带认证的加密），能同时保证机密性和数据完整性。
• 大文件上传时，这种流式处理不会占用过多内存，比先存到内存再加密高效得多。

内容的提问来源于stack exchange，提问作者Gaurav Shah