如何用AIRecon完成第一次自动化渗透测试?新手实战指南
如何用AIRecon完成第一次自动化渗透测试?新手实战指南
AIRecon 是一款开源的 AI 自动化渗透测试智能体,它将自托管的大语言模型(Ollama)、Kali Linux Docker 沙箱和 Textual 终端界面组合在一起,帮你自动完成安全评估、渗透测试和漏洞赏金侦察——全程无需 API Key、不依赖云端。对于新手来说,AIRecon 把原本需要手动执行几十条命令的渗透流程,变成了一次"对话式"的自动化渗透测试。
本文带你从零开始:安装、配置、发起第一次自动化渗透测试,并看懂结果报告。
🧠 AIRecon 是什么?解决什么问题?
传统渗透测试需要人工逐个执行:枚举子域名、扫描端口、爬取网页、指纹识别、漏洞扫描、编写报告……AIRecon 用一条"流水线"把这些环节串起来:
RECON(侦察)→ ANALYSIS(分析)→ EXPLOIT(利用)→ REPORT(报告)
它的核心设计是"后端无关":
- 🖥️ 本地离线:通过本地 OpenAI 兼容网关(LiteLLM / vLLM / Ollama)驱动,目标情报、工具输出和报告全部留在你的机器上,隐私无忧
- 🐳 Kali 沙箱:所有 shell 命令都在隔离的 Kali Linux Docker 容器里执行,内置 nmap、nuclei、sqlmap、ffuf、subfinder 等 60+ 安全工具
- 💬 实时 TUI:Textual 终端界面实时显示 AI 的计划、工具调用与发现结果
上图为 AIRecon 整体架构:Textual TUI 负责交互,Agent Loop 是决策核心,左侧连接 Ollama 大模型,右侧调度 Kali Docker 沙箱、浏览器自动化、报告与文件系统各模块。
📋 安装前准备:硬件与环境要求
开始之前,确认你的环境满足以下基线要求(详见 安装指南):
| 组件 | 基线要求 |
|---|---|
| 操作系统 | Linux / macOS / Windows (WSL2) |
| Python | 3.12+ |
| Docker | 20.10+ |
| LLM 后端 | 任意 OpenAI 兼容网关(本地 Ollama 或托管端点) |
| 磁盘空间 | 40GB 以上(Docker 镜像 + 工具 + 模型权重) |
⚠️ 新手最关键的提醒:模型必须支持原生工具调用(native tool calling),否则智能体无法执行任何工具。本地模型建议使用 8B 以上参数(推荐 32B+),过小模型容易出现工具调用错误和幻觉。
没有 GPU?仓库提供了 Google Colab 笔记本(airecon_colab.ipynb),可以在免费 T4 GPU 上运行 Ollama 模型并通过隧道连接你的本地 AIRecon。
🚀 安装步骤:四步搞定
第 1 步:克隆仓库并运行安装脚本
git clone https://gitcode.com/gh_mirrors/ai/airecon
cd airecon
./install.sh
安装脚本(install.sh)会自动完成:安装 Poetry、清理旧版本、安装依赖、安装 Playwright Chromium(浏览器自动化用)、构建 wheel 包并安装到 ~/.local/bin。
第 2 步:配置 PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
airecon --version # 能显示版本号即成功
第 3 步:构建 Kali Linux Docker 沙箱
沙箱是 AIRecon 执行所有命令的"安全屋",首次构建约需 5–15 分钟:
docker build -t airecon-sandbox containers/
docker images | grep airecon-sandbox
沙箱镜像定义在 containers/Dockerfile 中,内置子域名发现、端口扫描、Web 爬虫、模糊测试、漏洞扫描、SAST 等完整工具链,并附带完整 SecLists 词库。
第 4 步:配置 LLM 后端
编辑配置文件(首次运行会自动生成于 ~/.airecon/config.yaml,完整参数见 配置参考):
openai_base_url: "http://localhost:20128/v1" # 你的本地网关,必须带 /v1
openai_api_key: "" # 本地网关可留空
openai_model: "qwen3:8b" # 网关暴露的模型名
只需关注这三个核心参数:openai_base_url 指向网关地址,openai_model 指定模型,openai_api_key 本地部署可留空。
🎯 发起第一次自动化渗透测试
一切就绪后,在一个专用工作目录中启动 TUI:
cd ~/pentest-projects/
airecon start
首次启动会创建 workspace/ 目录并拉起 Docker 沙箱。连接成功后,你只需用自然语言下达指令,例如:
full recon on example.com # 完整侦察流水线
pentest https://api.example.com # 对 API 做渗透测试
find subdomains of example.com # 只做子域名发现(单一任务)
上图是 AIRecon 的实时 TUI 界面:左侧显示智能体的 ENGAGEMENT PLAN(作战计划)与分阶段目标,右侧 workspace 面板实时展示子域名枚举输出文件,底部状态栏显示 Ollama 连接状态、当前模型和已执行命令数。
📊 看懂四阶段流水线:AI 在做什么?
发出指令后,AIRecon 按四阶段状态机推进(阶段细节见 features.md):
| 阶段 | 目标 | 典型工具 |
|---|---|---|
| RECON 侦察 | 枚举攻击面:子域名、端口、历史 URL | subfinder、nmap、katana、httpx |
| ANALYSIS 分析 | 识别注入点、错误配置、技术栈 | 浏览器自动化、Semgrep 代码审计 |
| EXPLOIT 利用 | 验证并确认漏洞 | sqlmap、dalfox、nuclei、fuzzing |
| REPORT 报告 | 输出带证据的漏洞报告 | create_vulnerability_report |
阶段推进基于真实工具输出自动触发,而非死板的迭代次数。每个发现会标注状态(VALIDATED 已验证 / SUSPECTED 疑似 / INFORMATIONAL 信息级),并附带请求/响应证据文件,存放在 workspace/<目标>/vulnerabilities/ 下——这是新手写报告时最宝贵的素材。
🛟 新手常用 TUI 命令速查
在 TUI 输入框中以 / 开头即可调用命令:
/help 查看所有命令
/status 检查 LLM、Docker、工具健康状态
/scope 设置测试范围白名单(强烈推荐!)
/models 切换模型
/shell xxx 手动在 Kali 沙箱执行命令
💡 给新手的三个实用建议:
- 先设范围再开工:用
/scope allow yourtarget.com限定目标,scope_enforcement设为block可拒绝范围外的操作,防止误伤 - 从小任务开始:第一次别直接
full recon,先用find subdomains of ...这类单一任务熟悉工作流 - 断了能续上:会话持久化在
~/.airecon/sessions/,用airecon start --session <id>可完整恢复聊天记录和工具调用
⚠️ 安全与合规提醒
- 只测试你拥有或获得书面授权的目标,AIRecon 是授权安全测试工具
- 所有命令都会记录在
~/.airecon/audit/audit.jsonl审计日志中,便于事后复核 - 默认
allow_destructive_testing: false,破坏性测试被禁用——保持这个默认值
总结
用 AIRecon 完成第一次自动化渗透测试只需四步:克隆安装 → 构建 Kali 沙箱 → 配置 LLM 网关 → airecon start 下达自然语言指令。从此,RECON → ANALYSIS → EXPLOIT → REPORT 全流水线由 AI 自主驱动,而你的角色从"敲命令的"升级为"审报告的"。
接下来可以探索的方向:为智能体添加自定义技能文件(creating_skills.md)、接入 Caido 代理、或安装本地安全知识库让它"越打越聪明"。

