FireScan - Hybrid port scanner combining 5 engines (Masscan,

项目说明

🔥 FireScan

The ultimate hybrid port scanner for modern security workflows — fast, polished, extensible, and built for real-world usage.

! !Go !Platform !License

FireScan 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.

✨ Why FireScan is special

Hybrid engine orchestration with failover

Pure-Go fallback for en without extra dependencies

Rich output: table, JSON, CSV, HTML, greppable

CIDR and IP range expansion

Interacti and simple command-line usage

Beautiful HTML report generation with auto-open support

🚀 Quick install

Windows (PowerShell)

If you built it locally:

Linux / macOS

Build from source

🧪 Basic usage

Fast scan

Full scan with HTML report

Scan from stdin

Interactive mode

📋 Examples

Web service scan

Fast top-ports scan

Internal network scan with HTML report

Stealth scan

Force a non-Nmap engine

Pure-Go fallback scan

Read targets from stdin

⚙️ Command reference

Common flags

-p, --ports: port list or range

--all-ports: scan all 65535 ports

--top-ports: scan the top N common ports

--top100: shortcut for top 100 ports

--top1000: shortcut for top 1000 ports

-e, --engine: select engine (auto, masscan, rustscan, nmap, naabu, naive)

--preset: balanced, fast, stealth

-f, --format: table, json, csv, html, greppable

-o, --output: sa to a file

-i, --interactive: interacti

--dry-run: preview the planned scan without executing it

--no-failover: disable fallback between engines

--max-hosts: cap the number of expanded targets

🧠 Output formats

table: human-readable terminal summary

json: JSON output for automation

csv: spreadsheet-friendly data

html: polished browser-based report

greppable: simple line-oriented scan output

🇮🇷 نسخه فارسی

FireScan یک اسکنر پورت هیبریدی مدرن و حرفه‌ای است که سرعت ابزارهای اسکن سریع و عمق ابزارهای Recon را در یک تجربه کاربری واحد ترکیب می‌کند.

ویژگی‌های کلیدی

انتخاب خودکار موتور اسکن با fallback هوشمند

موتور Pure-Go برای محیط‌هایی بدون وابستگی خارجی

خروجی‌های حرفه‌ای برای CLI، JSON، CSV، HTML و greppable

پشتیبانی از CIDR و IP range

حالت تعاملی و رابط ساده برای استفاده روزمره

تولید گزارش HTML زیبا با باز شدن خودکار در مرورگر

نصب سریع

#### ویندوز

#### لینوکس / مک

مثال‌های کاربردی

نمونه دستورهای بیشتر

اسکن سریع با RustScan:

خواندن اهداف از stdin:

اسکن در حالت تعاملی:

🛡️ Notes

FireScan is designed to be practical, fast, and user-friendly. The default behavior is conser and safe, while ad flags allow more aggressive or stealthy scanning when appropriate.

Use responsibly and only against systems you own or are authorized to test.
│ Entry Point │
└────────┬────────┘
│
┌────────▼────────┐
│ ⚙️ Auto-Engine │
│ Selector │
└──┬──────┬──────┘
│ │
┌───────────┤ ├───────────┐
▼ ▼ ▼ ▼
┌─────────┐ ┌────────┐ ┌────────┐ ┌─────────┐
│Masscan │ │RustScan│ │ Naabu │ │ Nmap │
│(C) │ │(Rust) │ │(Go) │ │(C/Lua) │
└────┬────┘ └───┬────┘ └───┬────┘ └────┬────┘
└──────────┼──────────┼───────────┘
│ │
┌──────▼──────────▼──────┐
│ 🔵 Nai │
│ (Pure Go - Always) │
└──────────┬─────────────┘
│
┌──────────▼─────────────┐
│ 🧠 AI Q-Learning │
│ Timing Optimizer │
└──────────┬─────────────┘
│
┌──────────▼─────────────┐
│ 📊 Output Renderer │
│ Table/JSON/CSV/HTML │
└────────────────────────┘
bash
go install github.com/mr-coder20/FireScan/cmd/firescan
bash

Linux

wget -O firescan && chmod +x firescan

macOS (Intel)

wget -O firescan && chmod +x firescan

macOS (Apple Silicon)

wget -O firescan && chmod +x firescan

Windows

iwr -Uri -OutFile firescan.exe
bash
git clone
cd FireScan
make build
./bin/firescan --help
bash
docker build -t firescan -f build/Dockerfile .
docker run --rm -it firescan scanme.nmap.org
yaml

.github/workflows/release.yml — Builds for all platforms

name: Release
on:
push:
tags: ['v*']
jobs:
release:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-go@v5
- run: make release
yaml

.github/workflows/test.yml — CI testing

name: Test
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-go@v5
- run: go test ./...
dockerfile
FROM golang:1.22-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -o /firescan ./cmd/firescan

FROM alpine:latest
RUN apk add --no-cache ca-certificates
COPY --from=builder /firescan /usr/local/bin/firescan
ENTRYPOINT ["firescan"]
bash

Clone

git clone

Build

make build

Test

make test

Run locally

go run ./cmd/firescan/ --help

Cross-compile all platforms

make release

FireScan/
├── cmd/firescan/main.go # Entry point (Cobra CLI)
├── internal/
│ ├── scanner/ # Scanning engines
│ │ ├── engine.go # Engine interface
│ │ ├── naive.go # Pure Go fallback
│ │ ├── masscan.go # Masscan wrapper
│ │ ├── rustscan.go # RustScan wrapper
│ │ ├── nmap.go # Nmap wrapper
│ │ └── naabu.go # Naabu wrapper
│ ├── output/formatter.go # Output renderer
│ ├── config/config.go # Configuration
│ └── parser/ # Result parsers
├── pkg/
│ ├── api/api.go # REST API
│ └── types/ # Shared types
├── scripts/
│ ├── install.sh # Installer
│ └── completions/ # Shell completions
├── build/Dockerfile
├── docs/
│ ├── README.fa.md # Persian documentation
│ ├── CONTRIBUTING.md
│ └── SECURITY.md
├── .github/workflows/
│ ├── release.yml
│ └── test.yml
├── Makefile
├── go.mod
└── README.md

MIT License

Copyright (c) 2026 mr-coder20

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The abo notice and this permission notice shall be included in all
copies or substantial portions of the Software.
bash

Nmap برای اسکن کامل ۳۰ دقیقه وقت نیاز داره

nmap -p- target.com # ۳۰+ دقیقه

FireScan در ۱۲ ثانیه با همون عمق انجام میده

firescan target.com --all-ports -V -O -f html -o report.html # ۱۲ ثانیه
bash

بقیه ابزارها روی سیستم تازه:

apt install masscan nmap rustscan # ۲۰۰MB+ وابستگی

FireScan:

go install github.com/mr-coder20/FireScan/cmd/firescan # فقط کار میکنه ✅
bash
firescan target.com -f html -o scan_report.html

→ گزارش HTML زیبا و حرفه‌ای

→ JSON برای CI/CD

→ CSV برای Excel

bash
curl -sSL | bash
powershell
iwr -Uri -OutFile firescan.exe
bash
docker pull ghcr.io/mr-coder20/firescan:latest
docker run --rm -it firescan scanme.nmap.org
bash
go install github.com/mr-coder20/FireScan/cmd/firescan
bash

اسکن کامل ۶۵۵۳۵ پورت با تشخیص سرویس در کمتر از ۱۵ ثانیه

firescan scanme.nmap.org --all-ports -V -O
bash

Bug Bounty

firescan target.com --top-ports 1000 -V -f json -o bounty.json

تست نفوذ داخلی

firescan 192.168.1.0/24 --all-ports -V -O --vuln -f html -o report.html

ردد تیم — حالت مخفی

firescan 10.0.0.5 -p 22,80,443 -e rustscan --rate 200

مانیتورینگ روزانه SOC

echo "192.168.1.1" | firescan --pipe --fast -f csv -o daily.csv
bash
-f table → جدول (پیش‌فرض)
-f json → JSON
-f csv → CSV
-f html → HTML حرفه‌ای
-f greppable → سازگار با grep

┌─────────────────┐
│ 🎯 TARGET │
└────────┬────────┘
│
┌────────▼────────┐
│ 🔥 FireScan │
└────────┬────────┘
│
┌────────▼────────┐
│ ⚙️ انتخاب │
│ خودکار موتور │
└──┬──────┬──────┘
│ │
┌───────────┤ ├───────────┐
▼ ▼ ▼ ▼
┌─────────┐ ┌────────┐ ┌────────┐ ┌─────────┐
│Masscan │ │RustScan│ │ Naabu │ │ Nmap │
└────┬────┘ └───┬────┘ └───┬────┘ └────┬────┘
└──────────┼──────────┼───────────┘
│ │
┌──────▼──────────▼──────┐
│ 🔵 Nai │
│ (Pure Go) │
└──────────┬─────────────┘
│
┌──────────▼─────────────┐
│ 🧠 AI Timing │
└──────────┬─────────────┘
│
┌──────────▼─────────────┐
│ 📊 Output Renderer │
└────────────────────────┘
bash
go install github.com/mr-coder20/FireScan/cmd/firescan
bash

لینوکس

wget -O firescan && chmod +x firescan

ویندوز

iwr -Uri -OutFile firescan.exe
bash
git clone
cd FireScan
make build
./bin/firescan --help

MIT License

Copyright (c) 2026 mr-coder20

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files...
```

---

🌐 ارتباط

| پلتفرم | لینک |
|---|---|
| GitHub | mr-coder20/FireScan |
| Issues | گزارش باگ / درخواست ویژگی |
| Discussions | GitHub Discussions |

---

<h3 align="center">🔥 FireScan — "Speed of Masscan ❄ Depth of Nmap"</h3>
<h5 align="center">ساخته شده با ❤️ در ایران 🇮🇷</h5>

---

---

项目信息

开发语言：Go

Star 数：8

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕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.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。