Leichter Netzwerk-IP-Scanner mit Web-GUI. Merkmale:
Benachrichtigung senden, wenn ein neuer Host gefunden wird
Überwachen Sie den Online-/Offline-Verlauf der Hosts
Führen Sie eine Liste aller Hosts im Netzwerk
Senden Sie Daten an InfluxDB2
um ein Grafana
-Dashboard zu erstellen
Ersetzen Sie $YOURTIMEZONE
durch die richtige Zeitzone und $YOURIFACE
durch die Netzwerkschnittstelle, die Sie scannen möchten. Der Netzwerkmodus muss host
sein. Legen Sie $DOCKERDATAPATH
für den Container fest, um Daten zu speichern:
docker run --name wyl -e „IFACES=$YOURIFACE“ -e "TZ=$YOURTIMEZONE" --network="host" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan
Die Web-GUI sollte sich unter http://localhost:8840 befinden
WatchYourLAN verfügt nicht über eine integrierte Authentifizierungsoption. Sie können es aber mit SSO-Tools wie Authelia oder meiner einfachen Authentifizierungs-App ForAuth verwenden.
Hier ist ein Beispiel für docker-compose-auth.yml.
⚠️ WARNUNG!
Bitte vergessen Sie nicht, dass WYLhost
-Netzwerkmodus benötigt, um zu funktionieren. Daher wird der WYL-Port in diesem Setup verfügbar gemacht. Sie müssen den Zugriff darauf durch eine Firewall oder andere Maßnahmen beschränken.
Alle Binärpakete finden Sie in der neuesten Version. Es gibt .deb
, .rpm
, .apk
(Alpine Linux) und .tar.gz
Dateien.
Unterstützte Architekturen: amd64
, i386
, arm_v5
, arm_v6
, arm_v7
, arm64
.
Abhängigkeiten: arp-scan
, tzdata
.
Für amd64
ist ein deb
-Repo verfügbar
Die Konfiguration kann über eine Konfigurationsdatei, eine GUI oder Umgebungsvariablen erfolgen. Die Variablennamen in der Datei config_v2.yaml
sind gleich, jedoch in Kleinbuchstaben.
Variable | Beschreibung | Standard |
---|---|---|
TZ | Stellen Sie Ihre Zeitzone auf die richtige Zeit ein | |
GASTGEBER | Ansprache anhören | 0.0.0.0 |
HAFEN | Port für Web-GUI | 8840 |
THEMA | Jeder Theme-Name von https://bootswatch.com in Kleinbuchstaben oder zusätzlich | Sand |
FARBE | Hintergrundfarbe: hell oder dunkel | dunkel |
NODEPATH | Pfad zu lokalen Knotenmodulen | |
SHOUTRRR_URL | WatchYourLAN verwendet Shoutrrr zum Versenden von Benachrichtigungen. Es ist bereits integriert, benötigt lediglich eine korrekte URL. Beispiele für Discord, E-Mail, Gotify, Matrix, Ntfy, Pushover, Slack, Telegram, Generic Webhook usw. finden Sie hier |
Variable | Beschreibung | Standard |
---|---|---|
IFACES | Zu scannende Schnittstellen. Könnte einer oder mehrere sein, getrennt durch Leerzeichen. Siehe docs/VLAN_ARP_SCAN.md. | |
TIME-OUT | Zeit zwischen Scans (Sekunden) | 120 |
ARP_ARGS | Argumente für arp-scan . Aktivieren Sie debug Protokollebene, um den resultierenden Befehl anzuzeigen. (Beispiel: -r 1 ). Siehe docs/VLAN_ARP_SCAN.md. | |
ARP_STRS ARP_STRS_JOINED | Siehe docs/VLAN_ARP_SCAN.md. | |
LOG_LEVEL | Protokollebene: debug , info , warn oder error | Info |
TRIM_HIST | Verlauf entfernen nach (Stunden) | 48 |
HIST_IN_DB | Store History in DB – wenn false , wird der Verlauf nur im Speicher gespeichert und geht beim Neustart der App verloren. Allerdings bleibt dadurch die App-Datenbank kleiner (und InfluxDB wird für die langfristige Speicherung des Verlaufs empfohlen). | FALSCH |
USE_DB | Entweder sqlite oder postgres | sqlite |
PG_CONNECT | Adresse zur Verbindung mit PostgreSQL. (Beispiel: postgres://username:[email protected]:5432/dbname?sslmode=disable ). Vollständige Liste der URL-Parameter hier |
Diese Konfiguration entspricht der Konfiguration von Grafana für die InfluxDB-Datenquelle
Variable | Beschreibung | Standard | Beispiel |
---|---|---|---|
INFLUX_ENABLE | Aktivieren Sie den Export nach InfluxDB2 | FALSCH | WAHR |
INFLUX_SKIP_TLS | TLS-Überprüfung überspringen | FALSCH | WAHR |
INFLUX_ADDR | Adresse:Port des InfluxDB2-Servers | https://192.168.2.3:8086/ | |
INFLUX_BUCKET | InfluxDB2-Bucket | prüfen | |
INFLUX_ORG | InfluxDB2 org | heim | |
INFLUX_TOKEN | Geheimes Token, generiert von InfluxDB2 |
Der Name der Konfigurationsdatei ist config_v2.yaml
. Beispiel:
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: ""port: "8840"shoutrrr_url: "gotify://192.168.0.1:8083/AwQqpAae.rrl5Ob/?title=Unbekannter Host erkannt&DisableTLS=yes"theme: sandtimeout: 60trim_hist: 48use_db: sqlite
Schlüssel | Beschreibung | Standard |
---|---|---|
-D | Pfad zum Konfigurationsverzeichnis | /data/WatchYourLAN |
-N | Pfad zu Knotenmodulen (siehe unten) |
Standardmäßig ruft diese App Themen, Symbole und Schriftarten aus dem Internet ab. In manchen Fällen kann es jedoch nützlich sein, eine vom globalen Netzwerk unabhängige Einrichtung zu haben. Ich habe ein separates Bild mit allen notwendigen Modulen und Schriftarten erstellt. Mit Docker ausführen:
Docker run --name Knoten-Bootstrap -p 8850:8850 aceberg/node-bootstrap
docker run --name wyl -e „IFACES=$YOURIFACE“ -e "TZ=$YOURTIMEZONE" --network="host" -v $DOCKERDATAPATH/wyl:/data/WatchYourLAN aceberg/watchyourlan -n "http://$YOUR_IP:8850"
Oder verwenden Sie Docker-Compose
Nach docs/API.md verschoben
Python-API-Client von drwahl
Alle Go-Pakete sind in Abhängigkeiten aufgeführt
Favicon und Logo: Access Point-Symbole erstellt von Freepik – Flaticon
Bootstrap
Themen: Kostenlose Themen für Bootstrap