Repolode
zakirkun

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. 1

    克隆仓库

    git clone https://github.com/zakirkun/guardian-cli.git
  2. 2

    进入项目目录

    cd guardian-cli
  3. 3

    创建虚拟环境并安装(Linux/macOS)

    python3 -m venv venv && source venv/bin/activate && pip install -e .
  4. 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 数据每日更新。

相关项目