悪意のあるnpmおよびpipパッケージをインストール前にブロックします。
既に使用しているパッケージマネージャーに対する多層防御。

PMGが必要な理由

開発者やAIコーディングエージェントは毎日パッケージをインストールしています。それぞれのnpm installやpip installは、誰もレビューしていない数千行のコードを実行します。

人気エコシステムにおける最近の侵害事例:

• Mini Shai-Hulud - 300以上の人気パッケージが侵害されました
• litellm 1.82.8 - 人気のAIプロキシライブラリが侵害され、認証情報が流出しました
• telnyx 4.87.2 - 正規の通信SDKがPyPI上で乗っ取られました
• pino-sdk-v2 - 人気のpinoロガーを装ったタイポスクワットパッケージ

PMGは無料のオープンソース（Apache 2.0）であり、アカウントやAPIキーは不要です。 すべてのパッケージインストールを傍受し、コードが実行される前に、SafeDepの無料コミュニティAPIに対して既知のマルウェアをチェックします。一度インストールすれば、以降のすべてのnpm install、pip install、poetry addをカバーします。

PMGの仕組み

PMGは多層防御アプローチを採用しています。設定不要で、Zsh、Bash、Fishで動作し、各インストールはコード実行前に有効化された保護レイヤーを通過し、その後監査証跡が残ります。

PMGの比較

PMGは、開発者とAIエージェントの両方をカバーし、サンドボックスとクールダウンを標準装備した、唯一の無料・オープンソースのインストール時パッケージファイアウォールです。

クイックスタート

1. インストール

curl -fsSL https://raw.githubusercontent.com/safedep/pmg/main/install.sh | sh

Homebrew、npm、その他のインストール方法についてはインストールを参照してください。

2. セットアップ

パッケージマネージャーを傍受できるようにPMGをシェルに組み込みます。

pmg setup install
# 変更を適用するにはターミナルを再起動してください

ヒント: PMGをアップグレードした後は、新しい設定オプションを反映するためにpmg setup installを再実行してください。

Linuxの全ユーザー / ゴールデンイメージ: sudo pmg setup install --system — docs/system-install.mdを参照してください。

インストールを検証し、保護が機能していることを確認します:

pmg setup doctor

オプション: PMGは、実行ごとにパッケージマネージャーに注入するオンザフライCAでHTTPSトラフィックを検査します。単一のCAを実行間で永続化し、OSのトラストストアで信頼するには（CA環境変数を無視するツール（macOSやWindowsのGoなど）に必要）、一度インストールしてください:

root@kitploit:~

pmg setup cert install          # ユーザースコープ、sudo不要
pmg setup cert status           # 信頼状態と有効期限を確認

スコープ、ローテーション、削除については証明機関を参照してください。

3. 使用

PMGが脅威をブロックする様子を確認します。

npm install --no-cache --prefer-online [email protected]

注: safedep-test-pkgは、テストおよび検証目的でSafeDepのデータベースに悪意のあるものとしてフラグ付けされた無害なテストパッケージです。

通常どおりパッケージマネージャーを使い続けるか、AIコーディングエージェントに実行させてください。PMGはパス上に存在し、悪意のあるパッケージをブロックします。

npm install express
# または
pip install requests

対応パッケージマネージャー

PMGは既に使用しているツールをサポートします:

インストール

curl -fsSL https://raw.githubusercontent.com/safedep/pmg/main/install.sh | sh

brew tap safedep/tap
brew install safedep/tap/pmg

npm install -g @safedep/pmg

# $(go env GOPATH)/binが$PATHにあることを確認してください
go install github.com/safedep/pmg@latest

# 最新イメージをプル（またはバージョンタグを指定、例: :v1.2.3）
docker pull ghcr.io/safedep/pmg:latest

# 任意のpmgコマンドを実行
docker run --rm ghcr.io/safedep/pmg:latest version

GitHub Actions

1ステップでCIワークフローを保護します。PMGはジョブ内のすべてのnpm install、pip installなどを分析します。

- uses: safedep/pmg@v1
  with:
    server-mode: true

# HTTP_PROXY経由で自動的に傍受されます
- run: npm ci

- name: Enforce PMG policy
  if: always()
  run: pmg proxy stop --fail-on-violation   # デーモンを停止し、ブロック時にジョブを失敗させます

デフォルトではマルウェアブロックと依存関係クールダウンが有効です。サンドボックス分離はsandbox入力でオプトインできます。入力（paranoid、sandbox、cooldown-daysなど）で動作を調整するか、config-fileでリポジトリ内のYAMLを指定できます。完全なリファレンスはdocs/github-action.mdを参照してください。

アンインストール

シェル統合を削除します:

pmg setup remove

PMG設定ファイルも削除する場合:

pmg setup remove --config-file

次にPMG自体をアンインストールします:

# Homebrew
brew uninstall safedep/tap/pmg

# NPM
npm uninstall -g @safedep/pmg

信頼性とセキュリティ

PMGのビルドは再現可能で署名されています。

• アテステーション: GitHubおよびnpmのアテステーションが成果物の整合性を保証します。
• 検証: バイナリがソースコードと一致することを暗号的に証明できます。
• 検証手順についてはPMGの信頼性を参照してください。

ユーザーガイド

• 設定
• 信頼済みパッケージの設定
• 依存関係クールダウン
• キャッシュ
• プロキシモードのアーキテクチャ
• 永続プロキシサーバー
• 証明機関
• サンドボックス

サポート

PMGが悪質なパッケージからあなたを守ってくれたなら、このリポジトリにスターを付けてください。他の人が見つけやすくなります。

コントリビューション

コントリビューションを歓迎します。ビルドおよびテスト手順についてはCONTRIBUTING.mdを参照してください。

すべてのコントリビューターに感謝します ❤️

テレメトリ

PMGは匿名の使用状況データを収集します。無効にするには、次のいずれかを実行してください:

• PMG設定ファイルでdisable_telemetry: trueを設定する、または
• PMG_DISABLE_TELEMETRY=trueをエクスポートする。