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中的代码在目标环境可执行(有相应解释器与权限)。
利用步骤
- 在 wheel/sdist 中加入恶意
.pth文件,使其安装后落在site-packages/(LiteLLM 事件即通过 CI 流水线注入)。 .pth内容写入一行以import开头的代码,例如import os; os.system('<payload>')。- 受害者执行
pip install安装包;此后每次运行任意 Python 程序(包括python交互式 CLI)都会触发。 - 验证:在目标上运行
python -c "print(1)",观察 payload 是否执行;检查site-packages/*.pth中是否有非路径行。 - 持久化:无需额外自启动项,卸载包或删除
.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后删除文件、重装受影响包、轮换构建凭据,并排查同批次构建产物。