资讯动态

AI Agent 供应链安全:HOL Guard 如何拦截恶意 npm 与 PyPI 包安装

发布时间:2026/10/23 1:43:06 来源:尧图企业网站定制
【免费下载链接】hol-guardOpen-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.项目地址https://gitcode.com/gh_mirrors/ho/hol-guard点击查看免费下载当 AI Agent 替你写代码、跑命令时它也可能替你中招。HOL Guard 是一款开源的 AI Agent 安全卫士open-source antivirus for AI agents能在运行时拦截恶意 npm 与 PyPI 包安装、危险命令、密钥泄露与提示词注入是守护 AI Agent 供应链安全的一层本地防护。一、为什么 AI Agent 会带来新的供应链攻击面 ️传统开发中npm install或pip install由人手动敲下装什么包一眼可见。而在 AI Agent 工作流里Codex、Claude Code、Cursor 等Agent 会自主决定并执行安装命令攻击者随之获得了新的入口抢注包名Typosquatting伪造一个和热门库只差一个字母的包名Agent 拼写稍有偏差就装到恶意包安装脚本投毒恶意包的postinstall/preinstall生命周期脚本在安装瞬间执行可窃取环境变量里的 API Key依赖混淆把恶意依赖藏在二级、三级传递依赖中lockfile 稍有漂移即可混入。HOL Guard 的定位正是填补这个空白它在 Agent 动作真正执行之前进行审查把供应链风险挡在安装落盘之前。项目主文档 README.md 中描述其能力为Open-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.二、HOL Guard 拦截恶意包安装的三道关卡 ️关卡 1安装命令执行前就已被接管HOL Guard 通过两条通道确保包安装命令逃不掉审查原生 Agent 钩子以 Codex 为例hol-guard install codex会在 Agent 配置中启用 Guard 拥有的PreToolUse钩子Agent 的每条 Bash 命令在 shell 启动前就交给 Guard 判断详见 docs/guard/get-started.mdPackage Firewall包防火墙 包管理器 shim对 npm、npx、pnpm、yarn、bun、pip、uv、poetry 等十余种包管理器进行统一拦截覆盖矩阵见 docs/guard/command-package-extension-coverage.md。也就是说npm install 恶意包这条命令在 Guard 面前根本没有悄悄执行的机会。关卡 2供应链情报检查——四类信号会立即叫停安装安装前Guard 会拿包和它的依赖去比对供应链情报。根据 docs/guard/package-review-settings.md以下信号在默认balanced级别下会直接暂停或阻止安装风险信号对应场景已知漏洞 / 安全通告包本身或其依赖命中 advisory实时情报来自 Guard Cloud离线时用本地缓存策略包中的恶意/封禁包命中 malware 或 blocked 名单完整性校验失败如 lockfile 哈希与实际不符Guard 自身被非官方源安装防止攻击者通过替换 Guard 自己来关闭防线其余情况Guard 无法识别的包、lockfile 尚未锁定的依赖、直连 Git/URL 安装、自定义仓库等不会误伤但都会被记录并持续跟踪新的威胁情报。关卡 3按策略放行、复审或拦截每个风险信号对应一个可配置的动作。默认balanced级别追求日常依赖工作不打扰、有证据才拦截而strict和paranoid可以逐级收紧allow记录后放行require-reapproval需再次审批如postinstall脚本类信号balanced 级别是警告strict 级别改为必须人工批准block直接拦截paranoid 级别下所有包安装都要过审。本地 Dashboard 的 Extensions 页面会实时显示当前设备的保护状态Guard is actively applying the trusted protection settings并管理检测到的扩展连接三、快速上手3 步启用 AI Agent 包安装防护 前置要求Python 3.10 与 pipxpipx 本身即可通过系统包管理器安装。第 1 步安装 HOL Guardpipx install hol-guard如果希望从源码构建可先克隆仓库git clone https://gitcode.com/gh_mirrors/ho/hol-guard第 2 步运行首次引导hol-guard init向导会逐项询问并获得你批准后才执行打开本地 Dashboard、接入你使用的 Agent如hol-guard install codex、可选的 Guard Cloud 连接。全程先展示计划再逐个副作用确认不会偷偷改动系统。第 3 步体检工作区依赖hol-guard supply-chain sync hol-guard supply-chain scan hol-guard supply-chain explain minimist1.2.5 --ecosystem npmscan会对当前工作区现有依赖给出警告 / 复审 / 拦截判定explain可以针对单个包查询其 advisory 证据与生态覆盖度。目前npm 与 PyPI 生态为 Protected完整保护覆盖Cargo / Go / Maven 等为 Beta。想试装不真装用 dry-run 预览某条安装会怎么被处理hol-guard protect npm install package --dry-runGuard 的 Test Lab 还支持在不执行任何命令的前提下本地推演某条命令会被拦截、放行还是触发审批四、被拦截后审批、追溯与审计 审批交互式终端下会原地询问非交互场景下 Guard 把请求排入本地审批中心用hol-guard approvals查看hol-guard approvals approve request-id批准或deny拒绝会话不会卡死追溯hol-guard receipts查看全部本地决策记录hol-guard diff harness对比自上次快照以来的变化审计导出hol-guard abom --format json可导出一份 AI 物料清单AI-BOM附给审计或交接使用。五、进阶按需调紧供应链安全策略 ⚙️在 Dashboard 设置页或config.toml的[risk_actions]段中可为每类信号单独定级[risk_actions] package_install require-reapproval # 每次包安装都需人工确认可调的信号包括未识别包、lockfile 漂移、直连包源、自定义仓库、包生命周期脚本、以及每一次安装总开关完整对照表见 docs/guard/package-review-settings.md。另外Guard 还会为技能、MCP server、插件查询 HOL Registry 的信任分低于 80 分的产物会自动进入low_trust_artifact复审——供应链防护不止于 npm 和 PyPI。小结 问题HOL Guard 的答案Agent 装到恶意 npm/PyPI 包怎么办安装执行前比对供应链情报命中即拦截或送审会不会误伤日常依赖默认 balanced 级别有证据才拦其余只记录观察想更严格怎么办strict / paranoid 级别 逐信号自定义动作出了事怎么查receipts 决策记录 AI-BOM 审计导出对使用 AI Agent 的开发者而言供应链安全的重心已经从人审依赖转向Agent 行为运行时防护。HOL Guard 本地优先、无需注册即可使用配合可选的 Guard Cloud 团队协作是目前少有的把包安装拦截、命令审查与提示词注入防御做在同一层防护中的开源方案。更多上手细节可查阅 docs/guard/get-started.md各 Agent 的接入覆盖度见 docs/guard/harness-support.md。赞分享【免费下载链接】hol-guardOpen-source antivirus for AI agents: block risky tools, secret access, prompt injection, malicious packages, MCP servers, plugins, and skills at runtime.项目地址https://gitcode.com/gh_mirrors/ho/hol-guard点击查看免费下载相关推荐鸣潮自动清日常实操ok-ww 把日常、自动战斗和刷声骸交给程序鸣潮自动清日常实操ok ww 把日常、自动战斗和刷声骸交给程序 委托加深塔加声骸副本手工清一遍日常至少小半个钟头这期间你还不能碰键盘。ok ww 就是干这RPA计算机视觉Doory如何拦截恶意包CRDT协议安全加固全解析Doory如何拦截恶意包CRDT协议安全加固全解析 Doory 是一个开源的 Canva 替代品open source canva alternativeYarn Berry供应链安全防范恶意依赖包Yarn Berry供应链安全防范恶意依赖包 你是否曾因项目依赖包被植入恶意代码而导致数据泄露是否在安装依赖时担心引入未知风险本文将带你了解如何利用Yar开发工具CLI上一篇Farfalle 开源项目教程构建本地AI搜索引擎的完整指南下一篇MBUtil入门教程从零开始学习MBTiles文件格式转换创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