┌─────────────┐     ┌──────────────┐     ┌───────────┐
│  React SPA  │────▶│  FastAPI      │────▶│  MongoDB  │
│  (Vite)     │ WS  │  后端         │     │           │
└─────────────┘     └──────┬───────┘     └───────────┘
                           │
              ┌────────────┼────────────┐
              ▼            ▼            ▼
        ┌──────────┐ ┌──────────┐ ┌──────────┐
        │  Shodan  │ │  Nuclei  │ │  Redis   │
        │  API     │ │  扫描器  │ │  流      │
        └──────────┘ └──────────┘ └──────────┘

# 克隆
git clone [email protected]:BishopFox/aimap.git
cd aimap

# 配置
cp .env.example .env
# 编辑 .env — 至少设置 SHODAN_API_KEY

# 启动
docker compose up --build

# 后端
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# 前端（另开一个终端）
cd frontend
npm install
npm run dev   # 启动在 http://localhost:5173

# 必需
SHODAN_API_KEY=你的_shodan_api_key

# 可选——Censys 作为额外的发现源
CENSYS_API_ID=
CENSYS_API_SECRET=

# 可选——启用 AI 驱动的攻击分析
ANTHROPIC_API_KEY=

# MongoDB（默认值适用于本地开发）
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=aimap

# Redis（默认值适用于本地开发；可选）
REDIS_URL=redis://localhost:6379/0

# CORS（默认允许所有来源）
CORS_ORIGINS=*

# Modal 无服务器（将扫描/攻击分派到 Modal 容器）
MODAL_ENABLED=false

# Clerk 认证——见下文
CLERK_ISSUER=

protocol:mcp                          # MCP 服务器
auth:none                             # 无认证
risk:critical                         # 风险评分 >= 9.0
risk:high                             # 风险评分 7.0 – 8.9
risk:medium                           # 风险评分 4.0 – 6.9
risk:low                              # 风险评分 1.0 – 3.9
tool:query_db                         # 暴露特定工具的端点
country:US                            # 按国家代码
port:11434                            # 按端口号
org:"Amazon AWS"                      # 按托管组织（引号内多词值）
has:system_prompt                     # 具有泄露系统提示的端点

protocol:mcp auth:none country:US     # 美国境内未认证的 MCP 服务器
risk:critical tool:exec_code          # 具有代码执行工具的严重风险端点
protocol:ollama port:11434            # 默认端口上的 Ollama

aimap/
├── backend/
│   ├── app/
│   │   ├── main.py                  # FastAPI 应用、生命周期、CORS、路由
│   │   ├── config.py                # 从环境变量读取 Pydantic 设置
│   │   ├── auth.py                  # Clerk JWT 验证（CLERK_ISSUER 为空时绕过）
│   │   ├── database.py              # 异步 MongoDB（Motor）连接
│   │   ├── limiter.py               # SlowAPI 速率限制
│   │   ├── routes/
│   │   │   ├── endpoints.py         # CRUD + 搜索 + 地球仪 + 富化
│   │   │   ├── scans.py             # 扫描生命周期 + 执行 + WebSocket
│   │   │   └── attack.py            # 攻击分派 + Redis Streams + WebSocket
│   │   ├── discovery/
│   │   │   ├── orchestrator.py      # 扫描流水线：Shodan → httpx → Nuclei → 导入
│   │   │   ├── shodan_adapter.py    # 32 个策划的 Shodan 查询 + 结果标准化
│   │   │   ├── nuclei_runner.py     # Nuclei 子进程运行器 + 发现解析器
│   │   │   └── base.py              # SourceAdapter 抽象基类
│   │   └── services/
│   │       ├── attack_mcp.py        # MCP 协议攻击引擎
│   │       ├── attack_ollama.py     # Ollama 攻击引擎
│   │       ├── attack_openclaw.py   # OpenClaw/Clawdbot 攻击引擎
│   │       ├── enrichment.py        # Shodan/Nuclei 富化 + 风险评分
│   │       ├── live_probe.py        # 用于模型/工具枚举的 HTTP 探测
│   │       ├── search.py            # Shodan 风格查询解析器 → MongoDB 筛选器
│   │       ├── redis_client.py      # 异步 Redis 单例，带回退
│   │       └── concurrency.py       # 信号量 + 基于 Redis 的槽位限制
│   ├── Dockerfile
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── App.tsx                  # 路由 + Clerk 认证包装
│   │   ├── pages/
│   │   │   ├── Marketing.tsx        # 带 3D 地球仪的公开首页
│   │   │   ├── Landing.tsx          # 带地球仪的认证仪表盘
│   │   │   ├── Search.tsx           # 带查询语法的端点搜索
│   │   │   ├── Explore.tsx          # 浏览/筛选所有端点
│   │   │   ├── AgentDetail.tsx      # 单个端点深度挖掘
│   │   │   ├── TestAgent.tsx        # 攻击测试启动器
│   │   │   ├── Scans.tsx            # 扫描管理
│   │   │   └── Ranges.tsx           # CIDR 范围管理
│   │   ├── components/
│   │   │   ├── GlobeVisualization.tsx  # globe.gl 3D 地球仪 + 图例
│   │   │   ├── Layout.tsx           # 应用外壳（侧边栏 + 导航栏）
│   │   │   └── ui/                  # shadcn/ui 组件
│   │   ├── hooks/useApi.ts          # 所有 API 端点的 SWR 钩子
│   │   └── lib/api-client.ts        # 带 Clerk 令牌注入的 fetch 包装
│   ├── Dockerfile
│   ├── nginx.conf
│   └── tailwind.config.js
├── templates/                       # Nuclei YAML 模板
├── docs/                            # GitHub Pages 静态站点
├── docker-compose.yml
├── .env.example
└── README.md

MODAL_ENABLED=true