Escáner IP de red liviano con GUI web. Características:
Enviar notificación cuando se encuentre un nuevo host
Monitorear el historial de hosts en línea/fuera de línea
Mantenga una lista de todos los hosts de la red.
Envíe datos a InfluxDB2
para crear un panel de Grafana
Reemplace $YOURTIMEZONE
con la zona horaria correcta y $YOURIFACE
con la interfaz de red que desea escanear. El modo de red debe ser host
. Configure $DOCKERDATAPATH
para que el contenedor guarde datos:
ejecución de la ventana acoplable --nombre wyl -e "IFACES=$TUCARA" -e "TZ=$TUZONAHORARIA" --network="anfitrión" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan
La GUI web debe estar en http://localhost:8840
WatchYourLAN no tiene una opción de autenticación incorporada. Pero puedes usarlo con herramientas SSO como Authelia o mi sencilla aplicación de autenticación ForAuth.
A continuación se muestra un ejemplo de docker-compose-auth.yml.
⚠️ ¡ADVERTENCIA!
Por favor, no olvide que WYL necesita el modo de redhost
para funcionar. Por lo tanto, el puerto WYL quedará expuesto en esta configuración. Debe limitar el acceso a él con un firewall u otras medidas.
Todos los paquetes binarios se pueden encontrar en la última versión. Hay archivos .deb
, .rpm
, .apk
(Alpine Linux) y .tar.gz
.
Arquitecturas compatibles: amd64
, i386
, arm_v5
, arm_v6
, arm_v7
, arm64
.
Dependencias: arp-scan
, tzdata
.
Para amd64
hay un repositorio deb
disponible
La configuración se puede realizar a través de un archivo de configuración, GUI o variables de entorno. Los nombres de las variables en el archivo config_v2.yaml
son los mismos, pero en minúsculas.
Variable | Descripción | Por defecto |
---|---|---|
TZ | Configure su zona horaria para la hora correcta | |
ANFITRIÓN | Escuchar dirección | 0.0.0.0 |
PUERTO | Puerto para GUI web | 8840 |
TEMA | Cualquier nombre de tema de https://bootswatch.com en minúsculas o adicional | arena |
COLOR | Color de fondo: claro u oscuro | oscuro |
RUTA DEL NODO | Ruta a los módulos del nodo local | |
SHOUTRRR_URL | WatchYourLAN usa Shoutrrr para enviar notificaciones. Ya está integrado, sólo necesita una URL correcta. Aquí se encuentran ejemplos de Discord, Email, Gotify, Matrix, Ntfy, Pushover, Slack, Telegram, Generic Webhook, etc. |
Variable | Descripción | Por defecto |
---|---|---|
IFACES | Interfaces para escanear. Podrían ser uno o más, separados por espacio. Consulte docs/VLAN_ARP_SCAN.md. | |
SE ACABÓ EL TIEMPO | Tiempo entre exploraciones (segundos) | 120 |
ARP_ARGS | Argumentos a favor de arp-scan . Habilite el nivel de registro debug para ver el comando resultante. (Ejemplo: -r 1 ). Consulte docs/VLAN_ARP_SCAN.md. | |
ARP_STRS ARP_STRS_JOINED | Consulte docs/VLAN_ARP_SCAN.md. | |
LOG_LEVEL | Nivel de registro: debug , info , warn o error | información |
TRIM_HIST | Eliminar historial después de (horas) | 48 |
HIST_IN_DB | Almacenar el historial en la base de datos: si es false , el historial se almacenará solo en la memoria y se perderá al reiniciar la aplicación. Sin embargo, mantendrá la base de datos de la aplicación más pequeña (y se recomienda InfluxDB para el almacenamiento del historial a largo plazo) | FALSO |
USE_DB | Ya sea sqlite o postgres | sqlite |
PG_CONECTAR | Dirección para conectarse a PostgreSQL. (Ejemplo: postgres://username:[email protected]:5432/dbname?sslmode=disable ). Lista completa de parámetros de URL aquí |
Esta configuración coincide con la configuración de Grafana para la fuente de datos InfluxDB
Variable | Descripción | Por defecto | Ejemplo |
---|---|---|---|
INFLUX_ENABLE | Habilitar exportación a InfluxDB2 | FALSO | verdadero |
INFLUX_SKIP_TLS | Omitir TLS Verificar | FALSO | verdadero |
INFLUX_ADDR | Dirección: puerto del servidor InfluxDB2 | https://192.168.2.3:8086/ | |
INFLUX_BUCKET | Cubo InfluxDB2 | prueba | |
INFLUX_ORG | InfluxDB2 organización | hogar | |
INFLUX_TOKEN | Token secreto, generado por InfluxDB2 |
El nombre del archivo de configuración es config_v2.yaml
. Ejemplo:
arp_args: ""color: darkhist_in_db: falsehost: 0.0.0.0ifaces: enp4s0influx_addr: ""influx_bucket: ""influx_enable: falseinflux_org: ""influx_skip_tls: falseinflux_token: ""log_level: infonodepath: ""pg_connect: ""puerto: "8840" gritarrrr_url: "gotify://192.168.0.1:8083/AwQqpAae.rrl5Ob/?title=Host desconocido detectado&DisableTLS=yes"tema: sandtimeout: 60trim_hist: 48use_db: sqlite
Llave | Descripción | Por defecto |
---|---|---|
-d | Ruta al directorio de configuración | /data/WatchYourLAN |
-norte | Ruta a los módulos de nodo (ver más abajo) |
De forma predeterminada, esta aplicación extrae temas, íconos y fuentes de Internet. Pero, en algunos casos, puede resultar útil tener una configuración de red independiente de la global. Creé una imagen separada con todos los módulos y fuentes necesarios. Ejecutar con Docker:
ejecución de la ventana acoplable: nombre nodo-bootstrap -p 8850:8850 aceberg/nodo-bootstrap
ejecución de la ventana acoplable --nombre wyl -e "IFACES=$TUCARA" -e "TZ=$TUZONAHORARIA" --network="anfitrión" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan -n "http://$TU_IP:8850"
O use Docker-compose
Movido a docs/API.md
Cliente API de Python por drwahl
Todos los paquetes de Go enumerados en dependencias.
Favicon y logotipo: iconos de puntos de acceso creados por Freepik - Flaticon
Oreja
Temas: Temas gratuitos para Bootstrap