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 那篇分析里的方法,在本地复现了一遍:
- 造了一个
demopkg 1.0,打包出两个 wheel:文件名完全一样,内容一个是VALUE = "A",一个是VALUE = "B",sha256 各不相同:
wheelA: 1d874b60c2fa9795eca873169700f285768155e2d4ac189f7c898c1981eb3c6e
wheelB: 2113506e1d621aaa1efe87cc58413fc910088a1ba855136ad99b5a33c62a3e6f
- requirements 文件钉的是 A 的哈希:
demopkg==1.0 --hash=sha256:1d874b60c2fa9795eca873169700f285768155e2d4ac189f7c898c1981eb3c6e
本地搭一个 simple index,只提供 B 这个文件,并且链接里带上 B 自己的哈希。
两边都用
--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 自带 certifi | 2026.10.19 / 2026.10.23;26.3 证书包里 emSign G3 为 0 |
python -P -m pip --version | Python 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: URL | 26.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