pip 26.3 在 2026 年 11 月 2 日发布。这次没有新功能,是一次安全收紧,三个变化要放在一起读:安全政策改写、安装期的 import 拦截从警告变成报错、修了一个哈希校验漏洞。背景是 10 月份的 eMudhra 弱 CA 密钥事件,整个 Python 打包生态都在补证书和收紧信任链。下面是实测过程和结果,环境是 Python 3.15.2,两个虚拟环境分别装 pip 26.2.2 和 pip 26.3 做对照。

变化一:安全政策改写,“装 wheel 不跑代码”被删了

pip 26.2 的 SECURITY.md 里写过一句话:“Installing a wheel does not run code from it”(装 wheel 不会运行其中的代码)。这句话寿命很短:2026 年 7 月 11 日才随 PR #14164 进入主分支,7 月 29 日随 26.2 首次发布。26.3 把它删了,我拉了 26.3 标签上的 SECURITY.md 原文,现在写的是:

Because Python’s import system is dynamic, pip cannot guarantee that installing a wheel will not execute third-party code.

翻译过来:因为 Python 的 import 系统是动态的,pip 不能保证装 wheel 时不执行第三方代码。26.3 的更新说明写得更直白:pip “has never considered installing untrusted wheels safe”(从未认为装不可信的 wheel 是安全的)。

新版政策还加了一节 “Reducing code execution risks”(降低代码执行风险),给了三条做法:

  • 用 python -P -m pip install ... 装包(-P 要求 Python 3.11+,老版本用 -I),避免把脚本目录或当前目录插到 import 路径前面;
  • 让运行 pip 的账号写不了标准库文件和目录;
  • 只从信任的来源装 wheel。

我实测了第一条,python -P -m pip --version 在 Python 3.15.2 上正常工作:

pip 26.3 from /tmp/pip263/v263/lib/python3.15/site-packages/pip (python 3.15)

为什么 wheel 安装会跑代码?wheel 安装本身只是解包,但 Python 的 import 是动态的:安装过程中可能触发 .pth 文件、入口点(entry points),也可能在安装中途 import 了正被替换的包。而从源码包(sdist)构建时跑代码更是公开的设计——构建工具由包自己选(PEP 517)。所以“wheel 安全、sdist 危险”这个二分法本来就不成立,26.3 只是把话说清楚了。

变化二:安装期 import 从警告变报错

更新说明里另一条在 “Deprecations and Removals” 下面:“Block unexpected imports during installation, warn about unsafe imports afterward, and improve recovery from interrupted installations."(#13842)

这件事从 26.1 起只是警告,26.3 变成硬拦截。我读了 26.3 自带源码(pip/_internal/commands/install.py),机制是这样的:安装开始后,pip 挂一个 _ImportBlocker,任何非预期的 import 都会抛 BlockedImportError:

Blocked import of 'xxx' after pip install started. Hook authors must import required modules before installation starts.

安装完成后再 import,pip 会警告:

Unsafe import of 'xxx' after pip install completed: packages may have changed. Callers should import all required modules before running pip install, or run pip in a subprocess.

什么场景会撞上这个?最常见的是在程序里直接调 pip 安装(in-process pip),或者安装钩子在安装中途 import 了正被替换的包。26.3 之前这只是警告,很多人没当回事;现在会直接报错中断安装。正确做法是:要用的模块先 import 好再开始装,或者把 pip 放到子进程里跑(python -m pip 就是子进程,本来就不受影响)。这个拦截我没有在本文环境里造出触发用例,上面是源码加更新说明的结论,不是运行结果。

变化三(重点实测):–no-require-hashes 的哈希校验漏洞修了

这是 26.3 里最值得动手验证的一条。--no-require-hashes 是 26.2 新加的选项:26.2 起,只要 requirements 文件里有一个包带了 --hash,pip 就会自动对所有包强制要求哈希;--no-require-hashes 是关掉这个自动强制的开关。但 26.2 和 26.2.2 有个 bug:开了这个开关后,pip 会把 index 公布的哈希当作 requirements 文件里 --hash 的替代品。也就是说,你钉的哈希可能根本没被校验。

我按 THEXARIS Labs 那篇分析里的方法,在本地复现了一遍:

  1. 造了一个 demopkg 1.0,打包出两个 wheel:文件名完全一样,内容一个是 VALUE = "A",一个是 VALUE = "B",sha256 各不相同:
wheelA: 1d874b60c2fa9795eca873169700f285768155e2d4ac189f7c898c1981eb3c6e
wheelB: 2113506e1d621aaa1efe87cc58413fc910088a1ba855136ad99b5a33c62a3e6f
  1. requirements 文件钉的是 A 的哈希:
demopkg==1.0 --hash=sha256:1d874b60c2fa9795eca873169700f285768155e2d4ac189f7c898c1981eb3c6e
  1. 本地搭一个 simple index,只提供 B 这个文件,并且链接里带上 B 自己的哈希。

  2. 两边都用 --no-require-hashes 从这个本地 index 安装。

pip 26.2.2 的结果,退出码 0,装上了:

Downloading demopkg-1.0-py3-none-any.whl (1.1 kB)
Installing collected packages: demopkg
Successfully installed demopkg-1.0
262 installed VALUE = B

