Mit ipv64.net verknüpfen

Node64 läuft komplett ohne Account. Verbindest du ihn mit deinem ipv64.net-Account, kommen die Außensicht und die Online-Dienste dazu: Prüfung deiner Dienste aus dem Internet, das ipv64-Portal, DynDNS, Zertifikate für deine ipv64-Domains und CDN64 – ohne einen einzigen offenen Port.

Was die Verknüpfung bringt

Ein ipv64.net-Account ist kostenlos. Welche Grenzen in welcher Klasse gelten, steht auf der Preisseite von ipv64.net.

Zwei Stufen: API-Key und Healthchecks-Sync

Die Verbindung zu ipv64.net hat zwei Teile, die sich ergänzen. Du kannst beide nutzen oder nur den API-Key.

API-Key holen und eintragen

1. Melde dich bei ipv64.net an und lege in deinem Account unter den API-Einstellungen einen API-Key an.
2. Öffne in Node64 Einstellungen → ipv64-API-Key, füge den Key ein und klicke auf Speichern und prüfen.
3. Node64 prüft den Key bei ipv64 und zeigt danach Verbunden als …, den Namen des Keys und sein Ablaufdatum an.

• Es gibt einen Key für den ganzen Container – alle Module nutzen ihn. Er liegt verschlüsselt in der Datenbank und wird nie wieder angezeigt.
• Mit gesetztem Key meldet sich die Node in der Node-Übersicht auf ipv64.net an.
• Läuft der Key bald ab, warnt dich Node64. Lege dann bei ipv64 rechtzeitig einen neuen an und trage ihn hier ein.
• Entfernst du den Key, funktionieren die Funktionen nicht mehr, die ihn brauchen (etwa die Auswahl im DynDNS-Updater). Bereits eingerichtete DynDNS-Ziele aktualisieren trotzdem weiter.
• Per API geht das mit PUT /api/ipv64/key (Feld key) und DELETE /api/ipv64/key.

Healthchecks-Sync einrichten

Der Healthchecks-Sync verbindet das Modul Healthchecks dauerhaft mit ipv64.net. Öffne dazu die Seite Healthchecks-Sync mit ipv64.

Mit einem Klick (API-Key hinterlegt)

Ist ein ipv64-API-Key eingetragen, klickst du auf Mit … verknüpfen und wählst optional einen Standort. Der Key wird nur zum Einlösen benutzt – die Node bekommt ihren eigenen Zugang, den du bei ipv64 einzeln widerrufen kannst.

Per Code

1. Klicke auf Mit ipv64.net verknüpfen. Die Node zeigt einen Code an, der 10 Minuten gilt.
2. Melde dich bei ipv64.net an und gib den Code ein. Wähle dort Standort und Fernverwaltung.
3. Die Seite in Node64 verbindet sich danach automatisch.

Danach wählst du je Check, wo gemessen wird: lokal auf deinen Nodes, nur online bei ipv64 oder beides (Hybrid). Online und Hybrid gehen nicht für Docker-Checks und nicht für Ziele im Heimnetz wie private IP-Adressen, localhost oder .local-Namen. Mehr dazu unter Healthchecks.

Was synchronisiert wird

Mit ipv64 verknüpft bilden alle Nodes eines Accounts ein System: Jede Node darf jeden Check ändern, und über das Feld nodes legst du fest, welche Nodes ihn messen. Ändern zwei Stellen dasselbe gleichzeitig, gewinnt die jüngere Änderung. Entstehen Überschneidungen, während keine Verbindung besteht, zeigt Node64 sie als Konflikt an – du entscheidest, welche Version gilt.

Konflikte auflösen

