PyPI加强软件包来源展示应对供应链攻击 发布文件异常将直接显示警告

PyPI加强软件包来源展示应对供应链攻击 发布文件异常将直接显示警告

💡 原文中文,约1100字,阅读约需3分钟。
📝

内容提要

PyPI 详情页改版,新增安全标签,集中展示各版本文件来源状态与数字证明,帮助用户在安装前识别供应链风险。页面会提示四类警告:来源不完整、来源不一致、来源变化、来源丢失。发布文件页支持搜索筛选并显示来源状态,历史页新增文件数量、来源状态及版本撤回等信息。2026年7月起,PyPI 拒绝在版本发布14天后添加新文件。

🔎

延伸解读

来源警告不等于恶意软件判定

PyPI 新增的四类来源警告(来源不完整、不一致、变化、丢失)主要反映文件证明的缺失或变动,而非直接判定软件包恶意。文章明确指出,仓库迁移、构建流程调整等正常操作也可能触发警告。因此,用户看到警告时应结合项目维护记录、发布者信誉等信息综合判断,避免仅凭警告就否定一个软件包。

证明类型与核查方式

来源证明包括 PyPI 可信发布者的发布证明,以及将文件关联到源代码提交、构建平台和构建步骤的 SLSA 构建来源证明。用户可在页面查看相关元数据和透明日志。这意味着,当证明完整时,用户能追溯文件从源码到构建再到发布的链路;当证明缺失或不一致时,则需警惕发布流程可能被篡改或存在异常。

14 天规则与历史版本标记

PyPI 从 2026 年 7 月起拒绝在版本发布 14 天后添加新文件。对于该日期前的版本,若文件在首次发布超过 14 天后上传,页面会显示橙色警告。这一规则旨在限制发布后随意替换文件的行为,降低供应链攻击风险。用户检查历史版本时,应留意此类橙色警告,它提示该版本的文件可能并非最初发布时的内容。

发布历史页面的综合信息

发布历史页面新增了文件数量、来源状态,以及版本是否被撤回、隔离、归档或预发布等信息。这些信息与来源警告配合,能帮助用户在下载前更全面地评估版本状态。例如,被撤回或隔离的版本可能存在问题,而来源状态则反映证明完整性。用户应养成下载前查看历史页面的习惯,而非仅依赖版本号。

❓

Q&A

PyPI 最近改版后新增的安全标签是干什么用的?

安全标签集中展示软件包各版本的来源状态和文件数字证明,帮助用户在安装前识别供应链风险。

PyPI 页面会显示哪几类来源警告?

共四类:来源不完整(部分文件无证明)、来源不一致(文件来自不同构建系统或仓库)、来源发生变化(仓库或工作流与之前版本不同)、来源丢失(之前有证明的项目开始发布无证明文件)。

PyPI 的来源证明具体包括哪些信息?

包括 PyPI 可信发布者的发布证明,以及将文件关联到源代码提交、构建平台和构建步骤的 SLSA 构建来源证明。用户可在页面查看相关元数据和透明日志。

发布文件页面和历史页面有哪些更新?

发布文件页面支持搜索和筛选,并显示每个文件的来源状态;历史页面新增文件数量、来源状态、版本是否被撤回/隔离/归档/预发布等信息。

PyPI 对版本发布后添加新文件有什么新规则?

从 2026 年 7 月起,PyPI 拒绝在版本发布 14 天后添加新文件。对于 2026 年 7 月前的版本,如果文件在首次发布超过 14 天后上传,页面会显示橙色警告。

看到来源警告是否一定代表软件包有风险?

不一定。仓库迁移和构建流程调整等正常操作也可能触发警告。来源证明主要用于核查文件的发布或构建来源,用户仍需结合项目维护记录等信息综合判断风险。

🏷️

标签

➡️

继续阅读