fix CVE-2026-8643, Reject entry point names that escape scripts dir (#14000) · Pull Request !6 · OpenCloudOS Stream/python-pip

### 1. 漏洞介绍

该漏洞是 pip 在安装 wheel 包时处理 `console_scripts` / `gui_scripts` entry point 名称不当导致的路径穿越问题。

恶意 wheel 可以在 `entry_points.txt` 中构造特殊脚本名，例如包含 `../`、`.`、`..` 或绝对路径的 entry point 名称。pip 在安装 wheel 时会根据这些 entry point 生成脚本 wrapper，并写入 `scheme.scripts` 目录。

问题在于，脚本名来自 wheel 元数据，pip 之前只把它传给 distlib 生成脚本，没有检查最终生成路径是否仍位于 `scheme.scripts` 目录下。如果脚本名能逃逸该目录，就可能导致 pip 将生成的脚本写到目标目录之外，覆盖安装用户有权限写入的文件。

影响主要是文件覆盖，写入内容是 pip 生成的 entry point wrapper，不是完全任意内容。但如果用户使用 `sudo pip install` 或在敏感目录下安装，影响会扩大，可能造成系统文件破坏、服务异常，甚至在特定场景下导致代码执行。

### 2. upstream 的修复方式

upstream 的修复思路是在 pip 调用 distlib 生成脚本之前增加校验。

具体方式是：

- 新增一个路径检查函数，用于判断 entry point 名称拼接到 `scripts_dir` 后，规范化后的路径是否仍位于 `scripts_dir` 内。
- 修改 entry point 校验逻辑：
  - 如果 entry point 解析失败，则跳过；
  - 如果缺少 callable suffix，继续按原逻辑报错；
  - 如果 entry point 名称会导致生成脚本路径逃逸 `scripts_dir`，则抛出 `InstallationError`。
- 在 `PipScriptMaker.make()` 中传入当前 `target_dir`，让校验逻辑知道脚本应被限制在哪个目录内。
- 增加测试，覆盖：
  - `console_scripts` 和 `gui_scripts` 中的恶意名称会被拒绝；
  - `.`、`..`、`../outside`、绝对路径等非法名称会被拒绝；
  - 正常脚本名、子目录内脚本名等不会被误拒绝。

整体上，upstream 是在 pip 层做输入路径约束，防止 distlib 根据不安全 entry point 名称写出 `scripts_dir`。

### 3. 针对 upstream 的适配方式

当前仓库版本和 upstream patch 基线不完全一致，因此做的是 backport 适配，而不是原样套补丁。
![输入图片说明](https://foruda.gitee.com/images/1780045592990171872/e3e28760_5607013.png "屏幕截图")
适配点主要包括：
- 按当前仓库的类型标注风格调整代码：
  - 当前仓库使用 `Optional[Dict[str, Any]]`、`List[str]`；
  - upstream 新版本使用 `dict[str, Any] | None`、`list[str]`。
- 测试用例错误信息构造按当前仓库风格处理，避免引入不必要的语法或风格差异。

Type	Assign personnel	Status
Reviewer	ocs-bot	In progress (0/1 )
Tester	ocs-bot	In progress (0/1 )

OpenCloudOS Stream/python-pip .gitee-modal { width: 500px !important; }

Search

OpenCloudOS Stream/python-pip