Ein Konflikt entsteht auch, wenn ipv64 eine Änderung der Node ablehnt – etwa weil das Online-Limit der Account-Klasse erreicht ist, der Check einer anderen Node gehört oder die Node nicht verbunden ist. Auf der Seite Healthchecks-Sync mit ipv64 (/link) nennt die Karte dann den Grund („ipv64 hat die Änderung abgelehnt: …“) und zeigt beide Fassungen: die der Node und den aktuellen Stand bei ipv64. Nichts wird stillschweigend überschrieben.

• Ältere Konflikte ohne gespeicherten Grund werden nie gelöscht; Erneut senden holt Grund und ipv64-Stand nach.
• Lokale API: GET /api/link/conflicts liefert die Konflikte samt error (Grund), POST /api/link/conflicts/{id} löst einen auf mit keep=server (ipv64-Stand), keep=local (erneut senden) oder keep=ignore (nur hier behalten). Offene Konflikte zählt die Metrik node64_link_conflicts.

DynDNS, Zertifikate und CDN64 laufen nicht über den Sync, sondern direkt über den API-Key. DNS64 braucht ipv64 gar nicht.

Wer verbindet sich wohin

Alle Verbindungen gehen von der Node nach außen. Du musst für die Verknüpfung keinen Port am Router öffnen.

  # Dein Heimnetz                          # Internet
 ┌─────────────────────────┐
 │         Node64          │  WebSocket, HTTPS 443  ┌────────────────────────┐
 │  Healthchecks-Sync ─────┼───────────────────────►│ ipv64.net              │
 │                         │                        │ 2 Server in Nürnberg   │
 │                         │  ipv64 API v2, HTTPS   │ und Falkenstein        │
 │  DynDNS, Zertifikate, ──┼───────────────────────►│ API v2, DynDNS-Update  │
 │  PROXY64, /plans        │                        │ Online-Checks, Portal  │
 │                         │                        ├────────────────────────┤
 │  CDN64 ─────────────────┼───────────────────────►│ 2 Edge-Server in DE    │
 │                         │  Tunnel UDP/TCP        │ (CDN64)                │
 └─────────────────────────┘  7844 oder 443         └────────────────────────┘
   kein offener Port nötig – die Verbindungen zu ipv64 baut die Node auf

• Healthchecks-Sync: eine dauerhafte WebSocket-Verbindung über HTTPS (Port 443) zu einem der zwei gleichwertigen ipv64-Server in Nürnberg und Falkenstein.
• API-Key: einzelne HTTPS-Anfragen an ipv64.net, wenn ein Modul sie braucht – etwa für die Auswahl der DynDNS-Namen, Zertifikate per DNS-01 oder die Account-Klasse (die eigene alle 2 Minuten, die Grenzen aller Klassen stündlich) – dazu die Anmeldung in der Node-Übersicht alle 15 Minuten.
• DynDNS-Updates: HTTPS-Aufrufe bei ipv64.net mit dem Record- oder Domain-Token, nur wenn sich deine IP geändert hat.
• CDN64: ein Tunnel zu zwei ipv64-Edge-Servern in Deutschland (Nürnberg und Falkenstein), über UDP oder TCP auf Port 7844 oder 443. Details unter CDN64.
• Online-Checks: Sie prüfen von außen nur die Ziele, die du dafür einträgst – also Dienste, die ohnehin öffentlich erreichbar sind. Ziele im Heimnetz lassen sich gar nicht online prüfen.
• Blocklisten und Versionsprüfung: PROXY64 lädt die ipv64-Blocklisten ohne Anmeldung; die tägliche Versionsprüfung läuft nur, wenn du sie einschaltest.

Ausfallverhalten

Node64 ist so gebaut, dass dein Heimnetz weiterläuft, wenn das Internet oder ipv64 weg ist.

Account-Klassen

Die Grenzen deiner ipv64-Account-Klasse gelten für alles, was über ipv64 läuft – zum Beispiel Online-Checks, DynDNS-Updates, SMS und CDN. Lokale Messungen und Dienste der Node zählen nicht dagegen: Healthchecks im Heimnetz, DNS64 und der lokale Reverse-Proxy haben kein Limit.

