How fofainfo/awesome-fofa works
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: Login Discovery.md FofaHub · README.md README · A Comprehensive Guide to Threat Intelligence Discovery Using FOFA.md Basic scenario · README_zh.md README 中文
Components 22
Navigation
Top-level indexes and language entry points
Content
Main topic collections and their core article clusters
- Get Started · Beginner guidance and first-use material
Get Started with FOFA/A Beginner‘s Guide.md - Basic scenario · Practical search, discovery, and investigation articles
Basic scenario/A Comprehensive Guide to Threat Intelligence Discovery Using FOFA.md - Search basics · Fuzzy search, efficiency, and large-pull techniques
Basic scenario/The correct way to use Fuzzy Search in FOFA.md - Asset discovery · Asset inventory, refresh, filtering, and certificate-based cleanup
Basic scenario/Asset Inventory from a God‘s Perspective.md - Threat cases · APT, stealer, and supply-chain tracing writeups
Basic scenario/Practical FOFA Asset Discovery- COLDRIVER.md - FOFA+AI · LLM-assisted attack-surface discovery
FOFA+AI/Next-Generation Attack Surface Inventory: Free Trial Available!.md - FofaHub · Operational techniques and reusable discovery workflows
FofaHub/Login Discovery.md - Workflows · Search, fingerprinting, filtering, and clustering process layer
FofaHub/Archive/Unleash the Power of Workflow- Unleash Your Creativity in Open Site Discovery.md - Login pages · Techniques for locating login and access surfaces
FofaHub/Login Discovery.md - Aggregation · Product and asset aggregation workflows
FofaHub/Product Aggregation.md - IP filter · Independent IP filtering and deduplication techniques
FofaHub/Filter Independent IP.md - AI Finder · LLM-assisted discovery workflow inside FofaHub
FofaHub/AI Finder.md - Archive · Older workflow material preserved for reference
FofaHub/Archive/Unleash the Power of Workflow- Unleash Your Creativity in Open Site Discovery.md - Cheatsheet · Concise fingerprint and rule guidance
Cheatsheet/FOFA Fingerprint rule Cheatsheet.md
Artifacts
Supporting references, archives, and shared assets
- Rules · Reusable FOFA rule and fingerprint knowledge
Storage/Rule_cheatsheet/rules.md - Storage · Supporting raw and semi-raw article assets
Storage/Doc.md - Case assets · Per-case notes, images, and extracted materials
Storage/coldriver/coldriver.md - AI assets · Prompts, notes, and experiments for AI-assisted discovery
Storage/ai_finder/ollama.md - Archived assets · Older localized and archive support files
Storage/Fofahub/Fofahub_ZH
External
Outside platform dependency
- FOFA · Primary external search and intelligence platform
Connections 31
- 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