Node64 mit IPv64.net verknüpfen: lokale und hybride Healthchecks

Node64 ist der Homelab-Container von IPv64.net. Verknüpft mit deinem Konto misst er Healthchecks direkt in deinem Heimnetz – auch Ziele, die von außen nicht erreichbar sind – und kombiniert sie mit den Online-Messungen von IPv64.net. Hier steht, wie du eine Node verknüpfst, sie im Portal verwaltest und Checks zwischen online und lokal umhängst.

Was die Verknüpfung bringt

Node64 läuft auch ohne Konto. Mit IPv64.net verbunden, kommen die Außensicht und das Portal dazu. Die Verbindung hat zwei Stufen:

Den API-Key legst du unter API an (siehe Konto: API-Keys). Wie Node64 installiert wird und was er außer Healthchecks kann, steht auf ipv64.net/node64.php und in der Node64-Doku.

Healthchecks-Sync einrichten

Ist in Node64 ein API-Key hinterlegt, verknüpfst du den Healthchecks-Sync direkt in der Node mit einem Klick. Ohne API-Key geht es per Code:

1. Code anfordern
   Öffne in Node64 die Seite Healthchecks-Sync mit ipv64, klicke auf Mit ipv64.net verknüpfen und fordere so einen Code an. Er hat 8 Zeichen (z. B. ABCD-EFGH) und gilt 10 Minuten.
2. Code eingeben
   Melde dich bei IPv64.net an und öffne ipv64.net/link.php (in der Node-Übersicht der Knopf Node mit Healthchecks verknüpfen). Gib den Code ein – mit oder ohne Bindestrich.
3. Standort und Fernverwaltung
   Optional einen freien Standort (z. B. „Zuhause“, „Büro“) und die Fernverwaltung wählen, dann Verknüpfen.
4. Fertig
   Die Node holt sich ihren Zugang selbst und verbindet sich innerhalb von etwa 10 Sekunden. Danach erscheinen sie und ihre Checks im Portal.

Die Node bekommt dabei einen eigenen Zugang, den du einzeln widerrufen kannst – der API-Key wird für den Sync nicht gebraucht. Alle Verbindungen baut die Node ausgehend über HTTPS auf; eine Portfreigabe ist nicht nötig (Details: Node64-Doku: Wer verbindet sich wohin).

Fernverwaltung

Die Fernverwaltung legt fest, welche Befehle das Portal an die Node geben darf:

Ändern kannst du die Einstellung später auf der Detailseite der Node. Die Node entscheidet selbst, was sie annimmt; die Einstellung wird mit dem nächsten Abgleich übertragen.

Node-Übersicht: Nodes verwalten

Unter Nodes in der Leiste der Healthchecks (ipv64.net/nodes.php) siehst du alle deine Node64-Container in einer Liste – egal ob sie sich per API-Key melden, mit dem Healthchecks-Sync verknüpft sind, als Honeypot-Sensor melden oder einen CDN64-Tunnel betreiben. Mit API-Key meldet sich eine Node beim Start und danach alle 15 Minuten.

• Kacheln: Nodes gesamt, online, mit Healthchecks-Sync und Honeypot-Sensoren.
• Je Node: Name mit Standort und Online-Punkt, Version und Plattform, zuletzt gemeldet, Healthchecks-Sync (verbunden oder offline, letzter Abgleich, Zahl der Checks, Konflikte), Honeypot, CDN64-Tunnel und eingeschaltete Module.
• „nicht verknüpft“ heißt: Die Node meldet sich, der Healthchecks-Sync ist aber nicht eingerichtet. „verknüpft (anderer Account?)“ heißt: Der Sync ist mit einem anderen Konto verknüpft.

Node entfernen, wieder zulassen, löschen

Entfernen nimmt eine Node aus deinem Konto:

• Der Healthchecks-Sync wird getrennt; die Checks laufen online weiter, soweit möglich (siehe Sync trennen). Docker- und Proxmox-Checks werden mit der Node gelöscht.
• Ein Honeypot-Sensor der Node wird gesperrt.
• Meldet sich die Node wieder, löscht sie ihren API-Key und die Healthchecks-Verknüpfung; ihre lokalen Daten bleiben.
• CDN64-Namen laufen über den Tunnel der Node weiter, bis du sie in Node64 oder unter ipv64.net/cdn64 ausschaltest.

Entfernte Nodes stehen in einer eigenen Liste. Wieder zulassen macht das rückgängig – danach trägst du in der Node den API-Key neu ein und verknüpfst den Sync bei Bedarf mit einem neuen Code. Löschen entfernt den Eintrag endgültig aus der Liste; ein Honeypot-Sensor der Node bleibt dabei gesperrt. Meldet sich die Node später mit einem neuen API-Key wieder, erscheint sie erneut.

Detailseite einer Node

Bei Nodes mit Healthchecks-Sync führen der Name und Details zur Detailansicht:

• Checks der Node mit Zustand, Ziel, Typ und den letzten Messungen. Je Check gibt es Jetzt prüfen und Online umhängen; mit Check auf dieser Node anlegen öffnest du das Formular mit dieser Node als Ausführungsort.
• Node: Name, Standort und Fernverwaltung ändern; dazu Status, Version, Zeitzone, Module, letzter Abgleich, offene Einträge im Postausgang, verknüpft seit und die ID.
• Vollabgleich anstoßen: Die Node gleicht ihren kompletten Stand mit IPv64.net neu ab.
• Letzte Befehle: die letzten 10 Befehle an die Node mit Ergebnis.
• Konflikte: Hat die Node offline Änderungen gemacht, die sich mit Änderungen im Portal überschneiden, zeigt die Seite die Zahl der Konflikte. Beide Versionen siehst du in der Node auf der Seite Healthchecks-Sync mit ipv64. Die Entscheidung kannst du auch von hier geben: Konflikt-Nr. (aus der Node) eintragen und Server-Version behalten oder Node-Version übernehmen (siehe Node64-Doku: Konflikte).

