Python 软件包索引项目 PyPI 近期完成详情页改版,新增安全标签。这个标签集中展示每个版本的来源状态和发布文件的数字证明,用户在安装前就能看到文件来源是否异常。

打开网易新闻 查看精彩图片

改版的核心是把来源信息摆到明面上。新安全标签会根据版本中各文件的证明情况显示来源状态:所有文件均附有证明时,页面显示完整来源;没有文件附带证明时,则显示无来源。

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

页面会针对几种异常情况给出警告:

  • 来源不完整:同一版本中只有部分文件附带证明
  • 来源不一致:同一版本的文件来自不同构建系统或源代码仓库
  • 来源发生变化:文件使用的仓库或工作流与此前版本不同
  • 来源丢失:此前带有证明的项目开始发布没有证明的文件

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

时间线上有一条硬规则:对于 2026 年 7 月前的版本,如果文件在首次发布超过 14 天后上传,页面会显示橙色警告。PyPI 从 2026 年 7 月开始已经实施新规则,拒绝在版本发布 14 天后添加新文件。

这套机制针对的是供应链攻击。目前供应链攻击非常多,近期出现的供应链安全事件层出不穷,PyPI 希望通过让来源信息更容易理解,帮助用户在安装前检查发布文件。

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