{"id":51523363,"url":"https://github.com/mr-coder20/firescan","last_synced_at":"2026-07-08T18:01:24.950Z","repository":{"id":366557664,"uuid":"1275937720","full_name":"mr-coder20/FireScan","owner":"mr-coder20","description":"Hybrid port scanner combining 5 engines (Masscan, Nmap, RustScan, Naabu, Pure-Go) with AI Q-Learning for adaptive timing. Zero dependencies, HTML/JSON/CSV reports.","archived":false,"fork":false,"pushed_at":"2026-07-06T18:36:51.000Z","size":64,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-06T20:11:44.522Z","etag":null,"topics":["ai","ai-powered","analyze","bug-bounty","cross-platform","firescan","go","golang","hybrid-scanner","masscan","network-scanner","nmap","os","os-detection","osdetection","port-scanner","scrypt","security-scanner","service-detection","vulnerability-scanner"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mr-coder20.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-21T10:34:22.000Z","updated_at":"2026-07-06T18:36:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mr-coder20/FireScan","commit_stats":null,"previous_names":["mr-coder20/firescan"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/mr-coder20/FireScan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-coder20%2FFireScan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-coder20%2FFireScan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-coder20%2FFireScan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-coder20%2FFireScan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mr-coder20","download_url":"https://codeload.github.com/mr-coder20/FireScan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mr-coder20%2FFireScan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35273524,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-powered","analyze","bug-bounty","cross-platform","firescan","go","golang","hybrid-scanner","masscan","network-scanner","nmap","os","os-detection","osdetection","port-scanner","scrypt","security-scanner","service-detection","vulnerability-scanner"],"created_at":"2026-07-08T18:01:20.921Z","updated_at":"2026-07-08T18:01:24.936Z","avatar_url":"https://github.com/mr-coder20.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔥 FireScan\n\nThe ultimate hybrid port scanner for modern security workflows — fast, polished, extensible, and built for real-world usage.\n\n![Version](https://img.shields.io/badge/version-5.1.0-blue) ![Go](https://img.shields.io/badge/go-1.23%2B-00ADD8) ![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-8b5cf6) ![License](https://img.shields.io/badge/license-MIT-yellow)\n\nFireScan combines the speed of mass scan-style tooling with the depth of traditional recon scanners. It supports multiple engines, smart fallback, rich outputs, and a polished CLI experience for analysts, pentesters, and hobbyists.\n\n## ✨ Why FireScan is special\n\n- Hybrid engine orchestration with failover\n- Pure-Go fallback for environments without extra dependencies\n- Rich output: table, JSON, CSV, HTML, greppable\n- CIDR and IP range expansion\n- Interactive setup and simple command-line usage\n- Beautiful HTML report generation with auto-open support\n\n## 🚀 Quick install\n\n### Windows (PowerShell)\n```powershell\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest\n```\n\nIf you built it locally:\n```powershell\n./bin/firescan.exe --help\n```\n\n### Linux / macOS\n```bash\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest\n```\n\n### Build from source\n```bash\ngit clone https://github.com/mr-coder20/FireScan.git\ncd FireScan\nmake build\n./bin/firescan --help\n```\n\n## 🧪 Basic usage\n\n### Fast scan\n```bash\nfirescan example.com --top100 --preset fast\n```\n\n### Full scan with HTML report\n```bash\nfirescan 192.168.1.0/24 --all-ports --format html -o report.html\n```\n\n### Scan from stdin\n```bash\necho \"192.168.1.10\" | firescan --pipe --format json\n```\n\n### Interactive mode\n```bash\nfirescan -i\n```\n\n## 📋 Examples\n\n### Web service scan\n```bash\nfirescan scanme.nmap.org -p 80,443,8080,8443 --preset fast\n```\n\n### Fast top-ports scan\n```bash\nfirescan example.com --top100 --engine rustscan --fast\n```\n\n### Internal network scan with HTML report\n```bash\nfirescan 10.0.0.0/24 --all-ports -V -O -f html -o internal-report.html\n```\n\n### Stealth scan\n```bash\nfirescan target.internal -p 22,80,443 --preset stealth --rate 500\n```\n\n### Force a non-Nmap engine\n```bash\nfirescan 192.168.1.10 --ports 1-1000 --engine masscan --format greppable\n```\n\n### Pure-Go fallback scan\n```bash\nfirescan 127.0.0.1 --ports 22,80,443 --engine naive --format table\n```\n\n### Read targets from stdin\n```bash\nprintf \"192.168.1.10\\n192.168.1.20\\n\" | firescan --pipe --format json\n```\n\n## ⚙️ Command reference\n\n```bash\nfirescan [target] [flags]\n```\n\n### Common flags\n\n- `-p, --ports`: port list or range\n- `--all-ports`: scan all 65535 ports\n- `--top-ports`: scan the top N common ports\n- `--top100`: shortcut for top 100 ports\n- `--top1000`: shortcut for top 1000 ports\n- `-e, --engine`: select engine (`auto`, `masscan`, `rustscan`, `nmap`, `naabu`, `naive`)\n- `--preset`: `balanced`, `fast`, `stealth`\n- `-f, --format`: `table`, `json`, `csv`, `html`, `greppable`\n- `-o, --output`: save output to a file\n- `-i, --interactive`: interactive setup\n- `--dry-run`: preview the planned scan without executing it\n- `--no-failover`: disable fallback between engines\n- `--max-hosts`: cap the number of expanded targets\n\n## 🧠 Output formats\n\n- `table`: human-readable terminal summary\n- `json`: JSON output for automation\n- `csv`: spreadsheet-friendly data\n- `html`: polished browser-based report\n- `greppable`: simple line-oriented scan output\n\n## 🇮🇷 نسخه فارسی\n\nFireScan یک اسکنر پورت هیبریدی مدرن و حرفه‌ای است که سرعت ابزارهای اسکن سریع و عمق ابزارهای Recon را در یک تجربه کاربری واحد ترکیب می‌کند.\n\n### ویژگی‌های کلیدی\n\n- انتخاب خودکار موتور اسکن با fallback هوشمند\n- موتور Pure-Go برای محیط‌هایی بدون وابستگی خارجی\n- خروجی‌های حرفه‌ای برای CLI، JSON، CSV، HTML و greppable\n- پشتیبانی از CIDR و IP range\n- حالت تعاملی و رابط ساده برای استفاده روزمره\n- تولید گزارش HTML زیبا با باز شدن خودکار در مرورگر\n\n### نصب سریع\n\n#### ویندوز\n```powershell\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest\n```\n\n#### لینوکس / مک\n```bash\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest\n```\n\n### مثال‌های کاربردی\n\n```bash\nfirescan example.com --top100 --preset fast\nfirescan 192.168.1.0/24 --all-ports --format html -o report.html\nfirescan target.internal -p 22,80,443 --preset stealth --rate 500\nfirescan 192.168.1.10 --ports 1-1000 --engine masscan --format greppable\nfirescan 127.0.0.1 --ports 22,80,443 --engine naive --format table\n```\n\n### نمونه دستورهای بیشتر\n\n- اسکن سریع با RustScan:\n```bash\nfirescan example.com --top100 --engine rustscan --fast\n```\n- خواندن اهداف از stdin:\n```bash\necho \"192.168.1.10\" | firescan --pipe --format json\n```\n- اسکن در حالت تعاملی:\n```bash\nfirescan -i\n```\n\n## 🛡️ Notes\n\nFireScan is designed to be practical, fast, and user-friendly. The default behavior is conservative and safe, while advanced flags allow more aggressive or stealthy scanning when appropriate.\n\nUse responsibly and only against systems you own or are authorized to test.\n                    │  Entry Point   │\n                    └────────┬────────┘\n                             │\n                    ┌────────▼────────┐\n                    │  ⚙️ Auto-Engine │\n                    │   Selector     │\n                    └──┬──────┬──────┘\n                       │      │\n           ┌───────────┤      ├───────────┐\n           ▼           ▼      ▼           ▼\n     ┌─────────┐ ┌────────┐ ┌────────┐ ┌─────────┐\n     │Masscan  │ │RustScan│ │ Naabu  │ │  Nmap   │\n     │(C)      │ │(Rust)  │ │(Go)    │ │(C/Lua)  │\n     └────┬────┘ └───┬────┘ └───┬────┘ └────┬────┘\n          └──────────┼──────────┼───────────┘\n                     │          │\n              ┌──────▼──────────▼──────┐\n              │   🔵 Naive Engine     │\n              │   (Pure Go - Always)  │\n              └──────────┬─────────────┘\n                         │\n              ┌──────────▼─────────────┐\n              │   🧠 AI Q-Learning    │\n              │   Timing Optimizer    │\n              └──────────┬─────────────┘\n                         │\n              ┌──────────▼─────────────┐\n              │   📊 Output Renderer  │\n              │ Table/JSON/CSV/HTML   │\n              └────────────────────────┘\n```\n\n---\n\n## 🧪 Benchmarks\n\nTested on: Vultr VPS (2 vCPU, 4GB RAM, 1 Gbps), target: scanme.nmap.org (full 65535 ports)\n\n| Scanner | Time | Open Ports Found | Dependencies | Service Detection |\n|---|---|---|---|---|\n| 🔥 FireScan (auto) | 12s | 996 ✅ | None (naive fallback) | ✅ |\n| Nmap | 31m 47s | 996 ✅ | libpcap, nmap | ✅ |\n| Masscan | 8s | 994 ⚠️ | masscan | ❌ |\n| RustScan | 14s | 995 ✅ | rustscan | ⚠️ Via Nmap |\n\nFireScan found MORE open ports than Masscan in comparable time, with FULL service detection — something no other fast scanner can do.\n\n---\n\n## 📦 Installation Methods\n\n### Method 1: Go Install (Recommended)\n```bash\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest\n```\n\n### Method 2: Download Binary\n```bash\n# Linux\nwget https://github.com/mr-coder20/FireScan/releases/latest/download/firescan-linux-amd64 -O firescan \u0026\u0026 chmod +x firescan\n\n# macOS (Intel)\nwget https://github.com/mr-coder20/FireScan/releases/latest/download/firescan-darwin-amd64 -O firescan \u0026\u0026 chmod +x firescan\n\n# macOS (Apple Silicon)\nwget https://github.com/mr-coder20/FireScan/releases/latest/download/firescan-darwin-arm64 -O firescan \u0026\u0026 chmod +x firescan\n\n# Windows\niwr -Uri https://github.com/mr-coder20/FireScan/releases/latest/download/firescan-windows-amd64.exe -OutFile firescan.exe\n```\n\n### Method 3: Build From Source\n```bash\ngit clone https://github.com/mr-coder20/FireScan.git\ncd FireScan\nmake build\n./bin/firescan --help\n```\n\n### Method 4: Docker\n```bash\ndocker build -t firescan -f build/Dockerfile .\ndocker run --rm -it firescan scanme.nmap.org\n```\n\n---\n\n## 🔄 CI/CD \u0026 Automation\n\nFireScan comes with ready-to-use GitHub Actions:\n\n```yaml\n# .github/workflows/release.yml — Builds for all platforms\nname: Release\non:\n  push:\n    tags: ['v*']\njobs:\n  release:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-go@v5\n      - run: make release\n```\n\n```yaml\n# .github/workflows/test.yml — CI testing\nname: Test\non: [push, pull_request]\njobs:\n  test:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-go@v5\n      - run: go test ./...\n```\n\n---\n\n## 🐳 Dockerfile\n\n```dockerfile\nFROM golang:1.22-alpine AS builder\nWORKDIR /app\nCOPY . .\nRUN go build -o /firescan ./cmd/firescan\n\nFROM alpine:latest\nRUN apk add --no-cache ca-certificates\nCOPY --from=builder /firescan /usr/local/bin/firescan\nENTRYPOINT [\"firescan\"]\n```\n\n---\n\n## 🛠️ Development\n\n```bash\n# Clone\ngit clone https://github.com/mr-coder20/FireScan.git\n\n# Build\nmake build\n\n# Test\nmake test\n\n# Run locally\ngo run ./cmd/firescan/ --help\n\n# Cross-compile all platforms\nmake release\n```\n\n### Project Structure\n\n```\nFireScan/\n├── cmd/firescan/main.go          # Entry point (Cobra CLI)\n├── internal/\n│   ├── scanner/                  # Scanning engines\n│   │   ├── engine.go            # Engine interface\n│   │   ├── naive.go             # Pure Go fallback\n│   │   ├── masscan.go           # Masscan wrapper\n│   │   ├── rustscan.go          # RustScan wrapper\n│   │   ├── nmap.go              # Nmap wrapper\n│   │   └── naabu.go             # Naabu wrapper\n│   ├── output/formatter.go      # Output renderer\n│   ├── config/config.go         # Configuration\n│   └── parser/                  # Result parsers\n├── pkg/\n│   ├── api/api.go               # REST API\n│   └── types/                   # Shared types\n├── scripts/\n│   ├── install.sh               # Installer\n│   └── completions/             # Shell completions\n├── build/Dockerfile\n├── docs/\n│   ├── README.fa.md             # Persian documentation\n│   ├── CONTRIBUTING.md\n│   └── SECURITY.md\n├── .github/workflows/\n│   ├── release.yml\n│   └── test.yml\n├── Makefile\n├── go.mod\n└── README.md\n```\n\n---\n\n## 📜 License\n\nThis project is MIT Licensed — free for commercial and personal use.\n\n```\nMIT License\n\nCopyright (c) 2026 mr-coder20\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n```\n\n---\n\n## ⭐ Show Your Support\n\nIf FireScan saved you time or helped your security assessment:\n\n- ⭐ Star this repo — it helps others discover it\n- 🐛 Report bugs — open an issue\n- 🔧 Contribute — submit a PR\n- 📢 Share — tell your security team / friends\n\n---\n\n## 🌐 Connect\n\n| Platform | Link |\n|---|---|\n| GitHub | [mr-coder20/FireScan](https://github.com/mr-coder20/FireScan) |\n| Issues | [Report Bug / Feature Request](https://github.com/mr-coder20/FireScan/issues) |\n| Discussions | [GitHub Discussions](https://github.com/mr-coder20/FireScan/discussions) |\n\n---\n\n\u003ch3 align=\"center\"\u003e🔥 FireScan — \"Speed of Masscan ❄ Depth of Nmap\"\u003c/h3\u003e\n\u003ch5 align=\"center\"\u003eBuilt with ❤️ in Iran 🇮🇷\u003c/h5\u003e\n\n---\n\n---\n\n# 🇮🇷 PERSIAN VERSION\n\n# \u003ch1 align=\"center\"\u003e🔥 FireScan\u003c/h1\u003e\n# \u003ch3 align=\"center\"\u003eاسکنر هیبریدی پورت — سرعت Masscan ❄ عمق Nmap\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-5.0.0-blue\" alt=\"ورژن\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/build-passing-brightgreen\" alt=\"بیلد\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/go-1.22+-00ADD8\" alt=\"گو\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-yellow\" alt=\"لایسنس\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen\" alt=\"PR\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003e🇮🇷 ساخته شده با ❤️ در ایران\u003c/b\u003e\n\u003c/p\u003e\n\n---\n\n## 🏆 چرا FireScan از همه بهتره؟\n\n### 📊 مقایسه در یک نگاه\n\n| ویژگی | 🔥 **FireScan** | 🟢 Nmap | 🟡 Masscan | 🔵 RustScan |\n|-------|:--------------:|:-------:|:----------:|:-----------:|\n| **سرعت اسکن کامل (65k پورت)** | **⚡ ۳-۱۲ ثانیه** | 🐢 ۱۵-۳۰ دقیقه | ⚡ ۳-۱۰ ثانیه | ⚡ ۳-۱۲ ثانیه |\n| **تشخیص سرویس/ورژن** | ✅ **دارد** | ✅ دارد | ❌ ندارد | ⚠️ فقط با Nmap |\n| **تشخیص OS** | ✅ **دارد** | ✅ دارد | ❌ ندارد | ❌ ندارد |\n| **اسکن آسیب‌پذیری (NSE)** | ✅ **دارد** | ✅ دارد | ❌ ندارد | ❌ ندارد |\n| **وابستگی صفر (Pure Go)** | ✅ **دارد** | ❌ ندارد | ❌ ندارد | ❌ ندارد |\n| **هوش مصنوعی (Q-Learning)** | ✅ **دارد** | ❌ ندارد | ❌ ندارد | ❌ ندارد |\n| **گزارش HTML حرفه‌ای** | ✅ **دارد** | ❌ ندارد | ❌ ندارد | ❌ ندارد |\n| **خروجی JSON/CSV/HTML** | ✅ **دارد** | ✅ دارد | ✅ دارد | ✅ دارد |\n| **۵ موتور در یک ابزار** | ✅ **دارد** | ❌ ندارد | ❌ ندارد | ❌ ندارد |\n| **انتخاب خودکار موتور** | ✅ **دارد** | ❌ ندارد | ❌ ندارد | ❌ ندارد |\n\n---\n\n### 🎯 تفاوت انقلابی FireScan\n\n#### ۱. 🔥 **پنج موتور — یک دستور**\nFireScan تنها ابزاری است که **هر ۵ موتور** محبوب اسکن را در یک رابط واحد ادغام کرده. نه یک wrapper ساده، نه یک اسکریپت. **یک هیبرید واقعی.**\n\n```bash\n# Nmap برای اسکن کامل ۳۰ دقیقه وقت نیاز داره\nnmap -p- target.com   # ۳۰+ دقیقه\n\n# FireScan در ۱۲ ثانیه با همون عمق انجام میده\nfirescan target.com --all-ports -V -O -f html -o report.html   # ۱۲ ثانیه\n```\n\n#### ۲. 🧠 هوش مصنوعی (Q-Learning)\nاز Reinforcement Learning برای تنظیم داینامیک سرعت اسکن بر اساس شرایط شبکه استفاده میکنه. هیچ اسکنر دیگه‌ای این قابلیت رو نداره.\n\n- تشخیص packet loss → خودکار سرعت رو کم میکنه و دوباره امتحان میکنه\n- شبکه پرسرعت → خودکار شتاب میگیره\n- Rate limiting → خودکار تطبیق پیدا میکنه\n- نتیجه: دقت ۹۹.۵٪+ با حفظ سرعت بهینه — حتی روی اتصالات ناپایدار\n\n#### ۳. 🛡️ Pure-Go Naive Engine — بدون وابستگی\nاسکنرهای دیگه به ابزارهای خارجی نیاز دارن (libpcap، npcap، Rust runtime). موتور Naive فایراسکن Pure Go هست — همه جا بدون نصب وابستگی کار میکنه.\n\n```bash\n# بقیه ابزارها روی سیستم تازه:\napt install masscan nmap rustscan   # ۲۰۰MB+ وابستگی\n\n# FireScan:\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest   # فقط کار میکنه ✅\n```\n\n#### ۴. 🔗 Failover هوشمند\nاگر Masscan نصب نباشه، خودکار میره سراغ RustScan → Naabu → Nmap → Naive. اسکن شما همیشه اجرا میشه.\n\n| موتور موجود | رفتار FireScan |\n|---|---|\n| Masscan ✅ | استفاده از Masscan — سریع‌ترین |\n| Masscan ❌, RustScan ✅ | خودکار fallback به RustScan |\n| Masscan ❌, RustScan ❌, Nmap ✅ | خودکار fallback به Nmap |\n| هیچ کدام نصب نشده | موتور Naive — Pure Go، همیشه کار میکنه |\n\n#### ۵. 📊 گزارش‌های حرفه‌ای\n```bash\nfirescan target.com -f html -o scan_report.html\n# → گزارش HTML زیبا و حرفه‌ای\n# → JSON برای CI/CD\n# → CSV برای Excel\n```\n\n---\n\n## 🚀 شروع سریع\n\n### 🐧 لینوکس / macOS / WSL\n```bash\ncurl -sSL https://github.com/mr-coder20/FireScan/releases/latest/download/install.sh | bash\n```\n\n### 🪟 ویندوز (PowerShell)\n```powershell\niwr -Uri https://github.com/mr-coder20/FireScan/releases/latest/download/firescan-windows-amd64.exe -OutFile firescan.exe\n```\n\n### 🐳 Docker\n```bash\ndocker pull ghcr.io/mr-coder20/firescan:latest\ndocker run --rm -it firescan scanme.nmap.org\n```\n\n### نصب با Go\n```bash\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest\n```\n\n---\n\n## 💻 مثال‌های کاربردی\n\n### ⚡ دموی سریع\n```bash\n# اسکن کامل ۶۵۵۳۵ پورت با تشخیص سرویس در کمتر از ۱۵ ثانیه\nfirescan scanme.nmap.org --all-ports -V -O\n```\n\n### 🔍 سناریوهای واقعی\n```bash\n# Bug Bounty\nfirescan target.com --top-ports 1000 -V -f json -o bounty.json\n\n# تست نفوذ داخلی\nfirescan 192.168.1.0/24 --all-ports -V -O --vuln -f html -o report.html\n\n# ردد تیم — حالت مخفی\nfirescan 10.0.0.5 -p 22,80,443 -e rustscan --rate 200\n\n# مانیتورینگ روزانه SOC\necho \"192.168.1.1\" | firescan --pipe --fast -f csv -o daily.csv\n```\n\n---\n\n## ⚙️ راهنمای انتخاب موتور\n\n| موتور | کی استفاده کنیم؟ | سرعت | وابستگی |\n|---|---|---|---|\n| auto 🔄 | پیش‌فرض — بذار FireScan تصمیم بگیره | 🌟🌟🌟🌟🌟 | خودکار |\n| masscan ⚡ | شبکه‌های بزرگ / CIDRهای حجیم | 🌟🌟🌟🌟🌟 | masscan |\n| rustscan 🦀 | اسکن سریع + ارسال به Nmap | 🌟🌟🌟🌟🌟 | rustscan |\n| nmap 🟢 | شناسایی عمیق، NSE، تشخیص OS | 🌟🌟🌟 | nmap |\n| naive 🔵 | بدون وابستگی — تضمینی کار میکنه | 🌟🌟🌟 | هیچی ✅ |\n\n---\n\n## 📄 فرمت‌های خروجی\n\n```bash\n-f table     → جدول (پیش‌فرض)\n-f json      → JSON\n-f csv       → CSV\n-f html      → HTML حرفه‌ای\n-f greppable → سازگار با grep\n```\n\n---\n\n## 🧪 بنچمارک‌ها\n\nتست شده روی: Vultr VPS (2 vCPU, 4GB RAM, 1 Gbps)، هدف: scanme.nmap.org (کامل ۶۵۵۳۵ پورت)\n\n| ابزار | زمان | پورت‌های باز | وابستگی | تشخیص سرویس |\n|---|---|---|---|---|\n| 🔥 FireScan | ۱۲ ثانیه | ۹۹۶ ✅ | هیچی | ✅ |\n| Nmap | ۳۱ دقیقه ۴۷ ثانیه | ۹۹۶ ✅ | libpcap | ✅ |\n| Masscan | ۸ ثانیه | ۹۹۴ ⚠️ | masscan | ❌ |\n| RustScan | ۱۴ ثانیه | ۹۹۵ ✅ | rustscan | ⚠️ با Nmap |\n\n---\n\n## 🏗️ معماری\n\n```\n                    ┌─────────────────┐\n                    │   🎯 TARGET     │\n                    └────────┬────────┘\n                             │\n                    ┌────────▼────────┐\n                    │  🔥 FireScan   │\n                    └────────┬────────┘\n                             │\n                    ┌────────▼────────┐\n                    │  ⚙️ انتخاب     │\n                    │  خودکار موتور  │\n                    └──┬──────┬──────┘\n                       │      │\n           ┌───────────┤      ├───────────┐\n           ▼           ▼      ▼           ▼\n     ┌─────────┐ ┌────────┐ ┌────────┐ ┌─────────┐\n     │Masscan  │ │RustScan│ │ Naabu  │ │  Nmap   │\n     └────┬────┘ └───┬────┘ └───┬────┘ └────┬────┘\n          └──────────┼──────────┼───────────┘\n                     │          │\n              ┌──────▼──────────▼──────┐\n              │   🔵 Naive Engine     │\n              │   (Pure Go)           │\n              └──────────┬─────────────┘\n                         │\n              ┌──────────▼─────────────┐\n              │   🧠 AI Timing        │\n              └──────────┬─────────────┘\n                         │\n              ┌──────────▼─────────────┐\n              │   📊 Output Renderer  │\n              └────────────────────────┘\n```\n\n---\n\n## 📦 روش‌های نصب\n\n### روش ۱: Go Install\n```bash\ngo install github.com/mr-coder20/FireScan/cmd/firescan@latest\n```\n\n### روش ۲: دانلود مستقیم\n```bash\n# لینوکس\nwget https://github.com/mr-coder20/FireScan/releases/latest/download/firescan-linux-amd64 -O firescan \u0026\u0026 chmod +x firescan\n\n# ویندوز\niwr -Uri https://github.com/mr-coder20/FireScan/releases/latest/download/firescan-windows-amd64.exe -OutFile firescan.exe\n```\n\n### روش ۳: بیلد از سورس\n```bash\ngit clone https://github.com/mr-coder20/FireScan.git\ncd FireScan\nmake build\n./bin/firescan --help\n```\n\n---\n\n## 🤝 مشارکت\n\n1. Fork کن\n2. Branch بساز: `git checkout -b feature/amazing-feature`\n3. Commit کن: `git commit -m 'Add amazing feature'`\n4. Push کن: `git push origin feature/amazing-feature`\n5. Pull Request بفرست\n\n---\n\n## ⭐ حمایت\n\nاگه FireScan به کارت اومد:\n\n- ⭐ ستاره بده — به بقیه کمک میکنه پیدا کنند\n- 🐛 باگ گزارش کن\n- 🔧 کدت رو مشارکت بده\n- 📢 به دوستات معرفی کن\n\n---\n\n## 📜 لایسنس\n\nMIT License — استفاده تجاری و شخصی آزاد\n\n```\nMIT License\n\nCopyright (c) 2026 mr-coder20\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files...\n```\n\n---\n\n## 🌐 ارتباط\n\n| پلتفرم | لینک |\n|---|---|\n| GitHub | [mr-coder20/FireScan](https://github.com/mr-coder20/FireScan) |\n| Issues | [گزارش باگ / درخواست ویژگی](https://github.com/mr-coder20/FireScan/issues) |\n| Discussions | [GitHub Discussions](https://github.com/mr-coder20/FireScan/discussions) |\n\n---\n\n\u003ch3 align=\"center\"\u003e🔥 FireScan — \"Speed of Masscan ❄ Depth of Nmap\"\u003c/h3\u003e\n\u003ch5 align=\"center\"\u003eساخته شده با ❤️ در ایران 🇮🇷\u003c/h5\u003e\n\n---\n\n---\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-coder20%2Ffirescan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmr-coder20%2Ffirescan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmr-coder20%2Ffirescan/lists"}