Infracheck-Bedienungsanleitung.

Übersicht

Infracheck ist ein lokaler Netzwerkdiagnose-Stack für Heimanwender, kleine Büros, IT-Supportteams und MSPs. Es beginnt mit Android- und Windows-Apps für das eigene Gerät des Benutzers und fügt dann eine Docker-basierte lokale Appliance hinzu, wenn eine Site kontinuierliche Beweise benötigt.

Informationen zur Produktpositionierung und Anwendungsfallseiten finden Sie unter Was ist Infracheck?, Selbstgehostete MSP-Überwachung, Überwachung der Docker-Appliance, Android-WLAN-Diagnose, und Netzwerk-Beweisberichte. Zur praktischen Fehlerbehebung verwenden Sie Wi-Fi-Qualitäts- und Stabilitätstest und Lokale Netzwerkdiagnose.

Architektur

Der Stack ist bewusst einfach gehalten: Das Telefon erfasst die Kundenerfahrung, die Appliance erfasst standortweite Telemetriedaten und die Premium-Zentralisierung bleibt selbst gehostet.

Nur App-Diagnose

Verwenden Sie die App nur, wenn Sie das Netzwerk vom Telefon oder PC aus überprüfen möchten, sei es bei der Fehlerbehebung in Ihrem eigenen Heim-WLAN oder beim Sammeln von Beweisen während eines Support-Besuchs.

Quick-Scan-Prüfungen

• SSID, BSSID, IP/DHCP-Details, RSSI, Verbindungsgeschwindigkeit, Kanal und Android-Internetvalidierung.
• DNS-Latenz, HTTP-Latenz, öffentliche IP, Captive-Portal-Verhalten, benachbarte Netzwerke und Kanalüberlastung.
• Empfehlungen für schwaches Signal, niedrige Verbindungsrate, Kanalstörungen, langsames DNS, langsames HTTP und Captive-Portal-Probleme.

Wi-Fi-Tools

• Manuelles Starten/Stoppen der Probenahme bei ortsabhängigen oder intermittierenden Problemen.
• Live-RSSI/BSSID-Diagramme und gespeicherter Analyseverlauf.
• Das Netzwerk in der Nähe prüft Kanäle, Sicherheit, Überlastung und starke Nachbarn.
• Beweise im Roaming-Stil mit BSSID-Änderungen, RSSI-Bereich, Stichprobenanzahl und Empfehlungen.

Windows-App-Diagnose

Verwenden Sie die Windows-App, wenn für die Beschwerde Beweise von einem Laptop, Desktop, einem kabelgebundenen Adapter, einem VPN-Pfad, einer Windows-WLAN-Umgebung, einem DNS-Resolver oder einem lokalen Subnetz benötigt werden. Es funktioniert eigenständig und erfordert kein Gerät.

Primärer Arbeitsablauf

1. Öffnen Sie die App und führen Sie sie aus Überprüfen Sie diesen PC jetzt aus der Übersicht.
2. Überprüfen Sie Gateway, DNS, HTTP, öffentliche IP, Adapterstatus und Empfehlungen.
3. Offen Wi-Fi Live für die Analyse von Netzwerken und Kanälen in der Nähe.
4. Offen Ethernet und LAN für kabelgebundene Adapter und sichere Subnetzerkennung.
5. Benutzen Werkzeuge für Geschwindigkeit, Trace-Route, DNS-Suche, HTTP, TCP, MTU, VPN/Routen, DNS-Vergleich, DHCP, TLS und Qualitätstests.
6. Exportieren Sie einen PDF-Bericht, wenn Sie Kunden- oder Ticketnachweise benötigen.

Öffentliche Screenshots hashen absichtlich WLAN-Namen und BSSIDs und maskieren private Adressen, Appliance-URLs, öffentliche IP-Beispiele und Token. Das Produkt selbst speichert den Diagnoseverlauf lokal unter dem Windows-Benutzerprofil, es sei denn, der Benutzer exportiert einen Bericht.

Öffnen Sie das Windows-App-Repository.

App + Appliance-Workflow

