# fofainfo/awesome-fofa architecture

> Architecture diagram of the GitHub repository fofainfo/awesome-fofa, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fofainfo/awesome-fofa
- Repository: https://github.com/fofainfo/awesome-fofa

## Overview

This repository is a curated knowledge base for FOFA-centric threat hunting and attack-surface discovery, not an application runtime. Its “architecture” is mainly a content taxonomy, with the README files acting as the navigation layer and the Markdown articles as the substantive modules.

1. Entry points and navigation
- `README.md` and `README_zh.md` are the top-level indexes.
- They route readers into thematic collections rather than executing logic.
- The README hierarchy is the primary boundary for how the repository is consumed.

2. Main content domains
- `Get Started with FOFA`: onboarding and beginner material.
- `Basic scenario`: practical search, asset discovery, and threat-intel workflows.
- `FOFA+AI`: articles combining FOFA with LLM/AI-assisted discovery.
- `FofaHub`: workflow-oriented techniques and product/asset aggregation.
- `Cheatsheet`: concise reference material for rules and fingerprints.
- `Storage`: supporting artifacts for articles.

3. Two-language structure
- The repository maintains parallel English and Chinese content tracks.
- Chinese versions are grouped under `*_ZH` subfolders or mirrored filenames.
- This is a documentation localization boundary, not a functional split.

4. Topic-driven content model
- Articles are organized by use case: fuzzy search, certificate filtering, asset refreshing, large-scale asset pulling, login page discovery, independent IP filtering, and product aggregation.
- Another major strand is adversary tracking and malware/infrastructure analysis, including APT and stealer case studies.
- The structure suggests FOFA is used both for defensive asset management and threat-intelligence investigation.

5. Workflow layer
- Several articles describe repeatable investigative workflows, especially in `FofaHub`.
- These workflows chain FOFA queries, fingerprinting, filtering, and clustering into an analysis pipeline.
- For an architecture diagram, this is the main “process flow” layer above the raw search platform.

6. Case-study / investigation layer
- The `Basic scenario` and some `Storage/*` items support deep-dive investigations such as `COLDRIVER`, `APT-C-23`, `Ducktail`, `Sidewinder`, `ObserverStealer`, and supply-chain targeting.
- These pieces appear to use FOFA as the discovery engine and then expand into attribution or infrastructure mapping.
- This layer sits downstream of search and upstream of reporting.

7. Rule and fingerprint knowledge
- `Cheatsheet` and `Storage/Rule_cheatsheet` capture FOFA fingerprint/rule guidance.
- This is a reusable knowledge boundary: query crafting and matching logic are documented separately from narrative case studies.
- It likely feeds into most other sections as a supporting reference.

8. AI-assisted discovery subsystem
- `FOFA+AI` and `FofaHub/AI Finder` show a dedicated branch for AI-assisted asset discovery.
- `Storage/ai_finder` and `Storage/asm_llm` reinforce that this theme includes prompt/workflow experimentation and model-assisted analysis.
- This is a distinct content cluster focused on augmenting search and triage with LLMs.

9. Supporting artifact storage
- `Storage` contains raw or semi-raw assets referenced by articles: text snippets, images, video, and note files.
- Examples include malware-specific folders, image assets, and test files tied to particular writeups.
- This acts as the repository’s asset depot, separate from the polished editorial content.

10. Archive and versioned content
- `FofaHub/Archive` and related Chinese archive folders preserve older workflow material.
- Some article links in the README point to specific historical commits, indicating content versioning matters.
- The archive boundary is useful to show content evolution over time.

11. External dependency boundary
- The repo is tightly coupled to FOFA as the external platform/service.
- It also references third-party tools and reports, but these are informational links rather than integrated dependencies.
- In a diagram, FOFA should be shown as the main external system, with occasional links to external research sources.

12. What the repository produces
- The output of this repository is guidance: search strategies, workflows, case studies, and reference material for FOFA users.
- It supports reconnaissance, asset inventory, enrichment, and threat-intelligence discovery.
- There is no executable backend; the “system” is a curated knowledge graph implemented as Markdown content and linked assets.

