Ein Befehl auf einem Raspberry Pi 4 oder 5. PingKit Agent überwacht Ihr Netzwerk, solange der Pi eingeschaltet bleibt, und teilt Ihrem iPhone mit Guardian mit, wenn das Internet ausfällt, ein neues Gerät dazukommt oder ein Gerät offline geht.
PingKit fürs iPhone ladenKostenlos im Betrieb, kein Konto. Meldungen auf Ihrem iPhone erfordern Guardian: 2,99 € im Monat oder 29,99 € im Jahr auf dem iPhone, mit 1 Woche kostenlosem Test.
Auf Ihrem Pi läuft schon Pi-hole? Der Agent läuft daneben. Sie nutzen etwas anderes, etwa ein NAS oder einen Linux-Computer mit Docker? Dann folgen Sie den Schritten für Docker.
Öffnen Sie PingKit auf Ihrem iPhone, gehen Sie zu Agents, tippen Sie auf „Agent hinzufügen“ und wählen Sie Raspberry Pi. Merken Sie sich den 8-stelligen Code: Er gilt einmal, für 10 Minuten. PingKit zeigt außerdem den Befehl unten mit Ihrem Code darin, fertig zum Kopieren.
Per SSH oder in einem Terminal auf dem Pi:
curl -fsSL https://pingkit.app/agent/install.sh | sudo sh -s -- --claim-code YOURCODE
Ein Skript direkt an sudo weiterzugeben, verlangt Vertrauen. Das müssen Sie nicht: Laden Sie es herunter, lesen Sie es und führen Sie es dann aus.
curl -fsSL https://pingkit.app/agent/install.sh -o install.sh
less install.sh
sudo sh install.sh --claim-code YOURCODE
Der Kommentar am Anfang listet alles auf, was es tut, der Reihe nach, und sonst nichts:
pingkit-agent, ohne Shell und ohne Home-Verzeichnis;/usr/local/lib/pingkit-agent/ samt seinem systemd-Dienst;/var/lib/pingkit-agent an, den einzigen Ordner, in den der Agent schreiben darf;/etc/sysctl.d/60-pingkit-agent.conf), sofern Ping für sie nicht schon erlaubt ist;/etc/pingkit-agent/env;Der Agent selbst läuft danach als dieser Benutzer ohne Sonderrechte und öffnet nie einen Raw Socket.
Auf einem 32-Bit-System bricht das Skript mit „PingKit Agent needs 64-bit Raspberry Pi OS“ ab und ändert nichts. Ein Pi, der einen 64-Bit-Kernel mit einem 32-Bit-System startet, erhält dieselbe Antwort. Spielen Sie Raspberry Pi OS (64-bit) mit dem Raspberry Pi Imager auf und führen Sie den Befehl erneut aus.
Innerhalb einer Minute zeigt Ihr iPhone den Agent unter Agents an, zusammen mit einem Prüfcode. Das Protokoll des Agents gibt denselben Prüfcode aus, sodass Sie sicher sein können, dass der gekoppelte Agent Ihrer ist: journalctl -u pingkit-agent | grep check_code.
Die Statusseite finden Sie unter http://<Adresse des Pi>:7474/, in jedem Browser in Ihrem Netzwerk. Sie zeigt die Kopplung, das überwachte Netzwerk, den letzten Durchlauf und das Ausfallprotokoll. Gerätenamen und Adressen stehen auf den Seiten „Geräte“ und „Zeitleiste“, geschützt durch eine sechsstellige PIN: Ihr iPhone zeigt sie an, und das Protokoll gibt sie bei jedem Start aus (journalctl -u pingkit-agent | grep page_pin).
Der erste Durchlauf listet, was in Ihrem Netzwerk ist. Noch wird nichts als neu gemeldet: Der Agent lernt, welche Geräte schon Ihre sind.
Die Einstellungen stehen in /etc/pingkit-agent/env, je eine PINGKIT_-Zeile, und wirken nach sudo systemctl restart pingkit-agent.
PINGKIT_NOTIFY_URLS-Zeile, etwa PINGKIT_NOTIFY_URLS=ntfy://192.168.1.5/home-net, dann sendet der Agent seine Meldungen an ntfy, Telegram, Discord, Pushover, einen signierten Webhook oder apprise-api, mit oder ohne iPhone. Die URL-Form jedes Ziels, auf Englisch.PINGKIT_MQTT_URL=mqtt://<Adresse des Brokers>:1883, dazu PINGKIT_MQTT_USERNAME und PINGKIT_MQTT_PASSWORD. Home Assistant zeigt dann einen Sensor für die Internetverbindung, Gerätezahlen, den letzten Ausfall und pro Gerät einen Device Tracker oder einen Verbindungssensor.PINGKIT_SPEED_TEST=manual, dann läuft ein Test nur, wenn Sie ihn anfordern, oder off. Ein Pi im WLAN misst sein eigenes Funkmodul, und seine Tests werden als durch diesen Monitor begrenzt gekennzeichnet.Betreiben Sie den Agent auf demselben Pi. Pi-hole beantwortet DNS auf Port 53 und zeigt seine Verwaltungsseite auf Port 80; die Statusseite des Agents liegt auf Port 7474, und er läuft als eigener Benutzer ohne Sonderrechte. Die einzige Überschneidung ist optional: Der Agent kann Gerätenamen aus DHCP lesen, und wenn Pi-hole Ihr DHCP-Server ist und den Port schon belegt, lässt der Agent diese Funktion aus und läuft weiter. Mehr dazu, was beide tun, steht auf Englisch im Vergleich mit Pi-hole.
Zum Aktualisieren führen Sie den Installationsbefehl erneut mit --update aus: Er installiert die im Skript festgelegte Version und behält Ihre Einstellungen und die Kopplung.
curl -fsSL https://pingkit.app/agent/install.sh | sudo sh -s -- --update
Zum Entfernen nutzen Sie --uninstall. Die Daten des Agents in /var/lib/pingkit-agent und sein Benutzer bleiben erhalten, sodass er nach einer Neuinstallation gekoppelt bleibt; mit --purge werden beide gelöscht.
curl -fsSL https://pingkit.app/agent/install.sh | sudo sh -s -- --uninstall --purge
systemctl status pingkit-agent zeigt, ob der Dienst läuft, und journalctl -u pingkit-agent -f folgt seinem Protokoll. pingkit-agent config check sagt zeilengenau, was an einer Einstellung falsch ist.
Ein Code gilt 10 Minuten. Tippen Sie erneut auf „Agent hinzufügen“, um einen neuen zu erhalten, und geben Sie ihn auf der Statusseite ein, auf Port 7474 des Pi, statt neu zu installieren.
Verwenden Sie die Adresse, die das Skript ausgegeben hat, von einem Gerät im selben Netzwerk, mit :7474 am Ende. Die Seite antwortet nur privaten Adressen, daher öffnet sie sich nicht über eine Portweiterleitung des Routers.
Wenn Ihr System Ping bereits auf einen Bereich beschränkt, der die Gruppe des Agents nicht enthält, sagt das Skript das und lässt die Einstellung unverändert. Der Agent prüft Geräte dann stattdessen per ARP und TCP-Verbindungsversuch, was funktioniert; um Ping hinzuzufügen, erweitern Sie net.ipv4.ping_group_range um die genannte Gruppe.
Raspberry Pi OS hat systemd. Sehen Sie diese Meldung, läuft auf dem Pi ein anderes System; nutzen Sie Raspberry Pi OS (64-bit) oder das Docker-Image auf einem Linux-Host.
Der Agent selbst ist kostenlos, ebenso seine eigenen Seiten mit 30 Tagen Verlauf, seine Meldungen an Ihr eigenes ntfy, Telegram, Discord, Pushover oder Ihren Webhook, seine Home-Assistant-Entitäten über MQTT, das Koppeln eines iPhone, der Status des Agents und die letzten 24 Stunden seiner Zeitleiste auf Ihrem iPhone.
Bezahlt wird die Weiterleitung und das Dashboard, und das finanziert die eine Person, die PingKit entwickelt. Meldungen von Ihrem Agent auf Ihrem iPhone, seine Geräteliste und sein Ausfallprotokoll dort, 90 Tage seiner Zeitleiste und der Internet-Ausfallbericht erfordern PingKit Guardian: 2,99 € im Monat oder 29,99 € im Jahr auf dem iPhone, mit 1 Woche kostenlosem Test. 365 Tage Verlauf und mehr als ein Agent, bis zu fünf, erfordern Guardian Plus.
Ein Raspberry Pi 4 oder 5 mit Raspberry Pi OS in 64 Bit. Kein 32 Bit, und das Skript ist nicht für andere Boards gebaut.
Er überwacht, solange der Pi eingeschaltet bleibt. Verliert der Pi den Strom, wird die Lücke als nicht überwacht verzeichnet, niemals als verfügbar.
Keine WLAN-Messwerte, kein Sicherheitsscan und keine Uptime-Watch-Ziele. Er überwacht Geräte und das Internet.
Ein Gerät wird nach drei verpassten Durchläufen als offline gemeldet, in der Standardeinstellung nach bis zu 45 Minuten.
Er sperrt keine Geräte. Das ist Aufgabe Ihres Routers.
Auf einem Raspberry Pi haben wir ihn noch nicht gemessen. In einem 24-Stunden-Test auf einer virtuellen Linux-Maschine brauchte er höchstens etwa 55 MB Arbeitsspeicher und weniger als 1 % eines Kerns.
Einen Raspberry Pi 4 oder 5 mit Raspberry Pi OS in 64 Bit. Das Installationsskript lehnt ein 32-Bit-System ab, auch einen 64-Bit-Kernel mit 32-Bit-System, und sagt, wie Sie das beheben.
Per Ethernet, wenn möglich. Ein Pi im WLAN meldet seine eigenen WLAN-Aussetzer als Ausfälle, und seine Speedtests werden von seinem Funkmodul begrenzt. WLAN funktioniert; ein Kabel liefert eine sauberere Aufzeichnung.
Ja. Pi-hole nutzt die Ports 53 und 80; die Statusseite des Agents liegt auf Port 7474, und er läuft als eigener Benutzer ohne Sonderrechte. Ist Pi-hole auch Ihr DHCP-Server, bleibt das optionale Auslesen von Gerätenamen aus DHCP aus, und alles andere läuft weiter.
Nein. Sie koppeln ihn mit dem 8-stelligen Code, den PingKit auf Ihrem iPhone unter Agents anzeigt; er gilt einmal, für 10 Minuten. Der Betrieb des Agents ist kostenlos; seine Meldungen in PingKit auf Ihrem iPhone erfordern PingKit Guardian.
Die Verbindung des Agents zum Server von PingKit verstummt. Mit Guardian erfährt Ihr iPhone innerhalb von etwa drei Minuten, dass das Internet zu Hause ausgefallen zu sein scheint, und nach etwa 20 Minuten, dass der Agent sich nicht mehr meldet. Ist der Pi wieder da, verzeichnet der Agent die Zeit, in der er nicht lief, als nicht überwacht, niemals als verfügbar.
Laden Sie PingKit, öffnen Sie Agents und tippen Sie auf „Agent hinzufügen“, um Ihren Code zu erhalten. Der Agent selbst ist kostenlos.
Kostenlos im App Store ladenErfordert iOS 17.0 oder neuer und PingKit 4.0 oder neuer. Der Agent und seine lokalen Meldungen sind kostenlos; Meldungen von Ihrem Agent auf Ihrem iPhone erfordern Guardian.