Verwenden Sie diesen Modus, wenn eine Linux-Docker-Appliance in einem Heim-, Büro- oder Kundennetzwerk bereitgestellt wird. Dies ist nützlich, wenn der Verlauf nach der ersten Überprüfung oder dem ersten Supportbesuch verfügbar bleiben muss.

1. Entdecken Sie die Appliance über mDNS _infracheck._tcp, or pair manually by URL and admin token.
2. Überprüfen Sie den Zustand, das Problemradar, die neuesten Werte, Diagramme, aktive Warnungen, die WAN-Geschwindigkeit und das LAN-Inventar.
3. Bestätigen Sie Benachrichtigungen, blenden Sie sie für 24 Stunden aus oder schließen Sie Benachrichtigungen direkt in der App.
4. Bearbeiten Sie Hostnamen-Überschreibungen und Technikerkommentare für LAN-Geräte.
5. Konfigurieren Sie Erkennungsbereiche, Ziele, Schwellenwerte, WAN-Geschwindigkeitsbegrenzungen, Aufbewahrung und Admin-Token.
6. Erstellen und teilen Sie Appliance-PDF-Berichte, wenn der Kunde Beweise benötigt.
7. Verwenden Sie „Telefon vs. Gerät“, wenn das Telefon ein Problem erkennt, das das Gerät nicht erkennt, oder wenn das Gegenteil der Fall ist.
8. Verwenden Sie Feldtools für Site AutoTest, lokalen Durchsatz, VoIP-Bereitschaft, progressive Pfadprüfungen, DNS/DHCP-Integrität, SNMP/LLDP-Topologie und WLAN-Grundrissuntersuchung.

Geräteinstallation

Infracheck v1 zielt auf Linux-Docker-Hosts im Ziel-LAN ab.

Anforderungen

• Linux-Host im Kundennetzwerk.
• Docker Engine und Docker Compose-Plugin.
• Internetzugang während der Erstinstallation, damit Bilder heruntergeladen werden können.

Von GitHub installieren

Das kostenlose Appliance-Repository ist unter verfügbar github.com/gatgserv/infracheck-appliance.

git clone https://github.com/gatgserv/infracheck-appliance.git
cd infracheck-appliance
sh scripts/install-linux.sh

Aktionen des Installationsprogramms

• Erstellt .env with generated admin/read/Grafana tokens if missing.
• Erstellt config/config.yaml from the example if missing.
• Erstellt das Persistente data/ folder.
• Öffnet allgemeine Firewalld-Ports, wenn Firewalld aktiv ist.
• Läuft docker compose up -d --build.

Offene Dienste

• Appliance-Benutzeroberfläche: http://<host-ip>:8080/ui
• Grafana: http://<host-ip>:3000
• Prometheus: http://<host-ip>:9090
• Alertmanager: http://<host-ip>:9093

Upgrade und Rollback

Bewahren Sie vor dem Upgrade eine Kopie davon auf .env, config/config.yaml, and the persistent data/ folder. The appliance stores local history in SQLite and generated reports under the mounted data path.

cd infracheck-appliance
cp .env .env.backup
cp config/config.yaml config/config.yaml.backup
docker compose pull
docker compose up -d --build

Wenn ein Upgrade fehlschlägt, stellen Sie die vorherige Repository-Version und die gespeicherten Konfigurationsdateien wieder her und führen Sie es dann aus docker compose up -d --build again. Do not delete data/ unless you intentionally want to clear local history and reports.

Konfiguration

Die Standard-Appliance-Konfiguration ist unter gemountet /etc/infracheck/config.yaml. In local deployments, edit container/config/config.yaml.

Wichtige Umgebungsüberschreibungen

Entdeckungsbereiche

Wenn die Erkennungs-CIDRs leer sind, erkennt der Agent automatisch direkt verbundene IPv4-Netzwerke und begrenzt breite Masken auf /24. For routed networks or multiple VLANs, configure every range explicitly.

targets:
  discovery:
    cidrs:
      - "192.168.10.0/24"
      - "192.168.20.0/24"
      - "10.20.0.0/23"

Zeitpläne, Aufbewahrung und Speicherung

