Escáner de dispositivos en red local escrito en Python.
- Detección de hosts mediante ARP scan (scapy) con fallback a ping sweep.
- Identificación de fabricante a partir de la dirección MAC (OUI de IEEE).
- Detección de hostname por DNS reverso.
- Modo pasivo: escucha ARP en la red sin enviar tráfico (requiere root).
- Exportación de resultados a JSON y CSV.
- CLI sencilla con argparse; también usable como librería Python.
pip install .Con el backend ARP (recomendado):
pip install .[arp]# Escanear la red a la que pertenece una IP (auto-detecta interfaz y CIDR)
apnetscan --target 192.168.1.1
# Escanear un rango CIDR concreto
apnetscan --target 192.168.1.0/24
# Escanear varias redes
apnetscan --target 192.168.1.0/24 10.0.0.0/24
# Solo ping sweep (sin scapy)
apnetscan --target 192.168.1.0/24 --method ping
# Modo pasivo (escucha ARP durante 60 s, requiere root)
apnetscan --passive --duration 60
# Exportar resultados
apnetscan --target 192.168.1.0/24 --json out.json --csv out.csvSalida de ejemplo:
IP MAC FABRICANTE HOSTNAME
192.168.1.1 aa:bb:cc:dd:ee:ff Vendor Name router.local
192.168.1.10 11:22:33:44:55:66 Other Vendor laptop.local
from apnetscan import Scanner
scanner = Scanner(method="arp")
results = scanner.scan("192.168.1.0/24")
for host in results:
print(host.ip, host.mac, host.vendor)- Python 3.9+
- El escaneo ARP y el modo pasivo requieren privilegios de root/administrador (acceso a sockets raw).
Usa APNetScan únicamente en redes propias o para las que tengas autorización. Escanear redes de terceros sin permiso puede ser ilegal.
- Estimación de SO por TTL (Windows / Linux-Unix-macOS / IoT) en cada host detectado.
- Inventario persistente (
scan --save) en~/.apnetscan/inventory.jsoncon comparación de deltas (scan --diff): dispositivos nuevos (+), desaparecidos (-) y modificados (~) en MAC o hostname. - Modo watch (
apnetscan watch -t 192.168.1.0/24 --interval 30): re-escanea periódicamente y refresca la lista de dispositivos.
- Rebrand de la app compilada a APSoft: nuevo comando
apsoft(se mantieneapnetscancomo alias) y banner ASCII con el título APSoft. - Salida gráfica tipo panel: tabla con bordes box-drawing (┌─┬─┐) y colores ANSI que se desactivan automáticamente en pipes/CI para máxima estabilidad.
- Escaneo de rangos de puertos:
--port-range 1-1024,--port-range 80o--port-range 20-25,80,443enscan,watchytui. - Panel TUI interactivo (
apsoft tui, requierepip install apnetscan[tui]): tabla viva con navegación ↑/↓,rpara refrescar,wpara enviar WOL al dispositivo seleccionado yqpara salir. Se re-escanea automáticamente cada--intervalsegundos.
- Al ejecutar
apnetscan(sin subcomando) se abre un menú interactivo con banner APSoft y panel de opciones: escanear red, puertos comunes, rango de puertos, WOL, panel TUI, guardar/comparar inventario y modo pasivo. - Renderizado con rich (paneles redondeados, colores); fallback automático a texto plano si rich no está instalado.
- Los subcomandos directos (
apnetscan scan ...) siguen funcionando igual.
- MAC + fabricante en el backend ping: tras el ping sweep se lee la tabla
ARP del sistema (
ip neigh/arp -a, multiplataforma), que el propio ping acaba de poblar. Ya no se necesita scapy ni root para obtener MACs. - Menú: la opción "Escanear red" pregunta si comprobar puertos comunes.
- TTL 254 reinterpretado como "router/IoT (TTL alto)" (etiqueta más precisa).
- Nuevo comando
diag(opción 9 del menú): estado de los adaptadores (up/down/IP), dispositivos de red con error del Administrador de dispositivos de Windows (WMI ConfigManagerErrorCode, con descripción legible del problema) y avisos (adaptador activo sin IP, etc.). - Limpiezas: flush de caché DNS y tabla ARP en Windows/Linux/macOS,
y
--winsock-resetopcional en Windows (requiere admin y reinicio). - Multiplataforma: en Windows usa netsh/ipconfig/PowerShell, en Linux
ipy en macOSifconfig.