♧ Godown 安全知识树

Python .pth 启动自加载后门:site-packages 中的 .pth 在每次 python 进程启动时执行(LiteLLM 1.82.7/1.82.8 投毒)

pentest/persistence · verified

一句话结论

Python 的 site.py 在解释器启动时会扫描 site-packages/ 下的 .pth 文件,并把其中以 import 开头的行直接 exec();攻击者只要能把一个恶意 .pth 写进 site-packages/(例如通过被投毒的 PyPI 包),此后该机器上每次运行任意 Python 进程——哪怕不 import 该库、只是执行 python——都会自动执行恶意代码,形成隐蔽的启动级持久化。

原理

  • .pth 的正规用途:Python 用 .pth 文件在启动时向 sys.path 添加额外目录,是官方支持的站点配置机制。
  • 执行逻辑:site.py 的 addpackage() 读取 .pth 内容,逐行处理:忽略空行与 # 开头行;对以 import 或 import\t 开头的行,直接 exec(line);其余行才作为路径加入 sys.path。因此一行 import os; os.system('calc') 就是可执行代码。
  • 自动触发范围:默认只处理 site-packages/ 下的 .pth,而每个 Python 进程启动都会经过 site 初始化,所以恶意 .pth 一旦落盘就是全局、跨项目的持久化,且不依赖目标项目 import 恶意库。
  • 投放方式:LiteLLM 1.82.7/1.82.8 事件中,攻击者入侵 CI/CD 依赖的 Trivy 扫描器,在构建流水线中把 litellm_init.pth 打进 wheel;pip install 后文件被释放到 site-packages/,所有安装该版本的机器中招。
  • 隐蔽性:.pth 是标准库认可的配置,文件名与内容容易混入正常站点配置;相比修改启动脚本或注册表,更不容易被常规主机排查发现。
  • 局限:必须以某种方式写入 site-packages/(包安装、CI 构建、文件写漏洞、管理员操作);普通用户目录下的 .pth 不会被自动加载(需 site.addsitedir(),见关联卡)。

触发条件

  • 目标机器安装了包含恶意 .pth 的 Python 包(供应链投毒/恶意 wheel),或攻击者已有写入 site-packages/ 的权限。
  • Python 以默认方式启动(未使用 -S 跳过 site 初始化)。
  • 恶意 .pth 中的代码在目标环境可执行(有相应解释器与权限)。

利用步骤

  1. 在 wheel/sdist 中加入恶意 .pth 文件,使其安装后落在 site-packages/(LiteLLM 事件即通过 CI 流水线注入)。
  2. .pth 内容写入一行以 import 开头的代码,例如 import os; os.system('<payload>')。
  3. 受害者执行 pip install 安装包;此后每次运行任意 Python 程序(包括 python 交互式 CLI)都会触发。
  4. 验证:在目标上运行 python -c "print(1)",观察 payload 是否执行;检查 site-packages/*.pth 中是否有非路径行。
  5. 持久化:无需额外自启动项,卸载包或删除 .pth 前一直生效;可结合其他机制防止被清理。

PoC

# site-packages/evil.pth(文件名不能以 . 开头,必须以 .pth 结尾)
import os; os.system('calc')
# 安装/写入后,任意 python 进程启动即触发
python -c "print('hello')"
# 计算器弹出,随后打印 hello

排查:

# 列出 site-packages 下所有 .pth 及其中的 import 行
python -c "import site; print(site.getsitepackages())"
grep -RInE '^import[[:space:]]' /path/to/site-packages/*.pth

变体与关联

  • 变体:恶意 .pth 可写入多行 import 代码,或先 import 一个同目录下的恶意模块再执行。
  • 变体:通过依赖混淆、typosquatting、CI/CD 凭据泄露、构建缓存污染等方式把 .pth 送进 site-packages。
  • 关联:[[ai-security-supply-chain-python-pth-addsitedir-model-disguise]]——同一 .pth 机制的另一条路径:不写入 site-packages,而是由仓库脚本调用 site.addsitedir() 加载隐藏目录中的 .pth。
  • 关联:[[ai-security-supply-chain-ai-codegen-prompt-npm-install-rce]]——AI 供应链投毒的另一类入口。
  • 边界:python -S、只读/隔离的虚拟环境、严格的包签名与哈希校验可降低风险;.pth 只在 site 初始化路径下自动执行。

检测与防御

  • 检测:site-packages 中出现新增/异常的 .pth 文件;.pth 内出现 import 开头的可执行行而非纯路径;包安装后出现计划外进程/网络连接;Python 进程启动即触发 payload。
  • 修复:使用锁文件与哈希校验(pip install --require-hashes)、私有镜像与包签名验证;CI/CD 中隔离并审计构建依赖(如 Trivy 等扫描器)的版本与完整性。
  • 加固:生产环境使用不可变镜像/只读 site-packages;监控 site-packages 文件变更;以最小权限运行 Python 服务;对高风险环境可用 python -S 或显式 site 配置。
  • 响应:发现恶意 .pth 后删除文件、重装受影响包、轮换构建凭据,并排查同批次构建产物。