Auf der Konfigurationsseite können Sie festlegen, wie oft jede Prüfung ausgeführt wird: Ping, DNS, HTTP/TLS, LAN-Erkennung, WAN-Geschwindigkeit und erweiterte Prüfungen können unabhängig voneinander geplant werden. TLS-Ablaufprüfungen erfordern normalerweise keine Häufigkeit auf Minutenebene; Die tägliche Trittfrequenz reicht normalerweise aus, es sei denn, die Zielliste ändert sich häufig.

Der bereitgestellte Datenpfad speichert den SQLite-Verlauf und generierte Berichte. Konfigurieren Sie die Aufbewahrung so, dass sie den Kundenrichtlinien, den Ticketnachweisanforderungen und der Festplattengröße entspricht. Bei kleinen Standorten ist es in der Regel sinnvoller, die aktuelle Betriebshistorie sowie ausgewählte Kundenberichte aufzubewahren, als jede Rohprüfung für immer aufzubewahren.

• SQLite: Überprüfen Sie den Verlauf, den Alarmlebenszyklus, den Gerätebestand, Beschriftungen, Kommentare, Einstellungen und Berichtsdatensätze.
• Berichte: generierte PDF/HTML-Beweisdateien, die im Berichtspfad gespeichert sind.
• Backups: kopieren .env, config/config.yaml, and data/ before upgrades or host migration.

Dashboard und operative Benutzeroberfläche

Die Appliance-Benutzeroberfläche ist als lokales Netzwerkzustands-Dashboard für Eigentümer, Administratoren und Supportteams konzipiert.

• Dashboard: Gesamtzustand, Problemradar, Ergebnisse, Netzwerkqualität, WAN-Geschwindigkeit, LAN-Geräte, letzte Überprüfungen und Berichtsaktionen.
• Warnungen: Aktive und historische Alarme mit Schweregrad, Auslösezeit, Bestätigungszeit, Löschzeit, Details, Bestätigungs-, Schließ- und temporären Ausblend-/Unterdrückungsaktionen.
• Inventar: erkannte Geräte, zuerst/zuletzt gesehene Zeitstempel, Hostnamen-Überschreibung und Technikerkommentare.
• Konfiguration: Erkennungsbereiche, Ping-/DNS-/HTTP-/TLS-Ziele, erweiterte Prüfungen, WAN-Geschwindigkeitsbegrenzungen, Alarmschwellenwerte, Aufbewahrung und Administrator-Token-Änderungen.

Berichte und Kundenbeweise

Berichte verwandeln Supportarbeit in für den Kunden sichtbare Beweise. Verwenden Sie sie nach der Installation, nach der Vorfallstriage, vor/nach der Behebung oder für wiederkehrende Kontoüberprüfungen.

• Zusammenfassung und Gesundheitsbewertung.
• Details zur Problemlokalisierung und Triage.
• Auswirkungen auf die Gesundheit, Ergebnisse, Empfehlungen und Grafiken.
• Min/Durchschnitt/Max-Statistiken für den ausgewählten Berichtszeitraum.
• Alarmlebenszyklus, aktuelle Prüfungen und LAN-Inventar-Snapshot.

Sicherheitsmodell

Infracheck ist lokal an erster Stelle. Die kostenlose Appliance läuft im Kundennetzwerk und die Premium-Zentralisierung ist als selbstgehostete Appliance geplant.

• Leseendpunkte können standardmäßig im LAN öffentlich bleiben.
• Mutierende Endpunkte erfordern das Admin-Token.
• Zu den Mutationsaktionen gehören manuelle Testläufe, das Starten/Stoppen des iperf3-Servers, die manuelle LAN-Erkennung und die Berichterstellung.
• Metriken sind für Prometheus standardmäßig öffentlich. Set security.protect_metrics: true or INFRACHECK_PROTECT_METRICS=true to protect /metrics.
• Set security.allow_public_reads: false or INFRACHECK_ALLOW_PUBLIC_READS=false to protect read-only API endpoints.
• Der Agent akzeptiert Authorization: Bearer <token> and X-Infracheck-Token: <token>.
• Der Stack nutzt Host-Netzwerke unter Linux und begrenzte Netzwerkfunktionen. Es ist nicht erforderlich --privileged by default.
• Behalten .env, generated tokens, Grafana credentials, and data/ private.

API- und Diagnosebefehle

Verwenden Sie diese Befehle während der Installationsvalidierung, Fehlerbehebung oder Automatisierung.

