FofaMap 2.0.2

证据驱动的 AI 资产测绘与安全研判工具。

FofaMap 由 Hx0 工作室开发，将 FOFA 资产发现、AI 反思、Nuclei 授权验证与交互式报告融入同一工作流，让查询依据、分析过程与验证结果可追溯、可复核。

安装与开始使用

新用户推荐下载下方的 FofaMap-2.0.2-source.zip 并完整解压。

• Windows： 双击 install.bat。
• macOS： 双击 install.command；也可在终端运行 bash install.sh。
• Linux： 在解压目录运行 bash install.sh。

先选择简体中文 / English，再选择安装。安装器准备独立 Python 和依赖，注册用户级 fofamap 命令，随后引导填写 FOFA API Key；普通查询不需要模型 Key。安装后新开终端输入 fofamap 即可打开。再次运行安装器可修复或卸载，默认保留配置、密钥、结果、报告和备份。

已有一键安装器环境可运行 fofamap --update；从旧版 2.0.1 源码迁移时，请下载完整新源码包并执行安装器，不要把旧 .venv 直接复制到新目录。

中文使用手册 · English guide

2.0.2 的主要变化

• 三平台安装管理： 安装、修复、卸载；缺少 Python 时自动准备独立环境；支持 Windows 11 ARM 的 x64 Python 环境。
• 更直接的配置： 安装时选择语言并保存；首次或失效凭据引导；DeepSeek 推荐优先，补充常用模型预设。
• 保留经典查询：-q / -ai / -hq / -cq / -ico / -bq 继续可用。智能字段在页数后直接选择，也可保存默认偏好。
• 31 个 MCP 工具与配套 Skill： 改进分页、异步任务、取消、错误和用量反馈；报告默认沿用界面语言，也可显式覆盖。
• 授权扫描： 用户明确的扫描 / 不扫描指令优先于 AI 建议，精确方案仍需确认。缺少 Nuclei 时先询问 Y/N，只有同意才下载官方程序和模板。
• 测绘与交付： 定时任务、快照变化、Markdown / HTML 报告、交互表格与 CSV / JSONL / XLSX 导出。
• 双语用户文档： 从安装、填 Key 到第一次查询逐步展开，配有真实任务结果图和同款中英文封面。

下载文件说明

文件	用途
FofaMap-2.0.2-source.zip	推荐的完整用户包，含三平台安装器、源码、MCP/Skill、文档与配图
fofamap-2.0.2-py3-none-any.whl	面向已有 Python 环境的 pip 安装包；不是独立 Windows EXE
fofamap.skill	支持导入 .skill 的宿主使用；MCP 服务仍需按文档配置
SHA256SUMS	以上下载文件的 SHA-256 校验值

普通用户无需下载测试或开发材料，本次发行也不包含这些材料。本地账号配置、.env、密钥、数据库、日志、任务结果和内部复测记录不随包发布。

验证

本地回归：macOS 625 项、Windows 621 项、Linux 625 项通过，另有按平台或在线服务条件跳过的用例。用户包已在全新中文/空格路径实际安装，完成 CLI、MCP stdio/HTTP/SSE、Skill 导入导出和本地更新事务验证；安装自检不消耗 FOFA 或模型额度。已执行的扫描验证只访问本机临时靶标。

---

English

An evidence-driven AI tool for asset discovery and security analysis.

Developed by Hx0 Studio, FofaMap brings FOFA asset discovery, AI reflection, user-approved Nuclei validation and interactive reporting into one traceable workflow, connecting each assessment with its queries, reasoning and validation results.

Download and fully extract FofaMap-2.0.2-source.zip. On Windows, double-click install.bat; on macOS, double-click install.command; on Linux, run bash install.sh. Choose English, then Install. The installer prepares an isolated environment, registers fofamap, and opens account setup. A FOFA API key is required for searches; a model key is optional for ordinary CLI queries.

Rerun the installer for Repair / Uninstall. Settings, credentials, query results, reports and backups are retained. The release adds saved language selection, more accessible smart fields, 31 MCP tools with a synchronized Skill, explicit scan-approval handling, optional official Nuclei installation after consent, scheduled inventory and interactive reports. Classic query commands remain available.

The source ZIP is the recommended package. The Wheel is for pip users, not a standalone Windows executable. fofamap.skill is an optional host import package. Verify downloads using SHA256SUMS; see the English README for detailed setup and usage.