Node.js服务端如何创建解压即需验证密码的加密ZIP压缩包

问题原因 #

你当前使用的系统zip命令-P参数默认采用传统ZipCrypto加密方案，仅加密压缩包内的文件内容，不会加密文件头/文件列表，所以用户解压时可以直接看到包内所有文件名，仅在打开单个文件时才会触发密码校验，不符合需求。

解决方案1：使用7-Zip命令实现全加密（推荐） #

7-Zip支持AES-256高强度加密，同时支持开启文件头加密，开启后用户打开压缩包、解压整个包时就必须先输入密码，看不到内部任何文件信息。

前置依赖 #

先在服务端安装7-Zip运行环境：

• Debian/Ubuntu系统：apt install p7zip-full
• CentOS/RHEL系统：yum install p7zip p7zip-plugins
• macOS系统：brew install p7zip
• Windows系统：安装7-Zip后将安装目录加入系统环境变量PATH

代码实现 #

const { spawn } = require('child_process');
// 7z命令参数说明：
// a: 添加文件到压缩包
// -p后面接密码，注意p和密码之间没有空格
// -mhe=on 开启文件头加密，是实现解压即校验密码的关键参数
// 后面依次是压缩包输出路径、要压缩的目标目录
const zipProcess = spawn('7z', [
  'a',
  '-ppassword',
  '-mhe=on',
  './xyz/test.zip',
  './demo/*'
]);

zipProcess.on('exit', (code) => {
  if (code === 0) {
    console.log('带密码保护的ZIP压缩包创建成功');
  } else {
    console.error('压缩包创建失败，错误码：', code);
  }
});

注意事项 #

如果密码包含特殊字符（比如空格、&、*等），建议用引号将密码部分包裹，避免系统命令解析出错。

解决方案2：使用npm纯JS包实现（无需依赖系统命令） #

如果不想安装系统级依赖，可以使用支持AES加密的npm包实现，示例如下：

1. 先安装依赖：npm install zip-lib
2. 业务代码：

const zl = require("zip-lib");

zl.archiveFolder("./demo", "./xyz/test.zip", {
  password: "password",
  encryptFileNames: true // 开启文件名加密，对应文件头加密能力
}).then(function () {
  console.log("带密码保护的ZIP压缩包创建成功");
}, function (err) {
  console.error("压缩包创建失败：", err);
});

内容的提问来源于stack exchange，提问作者Swapnil Shingole