curl http://localhost:8080/healthz
curl http://localhost:8080/readyz
curl http://localhost:8080/api/v1/info
curl http://localhost:8080/api/v1/health
curl http://localhost:8080/api/v1/verdicts/latest
curl http://localhost:8080/api/v1/recommendations
curl http://localhost:8080/api/v1/tests/ping/latest
curl http://localhost:8080/api/v1/tests/dns/latest
curl http://localhost:8080/api/v1/tests/http/latest
curl http://localhost:8080/api/v1/tests/speed/latest
curl http://localhost:8080/api/v1/devices
curl http://localhost:8080/api/v1/reports

Geschützte Aktionen

curl -X POST http://localhost:8080/api/v1/tests/ping/run \
  -H "Authorization: Bearer $INFRACHECK_ADMIN_TOKEN"

curl -X POST http://localhost:8080/api/v1/discovery/run \
  -H "Authorization: Bearer $INFRACHECK_ADMIN_TOKEN"

curl -X POST http://localhost:8080/api/v1/reports/generate \
  -H "Authorization: Bearer $INFRACHECK_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"daily","hours":24}'

Fehlerbehebung

Protokolle prüfen

cd container
docker compose logs -f

Überprüfen Sie den Zustand und die Kennzahlen

curl http://localhost:8080/healthz
curl http://localhost:8080/readyz
curl http://localhost:8080/metrics

Starten Sie einen lokalen Durchsatztestserver

curl -X POST http://localhost:8080/api/v1/iperf/server/start \
  -H "Authorization: Bearer $INFRACHECK_ADMIN_TOKEN"
iperf3 -c <agent-ip>
curl -X POST http://localhost:8080/api/v1/iperf/server/stop \
  -H "Authorization: Bearer $INFRACHECK_ADMIN_TOKEN"

Führen Sie die LAN-Erkennung aus

curl -X POST http://localhost:8080/api/v1/discovery/run \
  -H "Authorization: Bearer $INFRACHECK_ADMIN_TOKEN"
curl http://localhost:8080/api/v1/devices

Wenn die automatische Gateway-Erkennung fehlschlägt, legen Sie fest targets.gateway.address explicitly in the config.

Roadmap für selbst gehostete Premium-Lizenzen

Premium ist als kostenpflichtige Lizenz für Organisationen positioniert, die zentrale Vorgänge benötigen, ohne Kundendaten in ein vom Anbieter gehostetes SaaS zu zwingen.

• Selbstgehostetes zentrales Portal für mehrere Appliances.
• Kunden-/Standortgruppierung für MSPs.
• E-Mail-, Webhook-, Slack- oder Teams-Benachrichtigungsweiterleitung.
• White-Label-Branding und Markenberichte.
• Rollen, Berechtigungen, API-Zugriff und prüfungsorientierte Arbeitsabläufe.

FAQ

Ist die App kostenlos?

Ja. Die Feld-App ist als kostenlos positioniert.

Ist das Gerät kostenlos?

Ja. Das lokale Gerät/Behälter wird als frei positioniert.

Ist Premium ein SaaS-Abonnement?

Nein. Die aktuelle Positionierung ist eine kostenpflichtige Premium-Lizenz mit einem selbst gehosteten zentralen Portal.

Wo ist der Appliance-Download?

Die kostenlose Appliance wird unter veröffentlicht github.com/gatgserv/infracheck-appliance. Die Download-Seite enthält Links zum Repository und zur Version 1.0.0.

Was sollte ich nach der Bereitstellung überprüfen?

1. Bestätigen Sie, dass die Appliance-Benutzeroberfläche geöffnet wird http://<appliance-ip>:8080/ui.
2. Legen Sie ein starkes Admin-Token fest und speichern Sie es im App-Pairing-Bildschirm.
3. Konfigurieren Sie Bereiche, Ziele und Schwellenwerte für die echte Kundenerkennung.
4. Führen Sie manuelle Ping-, DNS-, HTTP-, Erkennungs- und WAN-Geschwindigkeitstests durch.
5. Erstellen Sie einen aktuellen Statusbericht und bestätigen Sie, dass Diagramme und Tabellen korrekt aussehen.