PyPI 加强对上传分发包的检查

PyPI 加强对上传分发包的检查

💡 原文英文,约900词,阅读约需4分钟。
📝

内容提要

PyPI近期加强上传分发文件的检查,拒绝V7格式的源码分发,以及含可能被误读为ZIP控制结构的注释的构建分发,以减少解析差异带来的安全风险。普通用户不受影响;维护者应使用主流构建后端生成符合规范的pax格式tar和有效ZIP,避免手动打包。未来还将禁止GNU格式tar和ZIP注释。

🔎

延伸解读

解析差异为何成为安全风险

文章指出,tar 和 ZIP 格式原本并非为 Python 打包设计,其解析器通常较为宽松,这在本地恢复损坏文件时有用,但在网络分发场景下会带来隐患。不同工具对同一归档的解析可能不一致,攻击者可利用这种差异,让 PyPI、镜像站、安全扫描器和安装器看到不同的内容,从而绕过完整性校验。因此,PyPI 收紧上传检查,本质是减少解析歧义,确保各方对分发包内容的理解一致。

维护者应如何应对上传被拒

普通用户不受影响,已依赖的包仍可正常安装。维护者若遇到因归档格式导致的上传拒绝,最直接的修复是使用主流构建后端生成分发包,而非手动用 tar 或 zip 打包。若必须手动打包,源码分发需为 POSIX pax 格式 tar,使用 GNU tar 时应加 --format=pax,并避免稀疏成员和 pax 厂商扩展;构建分发需为有效 ZIP,且两者文件名均须 UTF-8 编码。

未来限制与生态影响

PyPI 计划进一步禁止 GNU 风格 tar 归档和 ZIP 注释。前者虽已被源码分发规范禁止,但因维护者使用较多而暂时允许;后者目前仅放行少量兼容性注释。这些措施是更广泛倡议的一部分,旨在与 Python 自身的 zipfile、tarfile 模块及打包标准协同,减少解析差异。PyPI 表示会优先选择破坏性最小的限制,但维护者仍需关注后续变化,避免依赖非规范打包方式。

❓

Q&A

PyPI 最近新增了哪些上传检查?

PyPI 新增的检查包括:拒绝使用 V7 格式的源码分发(sdists),以及拒绝包含可能被误读为 ZIP 控制结构的归档级注释的构建分发(bdists/wheels)。

这些新检查对普通用户有影响吗?

没有影响。下游用户(包消费者)不会受到这些变更的破坏性影响,已依赖的包通过 pip install 或 uv add 仍可正常工作。

为什么 PyPI 要加强对分发文件的检查?

因为 tar 和 ZIP 格式并非为 Python 打包设计,其解析器通常过于宽松,可能导致解析差异(parser differentials),攻击者可利用这些差异使同一分发在不同平台或工具下解压出不同内容,从而破坏 PyPI、镜像、安全扫描器与安装器之间的一致性,甚至安装恶意包。

包维护者遇到上传被拒应该怎么办?

维护者应确保使用非 EOL 版本的 Python 和主流构建后端来生成符合规范的分发文件,避免手动用 tar 或 zip 打包。如果必须手动打包,源码分发必须使用 POSIX pax 格式的 tar(GNU tar 需加 --format=pax),并避免 sparse 成员和 pax 供应商扩展;构建分发必须是有效的 ZIP 归档,且两者成员文件名均需 UTF-8 编码。

未来 PyPI 还计划禁止哪些归档格式?

近期 PyPI 将评估两项额外限制:完全拒绝 GNU 风格的 tar 归档(源码分发规范已禁止,但目前因维护者使用较多而允许),以及完全拒绝 ZIP 注释(目前仅允许少量无害注释以兼容某些 ZIP 编码器)。

源码分发和构建分发分别使用什么归档格式?

源码分发(sdists)使用压缩的 tar 归档(.tar.gz),构建分发(bdists/wheels)使用 ZIP 归档(.whl)。

🏷️

标签

➡️

继续阅读