Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔍 netscan

Un script híbrido (Bash + Python) para auditar mi red doméstica y diagnosticar la calidad de la conexión en segundos.

Este proyecto nació de una necesidad cotidiana: monitorear de forma rápida los dispositivos conectados a mi red y verificar la latencia de salida a Internet sin tener que navegar por los menús lentos de la interfaz web de mi módem.


🛠️ ¿Cómo funciona?

El flujo es simple e interactivo:

  1. Entrada Segura: El script de Bash te pide las credenciales de acceso al router (las cuales se manejan en memoria temporal, sin guardarse en disco).
  2. Diagnóstico WAN: Consulta tu IP pública y realiza un traceroute visual en forma de árbol hacia Cloudflare (1.1.1.1), clasificando la latencia actual.
  3. Control Wi-Fi (Scraping en Python): Mediante requests y BeautifulSoup, consulta el panel de control del módem, lista los dispositivos Wi-Fi conectados en las bandas 2.4 GHz / 5 GHz y calcula una distancia física estimada según la potencia de la señal (RSSI).
  4. Escaneo LAN: Descubre dispositivos cableados usando arp-scan y resuelve nombres locales, descartando los que ya fueron detectados en Wi-Fi.

⚠️ Nota de Compatibilidad y Adaptabilidad

Este proyecto está diseñado a medida para la interfaz de mi router actual (el cual expone páginas .asp como wlanStatus.asp).

  • No es plug-and-play universal: Si lo corres en tu casa, probablemente fallará la sección de scraping porque cada router tiene un panel web distinto.
  • ¡Siéntete libre de adaptarlo! Puedes clonar el repositorio y modificar la lógica en wifi_scraper.py para adecuar los selectores HTML y endpoints al módem de tu hogar.

🚀 Requisitos rápidos

Si quieres explorar o adaptar el proyecto, necesitas:

  • Herramientas de red: arp-scan y traceroute instalados en tu sistema Linux / WSL.
  • Python 3: Con las librerías requests y beautifulsoup4 (se recomienda usar un entorno virtual venv).

Creado con fines de aprendizaje y administración de red personal por 0Luchin para larlab.xyz.

About

Monitoreo rápido de red doméstica: Diagnóstico de latencia WAN y mapeo interactivo de clientes LAN/WLAN mediante Bash y web scraping (Python).

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages