airecon

环境要求

• Python 3.12 及以上
• Docker 20.10 及以上（提供 Kali Linux 沙箱）
• git 与 curl
• 一个 OpenAI 兼容的 LLM 网关地址（如本地网关 http://localhost:20128/v1，可代理本地 Ollama/vLLM）
• 无 GPU 或显存不足时，可用带 T4 GPU 的 Google Colab 跑模型并通过隧道接入

安装与启动步骤

1. 1确认环境依赖

   先确认本机已装 Python 3.12+、Docker 20.10+、git、curl，并准备好一个可访问的 OpenAI 兼容网关地址（本地或托管均可）。

2. 2一键脚本安装

   官方推荐方式。脚本会自动识别远程/本地模式，缺少 Poetry 时用官方安装器装上，构建 wheel 并装到 ~/.local/bin。

   curl -fsSL https://raw.githubusercontent.com/pikpikcu/airecon/refs/heads/main/scripts/install.sh | bash

   复制

3. 3或从源码手动安装

   克隆仓库后进入目录执行仓库内的 install.sh，效果与一键脚本一致，适合需要改代码的用户。

   git clone https://github.com/pikpikcu/airecon.git
   cd airecon
   ./install.sh

   复制

4. 4编写配置文件

   首次运行会自动生成 ~/.airecon/config.yaml，按需填入网关地址、模型名与超时/上下文参数；本地网关时 api_key 可留空。

5. 5启动 TUI

   在终端执行启动命令进入 Textual 实时界面，之后直接用自然语言给出目标即可自动推进侦察与测试。

   airecon start

   复制

6. 6恢复历史会话

   需要接着上次的进度继续时，用 --session 指定会话 ID，会重放之前的对话与工具调用记录。

   airecon start --session <session_id>

   复制

关键配置

如何确认成功

运行 airecon start 能进入 Textual 界面，并在 TUI 中输入 /status 查看 LLM、Docker 与工具的健康状态。

常见问题

注意事项

• 安装脚本会把程序装到 ~/.local/bin，若该目录不在 PATH 中需自行加入。
• T4 + qwen3.5:9b 是最低可用配置，响应更慢、工具调用出错率高于本地 35B 以上模型，不适合长时间自主会话。
• Docker 用于提供隔离的 Kali Linux 沙箱，请确保 Docker 服务处于运行状态。
• 请在获得明确授权的目标上使用本工具，避免对非授权系统发起扫描或测试。