AES-GCM 是当前最稳妥的文件加解密方案,因其内置完整性校验(tag)、无需填充、防篡改且避免CBC的静默失败风险;必须使用scrypt派生密钥、每次随机生成salt和nonce,并严格按salt→nonce→ciphertext→tag顺序组织文件头。

cryptography 库 + AES-GCM 是当前最稳妥的选择,比 pycryptodome + CBC 更安全、更省心,尤其适合文件级加解密。GCM 模式天然带完整性校验(tag),能防篡改,且无需手动填充,避免了 PKCS7 处理出错的常见坑。
为什么别用 CBC 模式处理敏感文件
CBC 只保证机密性,不验证完整性。攻击者可修改密文任意字节,解密后可能得到可控错误明文(比如把 "status: false" 翻成 "status: true"),而程序还照常执行。GCM 的 tag 会在 decryptor.finalize() 时强制校验,不匹配直接抛 cryptography.exceptions.InvalidTag 异常,不会静默失败。
常见错误包括:
- 用固定
iv或时间戳生成iv→ 导致相同明文生成相同密文,暴露数据模式 - 把
iv和salt都写进文件头但顺序混乱 → 解密时读错前 16 字节当salt,实际却是nonce,直接失败 - 忽略
tag必须和密文一起落盘 → 单独存或丢弃,解密必然失败
如何正确生成和组织密钥与 nonce
密钥不能由 hashlib.sha256(password).digest() 直接生成——它抗穷举能力极弱。必须用 KDF 派生,推荐 scrypt(比 PBKDF2HMAC 更抗 GPU/ASIC 攻击):
-
salt = os.urandom(16),每次加密都不同,必须随密文保存 -
nonce = os.urandom(12),GCM 推荐长度,绝不可复用;也必须随密文保存 - 派生参数选
n=2**14, r=8, p=1, maxmem=100_000_000,平衡安全与响应速度 - 密钥长度设为
32(对应 AES-256),别写成16(那是 AES-128)
密钥派生后禁止缓存、打印、记录到日志,哪怕只调试一次。
文件头结构与分块读写必须严格对齐
加密写入顺序决定解密能否成功。标准结构是:salt(16B) → nonce(12B) → ciphertext → tag(16B)。解密时必须按此顺序读取,缺一不可。
大文件(如 >100MB)必须分块处理,否则 Python 进程内存会暴涨甚至 OOM:
- 缓冲区建议设为
64 * 1024(64KB),兼顾 IO 效率与内存压力 - 加密:多次调用
encryptor.update(chunk),最后encryptor.finalize()得到tag - 解密:同样分块调用
decryptor.update(chunk),但tag必须等全部密文读完后,传给decryptor.finalize(tag) - GCM 不需要填充,但需确保
chunk边界不影响流式处理逻辑
最容易被忽略的细节:nonce 复用等于密钥泄露
GCM 模式下,nonce 复用是灾难性的——只要两次加密用了同一个 nonce,攻击者就能通过密文差值直接恢复出密钥。这不是理论风险,而是已被实证的攻击路径。
所以:
-
nonce必须每次加密都调用os.urandom(12)生成 - 不能从文件名、路径哈希、计数器推导
- 即使你“确定”只加密一次,也要写死这行代码,不省这个字节
- 如果加密多个文件共用一个密码,每个文件的
salt和nonce都必须独立随机
文件头里多写 28 字节(16+12)换来的是整个方案的安全底线,别为了省这点空间绕过它。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











