zipfile仅支持弱加密,无法实现AES-256;安全方案需用pyminizip、调用7z命令或使用pyzipper(仅读取)。

zipfile不支持AES加密,只能用传统ZIP 2.0加密
Python标准库zipfile确实能加密码,但仅支持弱加密(CRC-based,ZIP 2.0 Legacy Encryption),密钥派生无盐、无迭代,暴力破解极快。如果你需要AES-256加密(比如兼容WinZip、7-Zip或macOS归档工具),zipfile本身做不到——它连读取AES ZIP都报BadPasswordError或直接解压失败。
常见错误现象:zipfile.write()后生成的ZIP在Windows资源管理器双击提示“文件损坏”,或在macOS里输入密码后显示“无法打开归档”。
- 加密必须在
ZipFile构造时指定pwd参数(bytes类型),不能事后补 -
write()方法本身不接受密码参数,所有文件共享同一密码 - 路径需手动处理:
zipfile不会自动递归子目录,得用os.walk()遍历
用shutil.make_archive + 7z命令行实现AES加密(推荐)
真正安全的ZIP加密依赖外部工具。最可靠的方式是用Python调用系统已安装的7z(支持AES-256,跨平台),再用shutil.make_archive打基础包(可选)。
使用场景:你有控制权部署环境(如CI/CD服务器、本地脚本),且能确保7z可用。
实操建议:
- 先用
shutil.make_archive("output", "zip", root_dir="my_folder")生成未加密ZIP(避免手动处理路径编码问题) - 再执行系统命令:
7z a -p"mypass" -mem=AES256 output_encrypted.zip output.zip - 注意:密码含特殊字符时需shell转义;Windows下建议用
subprocess.run并设shell=False+参数列表形式防注入 - macOS用户可改用
zip -er(但仅限macOS自带zip,不跨平台)
用pyminizip替代zipfile(轻量纯Python方案)
pyminizip是C扩展封装,支持AES加密且API简单,比调外部命令更可控。
安装:pip install pyminizip(注意Windows需预装Visual Studio Build Tools)
关键点:
- 函数签名是
pyminizip.compress("folder/", "arcname/", "output.zip", "password", 5),第三个参数是密码(str,自动encode为bytes) - 第二个参数
"arcname/"是压缩包内根路径,填空字符串""会导致路径错乱 - 压缩级别1–9,5是默认平衡值;设为0会跳过压缩(仅打包),但AES加密仍生效
- 不支持单独添加文件,必须一次传整个目录路径(类似
shutil.make_archive)
示例片段:
import pyminizip
pyminizip.compress("data/", "data/", "secure.zip", "s3cr3t!", 5)
为什么不要自己拼接ZIP结构或用zipfile.ZipInfo.encrypt
zipfile.ZipInfo里有个encrypt字段,但它是只读标记,不是加密开关。有人误以为设zinfo.encrypt = True就能触发加密——实际无效,写入时仍明文。
更危险的是尝试手动实现ZIP加密逻辑:ZIP 2.0加密密钥派生算法(PKZIP)虽公开,但Python里正确实现需严格复现RC4状态初始化、多次CRC翻转和header校验字节计算。已有多个轮子(如pyminizip)经过大量真实ZIP验证,重复造只会引入解压兼容性问题。
容易被忽略的地方:即使你用pyminizip生成了AES ZIP,某些老旧解压软件(如部分Linux桌面环境默认归档管理器)可能因缺少AES支持而静默失败——务必在目标环境中实测解压流程。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