Healthchecks-Sync trennen

Healthchecks-Sync trennen (Token widerrufen) beendet die Verknüpfung; die Node läuft danach standalone weiter. Für ihre Checks gilt:

• Messen weitere Nodes einen Check, messen diese ihn weiter.
• Misst nur diese Node den Check und ist Checks als Online-Checks weiterführen angehakt (Standard), läuft er online bei IPv64.net weiter – sofern das Ziel öffentlich ist und dein Messstellen-Limit reicht. Docker- und Proxmox-Checks laufen nie online; sie werden mit der Node gelöscht.
• Alle anderen Checks dieser Node werden im Portal gelöscht. Reine Online-Checks bleiben in jedem Fall.

Eine getrennte Node lässt sich anschließend aus der Liste löschen; dabei werden auch ihre Zugänge, Befehle und Kanäle entfernt, die Messwerte bleiben.

Lokale und hybride Checks

Mit einer verknüpften Node stehen im Formular eines Checks zwei weitere Ausführungsorte zur Auswahl:

• Lokal auf Nodes: Nur deine Nodes messen. Geeignet für alles im Heimnetz – private IP-Adressen, .local-Namen, DNS-Server im LAN, Docker-Container. Lokal sind Intervalle ab 5 Sekunden möglich, und lokale Messungen zählen nicht gegen die Limits deiner Kontoklasse.
• Hybrid: Nodes und IPv64-Standorte messen gleichzeitig. Die Detailseite zeigt dann eine Diagnose innen und außen.
• Mehrere Nodes: Unter Messende Nodes wählst du eine oder mehrere Nodes; jede ist eine eigene Messstelle. Docker- und Proxmox-Checks gehören zu ihrer Node; weitere Nodes gibt es dafür nur über den Cluster in Node64 (Bereiche Proxmox VE und Docker, siehe Node64-Doku: Cluster).
• Jetzt prüfen gibt einen lokalen oder hybriden Check sofort an seine Nodes.
• Einen neuen lokalen Check übernimmt die Node, sobald sie verbunden ist. Ist die einzige messende Node offline, steht der Check nach drei Intervallen (mindestens 5 Minuten) auf „Nicht überwacht“.

Checks, die du in Node64 anlegst, erscheinen ebenso im Portal. Push-Checks einer Node erreichst du online über IPv64.net und im Heimnetz direkt an der Node (siehe Push-Checks).

Synchronisation

• Checks, Wartungsfenster und Benachrichtigungskanäle gleichen Portal und Nodes in beide Richtungen ab. Du kannst sie im Portal und an jeder verknüpften Node ändern.
• Messwerte, Ereignisse und Störungen der Nodes gehen an IPv64.net. Ohne Verbindung speichert die Node sie lokal und lädt sie später nach.
• Einstellungen für Ruhezeiten und Sammelmeldungen gelten für das ganze Konto (siehe Benachrichtigungen).
• Benachrichtigungen: Kanäle einer Node sendet die Node selbst; IPv64.net gibt ihr den Auftrag. Sie sind im Portal mit einem Haus-Symbol markiert.
• Wie die Node mit Verbindungsabbrüchen, Konflikten und dem Postausgang umgeht, beschreibt die Node64-Doku: Was synchronisiert wird.

Checks zwischen online und lokal umhängen

Mit Umhängen wechselt ein Check zwischen online, lokal und hybrid – einzeln auf der Detailseite, für mehrere Checks über die Massenaktion der Liste oder mit Online umhängen auf der Detailseite einer Node.

• Vor dem Wechsel läuft ein Testlauf: online von jedem gewählten Standort, lokal auf jeder gewählten Node. Erst wenn alle Messstellen OK melden, wird der neue Ausführungsort übernommen. Token und Messhistorie bleiben erhalten.
• Die Nodes müssen dafür online sein, und ihre Fernverwaltung darf nicht „aus“ sein.
• Online geht nicht für private Ziele, nicht für Docker- und Proxmox-Checks und nur, solange dein Messstellen-Limit reicht.

Alle Einzelheiten stehen unter Healthchecks: Umhängen.

Was es nur in Node64 gibt

Das Portal bleibt bewusst schlank. Diese Funktionen richtest du in Node64 ein; ihre Checks erscheinen danach auch im Portal:

• Öffentliche Statusseiten mit Tagesbalken, Ankündigungen, status.json und Badges: Node64-Doku: Statusseiten
• Proxmox VE überwachen – Nodes, VMs und Container eines Clusters, nur lesend: Node64-Doku: Proxmox VE. Im Portal stehen diese Checks in der Gruppe „Proxmox VE“ mit einer Untergruppe je System.
• Docker-Hosts überwachen – alle Container eines Hosts, auch aus der Ferne: Node64-Doku: Docker. Im Portal stehen sie in der Gruppe „Docker“ mit einer Untergruppe je Host.
• Lokale Push-URL, die auch ohne Internet funktioniert: Node64-Doku: Push / Heartbeat
• Export und Import von Checks, Prometheus-Metriken und der Cluster mehrerer Nodes, auch ohne IPv64-Konto: Node64-Doku: Healthchecks und Cluster
• Weitere Benachrichtigungskanäle wie Browser und Home Assistant: Node64-Doku: Benachrichtigungen

Die Node-Übersicht und die Nodes des Healthchecks-Sync gibt es auch per Healthchecks-API.

Fehler gefunden oder etwas fehlt? Schreibt uns im v64.tech-Forum. · Stand: 2026-10-27