SpeedScanX ist ein lokales Diagnosetool mit Weboberfläche zur Analyse von Heim- und Büronetzwerken.

Es bietet

• ✅ Ping
• ✅ Speedtest (CLI)
• ✅ Portscanner
• ✅ Netzwerkscan
• ✅ DHCP-Leases und automatisierten Zugriff auf Router-Logdaten

Optimiert

• ✅ Speedport Smart 4
• ✅ universell einsetzbar

Die Anwendung läuft lokal	Speichert keine Daten extern	Liefert strukturierte Ergebnisse mit einer modernen Benutzeroberfläche

---

📁 Projektstruktur

SpeedScanX/
├── .github/workflows                # CI-Automatisierung
│   └── main.yml             
│
├── backend/                         # Backend-Funktionen
│   ├── ping.js                      # Ping mit Latenzanalyse
│   ├── speedtest.js                 # CLI-Speedtest via Ookla
│   ├── scanner.js                   # Ping-Sweep + ARP-Tabelle
│   ├── ports.js                     # Portscan (TCP)
│   ├── dhcp.js                      # DHCP-Analyse via arp -a
│   └── logs.js                      # Router-Logs via Puppeteer
│
├── public/                          # Web-GUI (Frontend)
│   ├── index.html                   # Benutzeroberfläche
│   ├── script.js                    # Diagnosefunktionen (Fetch + Anzeige)
│   └── style.css                    # Neon-UI mit Animation
│
├── utils/                           # Hilfsfunktionen
│   └── secureEnv.js                 # AES-Entschlüsselung (optional)
│
├── app.js                           # API-Router & Express-Server
├── config.json                      # Zentrale Konfiguration (Netz, Sprache, Optionen)
├── .env                             # Router-Passwort (lokal)
├── .env.secure                      # Optional: verschlüsselte .env-Variante
├── .gitignore                       # Ausschluss sensibler Daten
├── install.bat                      # Windows Start-/Install-Skript
├── install.sh                       # Linux/macOS Start-/Install-Skript
├── README.md                        # Diese Dokumentation
├── LICENSE                          # MIT LICENSE
└── SECURITY                         # Security Policy

---

🔍 Funktionen

🧩 Funktion	Beschreibung
📡 Ping-Test	Strukturierte Antwortzeiten (min, max, avg) mit Paketstatistik
📶 Speedtest (CLI)	Download-/Upload-Geschwindigkeit und Ping via Ookla Speedtest CLI
🖧 Netzwerkscan	Aktive Geräte im lokalen Netz durch Ping-Sweep + ARP-Auswertung
📄 DHCP-Leases	IPs und MAC-Adressen über lokale ARP-Tabelle (Windows)
🔌 Portscanner	Scan definierter TCP-Ports auf eine Ziel-IP
📘 Router-Logs	Login in Speedport Webinterface + automatisches Auslesen von Ereignislogs
🌐 Web-GUI	Lokale HTML/JS-Oberfläche mit Neon-Design, ausklappbaren Rohdaten
🔐 .env-Unterstützung	Sicheres Laden sensibler Daten (z. B. Router-PIN) aus .env
🛠️ Konfigurierbar	zentrale config.json für Zielnetz, Portlisten, Sprache etc.

---

1. 🛠️ Installation

Schritt	Befehl / Aktion
📥 Projekt entpacken	Entpacke ZIP oder clone das Repository
🔧 Speedtest CLI installieren	Download hier → z. B. C:\Tools\speedtest.exe
🖊️ .env bearbeiten	Trage dein Router-Passwort ein → ROUTER_PASSWORD=deinpasswort
📦 Abhängigkeiten installieren	npm install
🚀 Starten	node app.js oder install.bat
🌐 Webinterface aufrufen	http://localhost:3000

SpeedScanX bezieht sich auf den Pfad:

`C:\Tools\speedtest.exe`

---

2. Projekt starten

• Windows:
• Linux/macOS:

install.bat

chmod +x install.sh
./install.sh

---

🔐 Konfiguration

1. Router-Passwort in .env eintragen:

ROUTER_PASSWORD=HIER

Dieses Passwort wird zum Login auf dem Speedport verwendet (meist Rückseite des Routers).

---

🌐 Nutzung

• Klicke auf gewünschte Diagnosefunktion:

📡 Ping-Test
📶 Speedtest
🖧 Netzwerkscan
🔌 Portscan
📄 DHCP-Leases
📘 Router-Logs
🌐 Speedport Weboberfläche

---

🧠 Erweiterbar für:

• 📊 JSON-Export & CSV-Protokollierung
• ⚠️ Alerting bei Paketverlust / Portstatus
• 🖥️ Electron-Wrapper für native App (.exe)
• 🔐 Benutzer-Login für zentrale Administrationsumgebung
• 🧩 Auto-Discovery im Netzwerk

Updates in kommenden RELEASE

---

👨‍💻 Autor & Lizenz

• Entwickler: Thorsten Bylicki | BYLICKILABS | WEBSITE
• Lizenz: LICENSE
• Version: SpeedScanX 1.0.x