返回更新列表
新发布Sep 5, 2026

node9-proxy v2.8.3

面向智能体时代的执行安全层。为自主AI代理提供确定性的“Sudo”治理与审计日志。

分享

🛡️ node9

面向 AI 代理的访问控制

你的 AI 代理可以访问 Slack、GitHub、电子邮件和你的数据库。
node9 决定它们可以对每一项做什么。

npm version monthly downloads License: Apache 2.0 Documentation OpenSSF Best Practices OpenSSF Scorecard node9 self-scanned Mentioned in Awesome Claude Code

凭据隔离 · 机密与 PII · 破坏性 git、SQL 和 shell 操作被拦截待审 · MCP 工具固定 · 网络出口允许列表 · 循环中断器 · 跨十二个代理的统一记录

适用于 Claude Code · Codex CLI · Antigravity (agy) · GitHub Copilot CLI · Gemini CLI · Cursor · Windsurf · VSCode · Claude Desktop · Opencode · Pi · Hermes Agent · 任何 MCP 服务器。

三种接入方式

查看在每次拉取请求时扫描仓库,或检查本机。无需安装任何东西。扫描每次拉取请求
防护将 node9 置于代理发起的每次工具调用之前:允许、阻止或为你拦截待审。防护你的代理
证明为团队运行的每个代理和每台机器生成一份 OWASP Agentic Top 10 报告。向团队证明

扫描每次拉取请求

本仓库同时也是 GitHub Action node9 Agent Security。 它读取提交到仓库中的代理配置(工作流、代理设置、MCP 服务器、指令文件),并报告拉取请求可能对你造成哪些不利影响。不会运行任何内容,不会安装任何代理,也无需账户和密钥:作业令牌就足够了。

添加一个文件,.github/workflows/agent-security.yml:

name: node9 agent-security
on: pull_request
permissions:
  contents: read
  pull-requests: write
  checks: write
jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: node9-ai/node9-proxy@v2
        with:
          fail-on: high # never | medium | high | critical
          fail-on-scope: introduced # judge only what this PR added or made worse

每个拉取请求随后会得到:

  • 一项检查,按你选择的严重级别通过或失败。
  • 一条评论,以通俗语言首先呈现最严重的问题及修复方法,并在每次推送时原地更新。
  • 注解,标注在引发问题的代码行上。

它检查什么

陌生人可操控的工作流将 issue 或拉取请求的文本交给持有密钥或可执行命令的 agent 的工作流,或在 fork 的代码中运行该 agent 的工作流
Agent 设置覆盖凭据或任意命令的允许规则、获取远程代码的钩子、误提交的本地设置
MCP 服务器与插件安装最新版本的服务器、写入配置中的凭据
可触及的密钥工作流中的 agent 可读取的密钥,以及它可能泄露这些密钥的方式
指令文件与技能隐藏字符、指示 agent 放弃其指令、获取并服从某个页面或向外发送数据的文本

在任何人可提交 agent 会读取的 issue 的仓库中,评论如下:

🛡️ node9 agent-security · 🔴 高危:需要采取行动

任何人都能让此仓库的 AI agent 以其权限行事

陌生人提交了一个包含给 agent 指令的 issue。agent 会以此 仓库的权限遵循这些指令。

我们在 .github/workflows/triage.yml:13 中看到:

  • 任何人都能启动该 agent(allowed_non_write_users: "*")。
  • 它会读取拉取请求或 issue 的文本。
  • 它可以运行任意命令(Bash)。

✅ 如何修复:

  1. 仅允许具有写权限的人启动它:移除 allowed_non_write_users: "*"。
  2. 仅向 agent 提供该任务所需的工具。

还发现:

  • 🟡 MCP 服务器 files 每次都会安装最新版本(.mcp.json)

输入

输入默认值
fail-onnever导致检查失败的严重级别:never 表示仅评论而不设门禁,medium、high 或 critical。
fail-on-scopeallintroduced 仅评判拉取请求新增或加剧的问题,因此已有发现的仓库可以立即启用门禁。
commenttrue在拉取请求上发布评论。
annotatetrue在差异上标注发现的问题。
node9-versionlatest执行扫描的 node9-ai 版本。固定该版本以获得可复现的运行结果。
node9-upload-key空可选。将每次推送扫描发送到你的 node9 工作区,从而按仓库保留历史记录。留空则不发送任何内容。
telemetrytrue每次运行的匿名使用计数:扫描器版本、操作系统、最严重级别、扫描是否完成,以及仓库数字 ID 的哈希值(node9 仅在计数内部保留该哈希)。绝不包含仓库名称、路径、发现的问题或任何代码。

在 pull_request_target 下,该 Action 不会执行扫描,并会明确说明这一点:因为在该事件下它读取的是基础分支,而非拉取请求。完整参考见 仓库扫描文档。

立即检查某个仓库或本机

无需工作流、无需安装、无需账户。scan-repo 会发送与该 Action 相同的匿名使用计数(不含仓库名称、不含代码);设置 NODE9_NO_TELEMETRY=1 可将其关闭。

npx node9-ai scan-repo owner/repo   # the same scan as the Action, on any public repository
npx node9-ai posture                # scores this machine 0-100: what a compromised agent could read, reach and run
npx node9-ai scan                   # every past agent session on this machine

node9.ai/scan 上的托管扫描会在浏览器中完成第一项检查。

node9 scan scorecard

保护你的智能体

分类