• Die Seite /plans in der Node (Account-Klassen) zeigt, welche Klasse du hast und was die Klassen umfassen – nach Bereichen gruppiert und mit Einheiten (GB/TB, Mbit/s, Sekunden, Tage), darunter CDN-Domains, CDN-Traffic und CDN-Bandbreite. „–“ heißt: nicht enthalten.
• Die Werte holt die Node stündlich von ipv64. Fehlt ein Wert oder gibt es keine Verbindung, nimmt sie den eingebauten Stand.
• Deine eigene Klasse prüft die Node alle 2 Minuten. Nach einem Upgrade stimmen Seitenleiste, Tarife und Account-Übersicht also nach wenigen Minuten, und die Healthchecks-Limits werden sofort nachgeladen.
• Wechsel und Bezahlung laufen bei ipv64.net. Die aktuelle Übersicht findest du auf der Preisseite.

Node-Übersicht auf ipv64.net

Mit gesetztem API-Key meldet sich die Node bei ipv64.net an. Auf ipv64.net/nodes.php siehst du dann alle deine Node64-Container in einer Liste – mit Healthchecks-Server, Honeypot, CDN64 und Modulen – und kannst sie dort verknüpfen, entfernen oder wieder zulassen.

• Wann: beim Start (nach 20 Sekunden), bei Änderungen (geprüft jede Minute) und sonst alle 15 Minuten, per POST /node64/hello. Jede API-Anfrage trägt außerdem den Header X-Node64-Node mit der Kennung der Node (im Modus ohne Oberfläche die Sensor-Kennung).
• Was: Name, Standort, Version, Plattform, Modus, eingeschaltete Module und einige Merkmale – ob der Healthchecks-Sync verknüpft ist, Kennungen von Healthchecks-Node und Honeypot-Sensor, ob ein CDN64-Tunnel oder DynDNS läuft. Keine Geheimnisse, keine Messwerte.
• Entfernt du die Node auf ipv64.net, antwortet der Server ihr mit 403 node_removed. Die Node löscht dann den API-Key, trennt den Healthchecks-Sync lokal – die lokalen Daten bleiben – und zeigt einen roten Hinweis auf dem Dashboard und in den Einstellungen. Ein neuer API-Key hebt das auf.
• Per API v2 liefert GET /node64/nodes dieselbe Liste.

Verknüpfung trennen

Du kannst den Healthchecks-Sync jederzeit trennen. Die Node läuft danach standalone weiter. Beim Trennen entscheidest du, ob die Checks, die nur diese Node misst, bei ipv64 als Online-Checks weiterlaufen sollen (soweit dein Limit reicht) oder dort gelöscht werden. Checks anderer Nodes und reine Online-Checks im Account bleiben in jedem Fall bei ipv64 bestehen.

Datenschutz

• Ohne API-Key und Verknüpfung bleiben deine Daten in deinem Netz. Node64 sendet keine Telemetrie.
• Mit API-Key meldet sich die Node für die Node-Übersicht an: Name, Standort, Version, Module und einige Merkmale – keine Geheimnisse, keine Messwerte.
• Nach der Verknüpfung des Healthchecks-Sync werden die Konfiguration der Checks und ihre Messergebnisse an ipv64.net übertragen – auch Ziele im Heimnetz, die nur lokal gemessen werden. Darauf weist die Oberfläche vor dem Verknüpfen hin.
• Der ipv64-API-Key und alle anderen Geheimnisse liegen verschlüsselt in der Node (siehe Anmeldung & Sicherheit).
• Die ipv64-Server stehen in Deutschland (Nürnberg und Falkenstein).
• Wie ipv64.net mit deinen Daten umgeht, steht in der Datenschutzerklärung von ipv64.net.

Etwas unklar, fehlt etwas oder hast du eine Frage zu Node64? Frag im offiziellen Forum v64.tech.