如果你在 2026 年 11 月 17 日前后用 pip 装过微软 Agent Framework 的 1.26.1 或 1.26.2,处理重点不是删掉这个包,而是按“这台机器能碰到哪些凭据”排出轮换顺序。恶意版本已被 PyPI 隔离,但装过的 VPS、开发机和 CI Runner 仍应逐项核对令牌暴露面,先换权限最大的,再换影响面小的。

先把事件压缩成三句话
据 IT之家 2026 年 11 月 19 日报道(转述 TechRadar,原文链接),微软在 PyPI 发布的 Agent Framework Python 包被劫持,11 月 17 日出现 1.26.1 版本,恶意代码会在 Python 启动时执行,目标是 Azure、AWS、GitHub、Docker、Hugging Face、OpenAI 等服务的登录凭据。
PyPI 约 31 分钟后隔离了 1.26.1;约两分钟后 1.26.2 出现,增加了 GitHub Actions OIDC 令牌请求能力并能搜索 GitHub Runner 目录,发布约 8 分钟后被清除。报道时点该包月下载量接近 20 万次,这是媒体引用的数据,不代表当前下载量。
是否已造成实际凭据泄露、影响多少开发者,来源明确表示尚不清楚;恶意代码的实现细节与回连地址也未公开。微软与 PyPI 的正式公告原文本次未获取,以上细节以媒体转述为准,后续如有官方口径应以官方说明为准。
为什么 VPS 用户要先看“凭据”,而不是先看“包”
在 VPS 或云主机上,pip 安装通常由部署用户执行,很多教程还习惯加 sudo 或直接用 root。这意味着一次安装动作继承的是整台机器的权限,而不是某个项目的权限。同一台机器上往往同时躺着云厂商 API Key、GitHub Token、Docker 仓库登录信息、AI 服务密钥,以及散落在各目录的 .env 文件。
所以判断影响面时,问题不是“我有没有用这个包做业务”,而是“装包的那个环境能读到哪些密钥”。一台只跑静态站的低权限 VPS,和一台挂着生产云账号密钥、又兼做 CI Runner 的构建机,处置优先级完全不同。
按暴露面给凭据排优先级
下面这张表不是让你照单全换,而是帮你决定先动哪一类。判断依据是权限范围、是否长期有效、泄露后能否被静默滥用。
| 凭据类型 | 风险特征 | 建议顺序 |
|---|---|---|
| AWS 访问密钥、Azure 服务主体凭据 | 权限大、长期有效,可创建资源或读取数据 | 最先处理 |
| GitHub 个人访问令牌、部署密钥 | 可改代码、读私有仓库,可能触发流水线 | 紧随其后 |
| GitHub Actions OIDC 相关配置 | 可换取云平台短期令牌,需检查信任策略 | 与 GitHub 令牌同批 |
| Docker 仓库登录信息 | 可推送镜像,存在被替换镜像的风险 | 第二批 |
| Hugging Face、OpenAI 等 AI 服务 Key | 多为计费类,泄露直接产生费用 | 第二批 |
| 数据库密码、对象存储密钥 | 影响业务数据,需评估是否与其他系统共用 | 按业务影响排 |
顺序的逻辑很简单:能被用来“新建资源、改代码、换镜像”的凭据优先,因为它们能把一次泄露放大成持续控制;只能产生费用的密钥排在后面,但仍要换。
确认这台机器到底装过什么
不要只看项目目录里的 requirements 文件,直接查环境里实际安装的版本:
python -m pip list | grep -i agent-framework
# 系统级 Python 与虚拟环境要分别查
/usr/bin/python3 -m pip list | grep -i agent-framework
输出为 1.26.1 或 1.26.2 才属于受影响范围。如果显示 1.26.0 或更早,当前环境没有装到恶意版本;但如果你在 11 月 17 日当天执行过不带版本号的升级,仍要回看当时的安装日志或构建记录,确认实际拉取的是哪个版本。
容易漏查的位置包括:CI 构建镜像、临时容器、本地开发机的全局环境、以 root 装过包的系统 Python。这些环境通常不在日常巡检里,却经常持有令牌。
卸载之后还要清缓存和看依赖树
确认装过就先卸载,再清掉 pip 缓存,避免后续安装又从本地缓存取到同一个包文件:
python -m pip uninstall agent-framework
python -m pip cache purge
如果这个包是被其他依赖间接拉进来的,卸载后要重新检查依赖树,确认没有别的包把它作为依赖再装回来。可以用下面的方式查看谁依赖它:
python -m pip show agent-framework
# 或安装 pipdeptree 后查看反向依赖
pipdeptree --reverse --packages agent-framework
清缓存不影响业务数据,代价只是下一次安装重新从源站下载。卸载和清缓存只能止损,不能证明恶意代码没有执行过,只要装过就应继续处理凭据。
轮换时别只改密码
轮换的核心是让旧凭据失效,而不是新增一个可用凭据。只改密码、保留旧令牌有效,等于没有处理。具体做法按平台不同,但原则一致:
- 云平台长期密钥:先停用或删除旧密钥,再创建新密钥并更新到部署配置;
- GitHub 令牌:吊销旧令牌,新建时收窄 scope,只给当前仓库和必要权限;
- Docker 仓库:重新生成访问令牌,检查是否有异常镜像推送记录;
- AI 服务 Key:作废旧 Key,核对账单是否有非预期调用;
- .env 与配置文件:逐台确认哪些文件含密钥,改完后检查是否还有旧值残留。
对 CI 场景,优先把长期密钥换成短期、最小权限的令牌。例如让流水线通过 OIDC 换取云平台临时凭据,而不是把长期 Access Key 写进仓库变量。这样即使构建环境被投毒,攻击者拿到的也是短时有效、范围受限的令牌。
查未授权访问时看什么
轮换之后回看审计日志,重点找 11 月 17 日前后出现的异常登录、异常 API 调用、新建的访问密钥、新增的仓库协作者或 Runner。不同平台入口不同,判断思路一致:谁在什么时间从哪里做了什么,把不认识的来源单独列出来核实。
发现可疑活动时先保留日志再处置,不要急着删除记录。同时评估是否需要收紧安全组、禁用可疑密钥、检查是否被创建了后门账号。对使用 VPS 跑自动化脚本的用户,还要看 crontab、systemd 服务里有没有新增的陌生任务。
把这次事件变成部署习惯
事后排查成本高,更值得做的是把依赖安装和凭据管理分开:
- 生产机不放构建凭据,构建与部署使用独立环境;
- 锁定依赖版本,升级前先看版本号和变更记录,不盲目装最新版;
- CI 使用最小权限、短期有效的令牌,减少长期密钥留在构建机上的必要;
- 定期梳理服务器上哪些目录存有 .env 和密钥文件,缩小暴露面。
这些做法不能保证不再遇到供应链事件,但能把单次事件的影响控制在更小范围。对预算有限的小团队,至少先做到“构建机不挂生产密钥”这一条,收益最直接。
常见问题
只在本地开发机装过,VPS 没装,要处理吗?
要看开发机上放了什么。如果开发机的环境变量或配置文件里有云平台密钥、GitHub 令牌,同样需要轮换,因为这些凭据不区分机器类型。只装过但机器上没有任何有效凭据,风险相对小,仍建议卸载并清缓存。
CI 里装过,但生产服务器没装,影响大吗?
取决于 CI Runner 挂了哪些权限。报道提到 1.26.2 具备请求 GitHub Actions OIDC 令牌和搜索 Runner 目录的能力,构建环境本身可能成为入口。建议检查 CI 令牌权限范围,并确认构建日志里是否出现过这两个版本号。
卸载后还需要重装系统吗?
没有统一答案。如果确认装过恶意版本、且机器上存有高权限云凭据,重装是彻底清除未知残留的一种方式;如果只是低权限测试环境、凭据已全部轮换,可以先按卸载、清缓存、查日志的顺序处理,再根据审计结果决定。无论哪种选择,凭据轮换都应先做。
怎么避免下次再遇到类似情况?
没有一劳永逸的办法,但可以降低概率和损失:安装前确认包名与版本,优先从官方源拉取,生产环境锁定版本并保留变更记录,构建与生产分离,凭据按最小权限发放并定期轮换。
转载请注明出处:https://www.zhujixuan.com/kejidongtai/100567.html 商家投稿邮箱:zhujixuanblog@qq.com
