面向渗透测试人员的终端 AI 智能体 CLI,人类全程掌控,覆盖侦察、验证与取证报告。
zakirkun/guardian-cli
基于 Python 的命令行工具,利用 Gemini、GPT、Claude 等大模型编排渗透测试流程,并调用 nmap、nuclei 等安全工具。
- Star
- 1,895
- Fork
- 368
- 未关闭 Issue
- 5
- 最近提交
- 4个月前
这是什么?
Guardian 是一个用于自动化渗透测试的命令行框架。AI 智能体负责规划测试步骤、选择要运行的安全工具并分析输出,每次工具执行都会被记录,因此每个发现都能追溯到产生它的命令。
它支持多家 AI 服务商,包括 OpenAI、Claude、Gemini、OpenRouter、Requesty、Ollama 以及兼容 OpenAI 接口的端点。项目内置约 50 个工具封装,涵盖网络扫描、Web 信息收集、子域名发现、漏洞扫描、SSL/TLS 检测、云与容器审计,以及 Active Directory 和 Android 应用评估。工作流使用 YAML 以依赖图的形式定义,步骤可并行执行,中断后可恢复。
报告可导出为 Markdown、HTML 或 JSON,发现结果也可导出为 SARIF,或推送至 DefectDojo 和 Slack。工具内置范围校验、对高强度工具的执行确认机制,并在日志中脱敏 API 密钥。Guardian 仅适用于获得授权的测试目标。
核心功能
- 01支持多家 AI 服务商进行规划与工具选择,包括 Gemini、OpenAI、Claude 及本地 Ollama 模型。
- 02封装约 50 个安全工具,覆盖网络、Web、云及移动端等类别。
- 03YAML 工作流支持基于依赖关系的并行执行,并可断点恢复。
- 04证据留存机制将每个发现关联到其来源的工具执行记录。
- 05报告可导出为 Markdown、HTML、JSON 和 SARIF,并支持 DefectDojo 与 Slack 集成。
- 06内置范围校验,对高强度工具设有执行确认环节。
适用场景
- 对已获授权的系统进行可重复的信息收集与 Web 漏洞扫描。
- 生成带证据的结构化渗透测试报告,并导出至缺陷平台或 SARIF 代码扫描系统。
- 借助 Ollama 本地模型,探索大模型驱动的安全自动化。
快速上手
- 1
克隆仓库
git clone https://github.com/zakirkun/guardian-cli.git - 2
进入项目目录
cd guardian-cli - 3
创建虚拟环境并安装(Linux/macOS)
python3 -m venv venv && source venv/bin/activate && pip install -e . - 4
验证安装
python -m cli.main --help
使用前须知
- 需要支持的AI服务商(如OpenAI、Anthropic、Google、OpenRouter或Requesty)的API密钥。
- 许多安全工具为可选项,需单独安装才能获得完整功能。
- 元数据中许可证显示为NOASSERTION,而README称为MIT,使用前请查看LICENSE文件。
- 仅限于获得授权的安全测试,使用者需承担相应法律责任。
标签
常见问题
- guardian-cli 是什么?
- 基于 Python 的命令行工具,利用 Gemini、GPT、Claude 等大模型编排渗透测试流程,并调用 nmap、nuclei 等安全工具。 Guardian 是一个用于自动化渗透测试的命令行框架。AI 智能体负责规划测试步骤、选择要运行的安全工具并分析输出,每次工具执行都会被记录,因此每个发现都能追溯到产生它的命令。
- guardian-cli 可以免费使用吗?用的什么许可证?
- guardian-cli 以 Other 许可证开源。用于商业产品前,请先确认许可证条款。
- guardian-cli 还在维护吗?
- 半年内有更新。guardian-cli 最近一次提交是在 2026年6月27日。
- guardian-cli 适合用来做什么?
- 对已获授权的系统进行可重复的信息收集与 Web 漏洞扫描。 生成带证据的结构化渗透测试报告,并导出至缺陷平台或 SARIF 代码扫描系统。 借助 Ollama 本地模型,探索大模型驱动的安全自动化。
- guardian-cli 怎么安装和运行?
- 克隆仓库: git clone https://github.com/zakirkun/guardian-cli.git 进入项目目录: cd guardian-cli 创建虚拟环境并安装(Linux/macOS): python3 -m venv venv && source venv/bin/activate && pip install -e . 验证安装: python -m cli.main --help
- 在哪里获取 guardian-cli?
- 源代码和安装说明在 GitHub 上:https://github.com/zakirkun/guardian-cli
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一款 Python 命令行工具,当配对的蓝牙手机或智能手表超出范围时自动锁定电脑。
一个能从经验中创建并改进技能的自我进化 AI 智能体,支持多种模型服务商,可通过命令行和即时通讯工具使用。
为现有软件自动生成面向 AI 智能体的命令行接口,并提供 CLI-Hub 注册表用于安装现成的 CLI。
一个命令行工具,统一调用 Google Workspace 的 Drive、Gmail、日历、表格、文档、Chat 等 API,输出结构化 JSON。
一个用 Go 编写的跨平台任务运行工具,受 Make 启发,通过 YAML 格式的 Taskfile 进行配置。