13. Best way to diagram it
- Put the README index at the top.
- Branch into the major content collections: onboarding, basic use, AI, hub/workflows, cheatsheet, archives.
- Attach `Storage` as the shared artifact repository beneath the relevant article groups.
- Show FOFA as the external platform all investigative paths depend on.

Main entry points: [`FofaHub/Login Discovery.md`](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/Login%20Discovery.md) (FofaHub), [`README.md`](https://github.com/fofainfo/awesome-fofa/blob/main/README.md) (README), [`Basic scenario/A Comprehensive Guide to Threat Intelligence Discovery Using FOFA.md`](https://github.com/fofainfo/awesome-fofa/blob/HEAD/Basic%20scenario/A%20Comprehensive%20Guide%20to%20Threat%20Intelligence%20Discovery%20Using%20FOFA.md) (Basic scenario), [`README_zh.md`](https://github.com/fofainfo/awesome-fofa/blob/main/README_zh.md) (README 中文)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Navigation"]
  node_readme_en["README<br/>index<br/>[README.md]"]
  node_readme_zh["README 中文<br/>index<br/>[README_zh.md]"]
end

subgraph group_content["Content"]
  node_get_started["Get Started<br/>onboarding"]
  node_basic_scenario["Basic scenario<br/>scenario hub"]
  node_basic_search["Search basics<br/>query craft"]
  node_asset_discovery["Asset discovery<br/>workflow"]
  node_threat_cases["Threat cases<br/>investigations"]
  node_ai_discovery["FOFA+AI<br/>ai discovery"]
  node_fofahub["FofaHub<br/>workflow hub<br/>[Login Discovery.md]"]
  node_workflow_layer["Workflows<br/>analysis pipeline"]
  node_login_discovery["Login pages<br/>discovery method<br/>[Login Discovery.md]"]
  node_product_aggregation["Aggregation<br/>asset grouping"]
  node_filter_ip["IP filter<br/>filtering"]
  node_ai_finder["AI Finder<br/>ai workflow<br/>[AI Finder.md]"]
  node_archive["Archive<br/>versioned content"]
  node_cheatsheet["Cheatsheet<br/>reference"]
end

subgraph group_artifacts["Artifacts"]
  node_rules["Rules<br/>[rules.md]"]
  node_storage["Storage<br/>asset depot<br/>[Doc.md]"]
  node_case_assets["Case assets<br/>support files<br/>[coldriver.md]"]
  node_ai_assets["AI assets<br/>support files<br/>[ollama.md]"]
  node_archive_assets["Archived assets<br/>historical material"]
end

subgraph group_external["External"]
  node_fofa_platform(("FOFA<br/>external platform"))
end

node_readme_en -->|"routes to"| node_get_started
node_readme_en -->|"routes to"| node_basic_scenario
node_readme_en -->|"routes to"| node_fofahub
node_readme_en -->|"routes to"| node_cheatsheet
node_readme_en -->|"routes to"| node_ai_discovery
node_readme_en -->|"routes to"| node_storage
node_readme_zh -->|"routes to"| node_get_started
node_readme_zh -->|"routes to"| node_basic_scenario
node_readme_zh -->|"routes to"| node_fofahub
node_readme_zh -->|"routes to"| node_cheatsheet
node_readme_zh -->|"routes to"| node_ai_discovery
node_basic_scenario -->|"contains"| node_basic_search
node_basic_scenario -->|"contains"| node_asset_discovery
node_basic_scenario -->|"contains"| node_threat_cases
node_basic_scenario -.->|"overlaps"| node_ai_discovery
node_fofahub -->|"organizes"| node_workflow_layer
node_fofahub -->|"contains"| node_login_discovery
node_fofahub -->|"contains"| node_product_aggregation
node_fofahub -->|"contains"| node_filter_ip
node_fofahub -->|"contains"| node_ai_finder
node_fofahub -.->|"preserves"| node_archive
node_cheatsheet -.->|"backed by"| node_rules
node_storage -->|"hosts"| node_case_assets
node_storage -->|"hosts"| node_ai_assets
node_storage -->|"hosts"| node_archive_assets
node_basic_search -->|"depends on"| node_fofa_platform
node_asset_discovery -->|"depends on"| node_fofa_platform
node_threat_cases -->|"depends on"| node_fofa_platform
node_ai_discovery -->|"augments"| node_fofa_platform
node_fofahub -->|"depends on"| node_fofa_platform
node_cheatsheet -->|"supports"| node_fofa_platform

click node_readme_en "https://github.com/fofainfo/awesome-fofa/blob/main/README.md"
click node_readme_zh "https://github.com/fofainfo/awesome-fofa/blob/main/README_zh.md"
click node_get_started "https://github.com/fofainfo/awesome-fofa/blob/main/Get Started with FOFA/A Beginner‘s Guide.md"
click node_basic_scenario "https://github.com/fofainfo/awesome-fofa/blob/main/Basic scenario/A Comprehensive Guide to Threat Intelligence Discovery Using FOFA.md"
click node_basic_search "https://github.com/fofainfo/awesome-fofa/blob/main/Basic scenario/The correct way to use Fuzzy Search in FOFA.md"
click node_asset_discovery "https://github.com/fofainfo/awesome-fofa/blob/main/Basic scenario/Asset Inventory from a God‘s Perspective.md"
click node_threat_cases "https://github.com/fofainfo/awesome-fofa/blob/main/Basic scenario/Practical FOFA Asset Discovery- COLDRIVER.md"
click node_ai_discovery "https://github.com/fofainfo/awesome-fofa/blob/main/FOFA+AI/Next-Generation Attack Surface Inventory: Free Trial Available!.md"
click node_fofahub "https://github.com/fofainfo/awesome-fofa/blob/main/FofaHub/Login Discovery.md"
click node_workflow_layer "https://github.com/fofainfo/awesome-fofa/blob/main/FofaHub/Archive/Unleash the Power of Workflow- Unleash Your Creativity in Open Site Discovery.md"
click node_login_discovery "https://github.com/fofainfo/awesome-fofa/blob/main/FofaHub/Login Discovery.md"
click node_product_aggregation "https://github.com/fofainfo/awesome-fofa/blob/main/FofaHub/Product Aggregation.md"
click node_filter_ip "https://github.com/fofainfo/awesome-fofa/blob/main/FofaHub/Filter Independent IP.md"
click node_ai_finder "https://github.com/fofainfo/awesome-fofa/blob/main/FofaHub/AI Finder.md"
click node_archive "https://github.com/fofainfo/awesome-fofa/blob/main/FofaHub/Archive/Unleash the Power of Workflow- Unleash Your Creativity in Open Site Discovery.md"
click node_cheatsheet "https://github.com/fofainfo/awesome-fofa/blob/main/Cheatsheet/FOFA Fingerprint rule Cheatsheet.md"
click node_rules "https://github.com/fofainfo/awesome-fofa/blob/main/Storage/Rule_cheatsheet/rules.md"
click node_storage "https://github.com/fofainfo/awesome-fofa/blob/main/Storage/Doc.md"
click node_case_assets "https://github.com/fofainfo/awesome-fofa/blob/main/Storage/coldriver/coldriver.md"
click node_ai_assets "https://github.com/fofainfo/awesome-fofa/blob/main/Storage/ai_finder/ollama.md"
click node_archive_assets "https://github.com/fofainfo/awesome-fofa/tree/main/Storage/Fofahub/Fofahub_ZH"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme_en,node_readme_zh toneBlue
class node_get_started,node_basic_scenario,node_basic_search,node_asset_discovery,node_threat_cases,node_ai_discovery,node_fofahub,node_workflow_layer,node_login_discovery,node_product_aggregation,node_filter_ip,node_ai_finder,node_archive,node_cheatsheet toneAmber
class node_rules,node_storage,node_case_assets,node_ai_assets,node_archive_assets toneMint
class node_fofa_platform toneRose
```

## Components

### Navigation

Top-level indexes and language entry points

- [README](https://github.com/fofainfo/awesome-fofa/blob/main/README.md): index · Top-level English entry point · `README.md`
- [README 中文](https://github.com/fofainfo/awesome-fofa/blob/main/README_zh.md): index · Top-level Chinese entry point · `README_zh.md`

### Content

Main topic collections and their core article clusters

- [Get Started](https://github.com/fofainfo/awesome-fofa/blob/HEAD/Get%20Started%20with%20FOFA/A%20Beginner%E2%80%98s%20Guide.md): onboarding · Beginner guidance and first-use material · `Get Started with FOFA/A Beginner‘s Guide.md`
- [Basic scenario](https://github.com/fofainfo/awesome-fofa/blob/HEAD/Basic%20scenario/A%20Comprehensive%20Guide%20to%20Threat%20Intelligence%20Discovery%20Using%20FOFA.md): scenario hub · Practical search, discovery, and investigation articles · `Basic scenario/A Comprehensive Guide to Threat Intelligence Discovery Using FOFA.md`
- [Search basics](https://github.com/fofainfo/awesome-fofa/blob/HEAD/Basic%20scenario/The%20correct%20way%20to%20use%20Fuzzy%20Search%20in%20FOFA.md): query craft · Fuzzy search, efficiency, and large-pull techniques · `Basic scenario/The correct way to use Fuzzy Search in FOFA.md`
- [Asset discovery](https://github.com/fofainfo/awesome-fofa/blob/HEAD/Basic%20scenario/Asset%20Inventory%20from%20a%20God%E2%80%98s%20Perspective.md): workflow · Asset inventory, refresh, filtering, and certificate-based cleanup · `Basic scenario/Asset Inventory from a God‘s Perspective.md`
- [Threat cases](https://github.com/fofainfo/awesome-fofa/blob/HEAD/Basic%20scenario/Practical%20FOFA%20Asset%20Discovery-%20COLDRIVER.md): investigations · APT, stealer, and supply-chain tracing writeups · `Basic scenario/Practical FOFA Asset Discovery- COLDRIVER.md`
- [FOFA+AI](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FOFA%2BAI/Next-Generation%20Attack%20Surface%20Inventory%3A%20Free%20Trial%20Available!.md): ai discovery · LLM-assisted attack-surface discovery · `FOFA+AI/Next-Generation Attack Surface Inventory: Free Trial Available!.md`
- [FofaHub](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/Login%20Discovery.md): workflow hub · Operational techniques and reusable discovery workflows · `FofaHub/Login Discovery.md`
- [Workflows](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/Archive/Unleash%20the%20Power%20of%20Workflow-%20Unleash%20Your%20Creativity%20in%20Open%20Site%20Discovery.md): analysis pipeline · Search, fingerprinting, filtering, and clustering process layer · `FofaHub/Archive/Unleash the Power of Workflow- Unleash Your Creativity in Open Site Discovery.md`
- [Login pages](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/Login%20Discovery.md): discovery method · Techniques for locating login and access surfaces · `FofaHub/Login Discovery.md`
- [Aggregation](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/Product%20Aggregation.md): asset grouping · Product and asset aggregation workflows · `FofaHub/Product Aggregation.md`
- [IP filter](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/Filter%20Independent%20IP.md): filtering · Independent IP filtering and deduplication techniques · `FofaHub/Filter Independent IP.md`
- [AI Finder](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/AI%20Finder.md): ai workflow · LLM-assisted discovery workflow inside FofaHub · `FofaHub/AI Finder.md`
- [Archive](https://github.com/fofainfo/awesome-fofa/blob/HEAD/FofaHub/Archive/Unleash%20the%20Power%20of%20Workflow-%20Unleash%20Your%20Creativity%20in%20Open%20Site%20Discovery.md): versioned content · Older workflow material preserved for reference · `FofaHub/Archive/Unleash the Power of Workflow- Unleash Your Creativity in Open Site Discovery.md`
- [Cheatsheet](https://github.com/fofainfo/awesome-fofa/blob/HEAD/Cheatsheet/FOFA%20Fingerprint%20rule%20Cheatsheet.md): reference · Concise fingerprint and rule guidance · `Cheatsheet/FOFA Fingerprint rule Cheatsheet.md`

### Artifacts

Supporting references, archives, and shared assets

- [Rules](https://github.com/fofainfo/awesome-fofa/blob/main/Storage/Rule_cheatsheet/rules.md): fingerprint rules · Reusable FOFA rule and fingerprint knowledge · `Storage/Rule_cheatsheet/rules.md`
- [Storage](https://github.com/fofainfo/awesome-fofa/blob/main/Storage/Doc.md): asset depot · Supporting raw and semi-raw article assets · `Storage/Doc.md`
- [Case assets](https://github.com/fofainfo/awesome-fofa/blob/main/Storage/coldriver/coldriver.md): support files · Per-case notes, images, and extracted materials · `Storage/coldriver/coldriver.md`
- [AI assets](https://github.com/fofainfo/awesome-fofa/blob/main/Storage/ai_finder/ollama.md): support files · Prompts, notes, and experiments for AI-assisted discovery · `Storage/ai_finder/ollama.md`
- [Archived assets](https://github.com/fofainfo/awesome-fofa/tree/main/Storage/Fofahub/Fofahub_ZH): historical material · Older localized and archive support files · `Storage/Fofahub/Fofahub_ZH`

### External

Outside platform dependency

- **FOFA**: external platform · Primary external search and intelligence platform

## Connections

- README → Get Started: routes to · English index points readers into onboarding
- README → Basic scenario: routes to · English index points readers into practical scenarios
- README → FofaHub: routes to · English index points readers into workflow content
- README → Cheatsheet: routes to · English index points readers into reference material
- README → FOFA+AI: routes to · English index points readers into AI-assisted material
- README → Storage: routes to · English index exposes shared artifacts
- README 中文 → Get Started: routes to · Chinese index points readers into onboarding
- README 中文 → Basic scenario: routes to · Chinese index points readers into practical scenarios
- README 中文 → FofaHub: routes to · Chinese index points readers into workflow content
- README 中文 → Cheatsheet: routes to · Chinese index points readers into reference material
- README 中文 → FOFA+AI: routes to · Chinese index points readers into AI-assisted material
- Basic scenario → Search basics: contains · Search fundamentals and efficiency techniques
- Basic scenario → Asset discovery: contains · Asset inventory and filtering workflows
- Basic scenario → Threat cases: contains · Threat-intelligence and adversary case studies
- Basic scenario → FOFA+AI: overlaps · Some scenario articles use LLM-assisted discovery
- FofaHub → Workflows: organizes · FofaHub is the reusable workflow collection
- FofaHub → Login pages: contains · Login-page discovery techniques
- FofaHub → Aggregation: contains · Product and asset aggregation workflows
- FofaHub → IP filter: contains · Independent IP filtering techniques
- FofaHub → AI Finder: contains · Dedicated AI-assisted discovery branch
- FofaHub → Archive: preserves · Older workflow material is retained in archive form
- Cheatsheet → Rules: backed by · Reference guidance is reinforced by stored rule notes
- Storage → Case assets: hosts · Shared case-study support files
- Storage → AI assets: hosts · LLM and AI workflow support files
- Storage → Archived assets: hosts · Archived localization and legacy support files
- Search basics → FOFA: depends on · Query crafting operates against FOFA
- Asset discovery → FOFA: depends on · Asset inventory and refresh use FOFA as discovery engine
- Threat cases → FOFA: depends on · Investigation and attribution workflows rely on FOFA
- FOFA+AI → FOFA: augments · AI-assisted discovery still targets FOFA data
- FofaHub → FOFA: depends on · Workflow techniques are built around FOFA search
- Cheatsheet → FOFA: supports · Rules and fingerprints guide FOFA query construction
