在恶意包安装之前将其拦截。
开发者和 AI 编程代理每天都在安装软件包。每一次 npm install 或 pip install 都会执行数千行无人审查的代码。
近期热门生态系统中发生的入侵事件:
PMG 免费、开源(Apache 2.0),且无需账户或 API 密钥。 它会拦截每一次软件包安装,并在代码执行之前对照 SafeDep 的免费社区 API 检查是否存在已知恶意软件。对于未知恶意软件,它使用依赖冷却期和可选的沙箱来实现主动安全防御。
PMG 采用纵深防御策略。零配置,可在 Windows 上的 Zsh、Bash、Fish 和 PowerShell 中运行。每一次被拦截的安装都会在代码运行之前经过适用于它的各层保护,并留下审计记录。
npm、pip 及其他包管理器。开发者和 AI 代理使用相同的命令。无需更改工作流程。PMG 将安装时恶意软件拦截、依赖冷却和操作系统原生沙箱整合到一个免费的开源工具中,面向开发者和 AI 编码代理。
| 能力 | PMG | Socket | safe-chain | Snyk | Dependabot |
|---|---|---|---|---|---|
| 开源 / 公开构建 | ✓ | ✗ | ✓ | ✗ | ✗ |
| 无需账户或 API 密钥 | ✓ | ✓ | ✓ | ✗ | ✗ |
| 安装时恶意包拦截 | ✓ | ✓ | ✓ | ✗ | ✗ |
| 依赖冷却策略 | ✓ | ✗ | ✓ | ✗ | ✗ |
| 运行时沙箱 | ✓ | ✗ | ✗ | ✗ | ✗ |
| 透明保护 AI 编码代理 | ✓ | ✗ | ✗ | ✗ | ✗ |
| 本地审计日志 | ✓ | ✗ | ✗ | ✗ | ✗ |
| 已知 CVE 修复 PR | ✗ | ✗ | ✗ | ✓ | ✓ |
注意: 此对比截至 2026 年 10 月准确。
curl -fsSL https://raw.githubusercontent.com/safedep/pmg/main/install.sh | sh
有关 Homebrew、npm 及其他安装方法,请参阅安装。
将 PMG 接入你的 shell,使其能够拦截包管理器。
pmg setup install
# Restart your terminal to apply changes
提示: 升级 PMG 后请重新运行
pmg setup install,以应用新的配置选项。全用户 / 黄金镜像:在 Linux 上运行
sudo pmg setup install --system,或在 Windows 上以管理员身份运行pmg setup install --system—— 参见 docs/system-install.md。
验证你的安装并确认防护已生效:
pmg setup doctor
可选: PMG 使用一个即时生成的 CA 来检查 HTTPS 流量,并在每次运行时将其注入包管理器。若要在多次运行之间持久化同一个 CA,并在操作系统的信任存储中信任它(对于忽略 CA 环境变量的工具是必需的,例如 macOS 和 Windows 上的 Go),请安装一次:
pmg setup cert install # 用户范围,无需 sudo pmg setup cert status # 检查信任状态和过期时间有关作用域、轮换和移除,请参阅 Certificate Authority。
查看 PMG 拦截威胁。
npm install --no-cache --prefer-online [email protected]
# or
pip install --no-cache-dir safedep-test-pkg==0.0.4
注意:
safedep-test-pkg(在 npm 和 PyPI 上)是一个良性测试包,在 SafeDep 的数据库中被标记为恶意,用于 测试和验证目的。
像往常一样继续使用你的包管理器,或者让你的 AI 编码代理来运行它们。PMG 位于路径中,拦截恶意包。
npm install express
# or
pip install requests
PMG 支持你已经在使用的工具:
| 生态系统 | 工具 | 命令示例 |
|---|---|---|
| Node.js | npm | npm install <pkg> |
pnpm | pnpm add <pkg> | |
yarn | yarn add <pkg> | |
bun | bun add <pkg> | |
aube | aube add <pkg> | |
npx | npx <pkg> | |
pnpx | pnpx <pkg> | |
aubx | aubx <pkg> | |
aubr | aubr <script> | |
| Python | pip | pip install <pkg> |
pipx | pipx run <pkg> | |
poetry | poetry add <pkg> | |
uv | uv add <pkg> | |
uvx | uvx <pkg> |
对这些生态系统的支持是实验性的。行为和输出可能在不同版本之间发生变化。
pmg setup install 不会包装这些工具。请通过 pmg 运行它们。
| 生态系统 | 工具 | 命令示例 |
|---|---|---|
| Go | go | pmg go get <module> |
| Rust (crates) | cargo | pmg cargo add <crate> |
注意: 在 macOS 和 Windows 上,
pmg go需要将 PMG CA 安装到操作系统信任存储中。请先运行pmg setup cert install。参见 证书颁发机构。
从 GitHub 下载最新版本,验证其 SHA-256 校验和,并安装到 $HOME/.local/bin(如果该目录在 PATH 中)或 /usr/local/bin。
curl -fsSL https://raw.githubusercontent.com/safedep/pmg/main/install.sh | sh
brew tap safedep/tap
brew install safedep/tap/pmg
每个版本都会附带 pmg_Windows_x86_64.msi。该 MSI 会为所有用户安装 pmg.exe,并运行 pmg setup install --system。请从提升权限的命令提示符中运行它:
msiexec /i pmg_Windows_x86_64.msi /qn
Chocolatey 包安装的是同一个 MSI:
choco install pmg
有关 MDM 部署和升级,请参阅 docs/system-install.md。