钉的是 A 的哈希,装进去的却是 B,全程没有报错。pip 26.3 的结果,退出码 1,直接拒绝:

ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. If you have updated the package versions, please update the hashes. Otherwise, examine the package contents carefully; someone may have tampered with them.
    demopkg==1.0 from http://127.0.0.1:8123/demopkg-1.0-py3-none-any.whl#sha256:2113506e1d621aaa1efe87cc58413fc910088a1ba855136ad99b5a33c62a3e6f (from -r /tmp/pip263/req.txt (line 1)):
        Expected sha256 1d874b60c2fa9795eca873169700f285768155e2d4ac189f7c898c1981eb3c6e
             Got        2113506e1d621aaa1efe87cc58413fc910088a1ba855136ad99b5a33c62a3e6f

而且 26.3 里什么都没装上(import demopkg 报 ModuleNotFoundError)。这个复现和 THEXARIS 的结论一致。影响范围很具体:只在 26.2 到 26.2.2 之间、用过 --no-require-hashes 又钉了哈希的 CI 才需要自查;升级到 26.3 就修好了。这不是一个新 CVE,是校验逻辑的修复。

其他 26.3 安全小项

更新说明里还有几条安全相关的改动,我逐条列出来,前面两条之外的只做了其中一条实测:

  • 拒绝 HTTP 跳转到 file: URL(#14171):实测。我搭了一个本地服务,任何请求都 302 跳到 file:///tmp/pip263/wheelB.whl,pip 26.3 下载时拒绝跟随,退出码 1:
WARNING: Not following redirect from http://127.0.0.1:8124/simple/demopkg/ to file:///tmp/pip263/wheelB.whl: a redirect to a non-http(s) location is not allowed.
  • wheel 缓存的来源不匹配警告不再泄露 URL 里的凭证(#14232):更新说明条目,未单独实测。
  • --cert 和 --client-cert 在安装构建依赖时也生效:更新说明条目,未单独实测。
  • 依赖升级:certifi 升到 2026.10.23,packaging 升到 26.3,truststore 升到 0.10.5。

背景:10 月的 eMudhra 弱 CA 密钥事件

26.3 的收紧不是凭空来的。2026 年 10 月 17 日,研究者报告 eMudhra 的 8 个中间 CA 私钥强度不够,拿到私钥的人可以签发任意网站的证书,再配合网络中间人位置就能冒充 pypi.org 之类的站点。时间线是:

  • 10 月 20 日,Python 安全团队发公告,pip 26.2.2 发布,只干一件事:把自带的 certifi 升到 2026.10.19;
  • 10 月 21 日,CPython 3.15.1、3.14.9、3.13.17 发布,都带 pip 26.2.2;
  • 10 月 25 日,CPython 3.15.2、3.14.10 等发布,在 ssl 模块里直接拉黑了这些弱密钥(CVE-2026-115557),哪怕旧 pip 跑在新 Python 上也能防住。

我实测了证书包的版本:pip 26.2.2 自带 certifi 2026.10.19,pip 26.3 自带 2026.10.23,而且 26.3 的证书包里 emSign ECC Root CA - G3 出现 0 次。Python 3.15.2 自带的 pip 也是 26.2.2,说明只升级 Python 不升级 pip 的话,pip 自己的证书包还是旧的——pip 自带证书,不跟系统走,每个环境都要单独升。

该做什么

  • 升级 pip 到 26.3,每个虚拟环境、每个 CI 镜像都升。python -m pip install --upgrade pip,装完用 pip --version 确认。pip 自带证书包,升系统证书没用。
  • 26.2 到 26.2.2 期间用过 --no-require-hashes 又钉了哈希的,自查一下那段时间装的东西,升级到 26.3 之后再跑一次安装,看哈希还对不对得上。
  • 别再假装装 wheel 不跑代码:私有 index 里只放可信的包;能用 python -P -m pip install 就用这个起手;要求更严的场景用 --only-binary :all:(不装源码包)加 --require-hashes(全量哈希校验)。
  • 在程序里调 pip 的(比如用 pip 模块做 in-process 安装),先把要用的模块 import 好,或者改成子进程调用,不然 26.3 的 import 拦截会直接报错。

验证汇总

检查项实测结果
pip 26.3 发布2026-11-02,更新说明确认
SECURITY.md @26.3 原文已拉取:“pip cannot guarantee that installing a wheel will not execute third-party code”
pip 26.2.2 / 26.3 自带 certifi2026.10.19 / 2026.10.23;26.3 证书包里 emSign G3 为 0
python -P -m pip --versionPython 3.15.2 上正常,pip 26.3
安装期 import 拦截机制26.3 源码确认:_ImportBlocker、BlockedImportError、_warn_unsafe_import
–no-require-hashes 哈希复现26.2.2 退出码 0,装错文件(VALUE=B);26.3 退出码 1,哈希不匹配拒绝安装
HTTP 跳转到 file: URL26.3 拒绝跟随,警告 “a redirect to a non-http(s) location is not allowed”,退出码 1

参考

  • pip 26.3 更新说明:https://pip.pypa.io/en/latest/news/
  • pip 官方安全安装指南:https://pip.pypa.io/en/stable/topics/secure-installs/
  • pip 26.3 安全政策分析(THEXARIS Labs):https://blog.thexaris-labs.com/en/blog/pip-26-3-wheel-install-can-run-code-security-policy-blocked-imports-2026
  • eMudhra CA 事件与 Python 打包工具更新:https://www.stepsecurity.io/blog/emudhra-emsign-ca-compromise-python-pip-ci-cd-update