Skip to content

README.md

Latest commit

 

History

History
165 lines (116 loc) · 4.94 KB

README.md

File metadata and controls

165 lines (116 loc) · 4.94 KB
Raw

NetReconUltra

Go Version Build Status License Issues Frontend Demo

NetReconUltra ist ein hochperformanter, modularer Netzwerk-Scanner und Visualizer. Entwickelt für fortgeschrittene Netzwerkerkennung, Geräte- und Dienstanalyse, Fingerprinting und exaktes Reporting –
visuell, modern, modular.

Backend: Go – ultraschneller Scanner, cleane JSON-Reports
Frontend: React + TypeScript – State-of-the-Art UI, animiertes Dashboard

Features

  • Automatische Netzwerkerkennung – findet und scannt alle aktiven Subnetze
  • Paralleler Ping-/Portscan – blitzschnell, hochskalierbar
  • Service-Banner-Grabbing – erkennt laufende Dienste (HTTP/S, FTP, Drucker, SMB, etc.)
  • Geräte- und OS-Erkennung – per TTL, Banner, Hostname, Port-Profiling
  • Topologische Visualisierung – Übersicht über alle Geräte & Verbindungen (Frontend)
  • Live-Statistiken & Dashboard – Offene Ports, Gerätetypen, Services
  • History- und Delta-Reports – Vergleich von Scans über Zeit (in Planung)
  • Keine sensiblen Daten im Repo: Logs/Reports bleiben ausschließlich lokal
  • Voll responsives Elite-UI – ThemeSwitch (Dark/Light), Neon-Canvas, Animationen

Screenshots

Dashboard (Topologie + Statistiken) Geräteübersicht (Tabelle)
Dashboard Screenshot
Zeigt Topologie-Graph, animierten Hintergrund, StatsChart, ThemeSwitch oben rechts		 Devices Screenshot
Geräte-Tabelle, Icons, offene Ports farbig hervorgehoben

Installation (Backend & Frontend)

Backend (Go-Scanner)

git clone https://github.com/mmadersbacher/NetReconUltra.git
cd NetReconUltra
go mod tidy
go build -o netreconultra ./cmd

Frontend (Visualizer / Dashboard)

cd web-frontend
npm install
npm run dev
  • Die Web-Oberfläche läuft dann auf http://localhost:5173
  • Die Scan-Reports müssen als /public/logs/latest.json vorliegen (siehe Abschnitt "Reporting").

Benutzung / Quickstart

Netzwerkscan starten

# Automatische Interface-/Subnetz-Erkennung:
sudo ./netreconultra scan

# Oder manuell, z.B.:
sudo ./netreconultra scan wlan0 192.168.8.0
  • Der aktuelle Report liegt immer als logs/latest.json
  • Alte Reports werden mit Zeitstempel archiviert: logs/scan_YYYY-MM-DD_HH-MM-SS.json

Frontend starten & Scan visualisieren

  1. Frontend starten (npm run dev)
  2. Gewünschten Scan-Report als web-frontend/public/logs/latest.json speichern
  3. Website neu laden – du siehst die komplette Netzwerk-Visualisierung

Projektstruktur (Kurzüberblick)

NetReconUltra/
├── cmd/        # Go-CLI-Entrypoint
├── core/       # Scan-/Analyse-Module (Go)
├── models/     # Typen, Datenstrukturen
├── data/       # MAC/OUI Datenbank
├── logs/       # Alle Reports (JSON, .gitignored)
├── web-frontend/
│   ├── public/
│   │   ├── assets/   # Logos, Screenshots
│   │   └── logs/
│   ├── src/
│   │   ├── components/
│   │   ├── layout/
│   │   └── App.tsx etc.
│   ├── index.css
│   ├── package.json
│   └── ...
├── go.mod / go.sum
├── README.md
└── .gitignore

Reporting, Datenschutz & Logs

  • Alle Reports werden ausschließlich lokal gespeichert (logs/)
  • Keine gescannten Daten oder privaten Infos verlassen den Rechner
  • Der Ordner logs/ ist im Git ignoriert

Tech Stack

Backend:
Go (>=1.22), Standard Library

Frontend:
React 18, TypeScript, Vite
Framer Motion (Animationen)
Lucide Icons
Chart.js (Statistiken)
Custom Canvas (Hero-Background)
Modernes CSS, Neon-Theme, ThemeSwitch

Demo & Live-Preview

Live-Frontend (Demo auf GitHub Pages):
https://mmadersbacher.github.io/NetReconUltra/
(Demo zeigt Beispieldaten – keine Live-Scans im Browser!)

Lizenz & Credits

MIT License – siehe LICENSE
Created by Mario Madersbacher, 2025

Kontakt & Feedback

Fragen, Bugreports, Featurewünsche:
https://github.com/mmadersbacher/NetReconUltra/issues

Portfolio & Kontakt:
https://github.com/mmadersbacher

Dieses Projekt setzt Maßstäbe für technische Qualität und modernes Design in Open Source-Netzwerktools.