Node64-Dokumentation

Hier findest du alles, was du für Node64 brauchst: von der Installation über die vier Module bis zur API. Jede Seite ist für Einsteiger geschrieben und enthält trotzdem alle Optionen und Standardwerte.

Node64 ist ein schlanker Docker-Container für dein Heimnetz: Healthchecks, ein DynDNS-Updater für ipv64.net, DNS64 als DNS-Filter mit Blocklisten, PROXY64 als Reverse Proxy und Honeypot64 mit der Community-Blockliste. Alles steckt in einem einzigen Go-Binary mit SQLite – ohne Datenbank-Server und ohne Abhängigkeiten zur Laufzeit. Node64 läuft komplett eigenständig. Die Verknüpfung mit deinem ipv64.net-Account ist optional.

Schnellstart in 60 Sekunden

  1. Container starten. Ein Befehl genügt, die Daten landen im Volume node64-data:
    bash 
    docker run -d --name node64 \
  -p 8080:8080 \
  -v node64-data:/data \
  --restart unless-stopped \
  ghcr.io/ipv64net/node64:latest
  2. Oberfläche öffnen. Im Browser http://<host>:8080 aufrufen – <host> ist die IP-Adresse oder der Name des Rechners, auf dem Docker läuft.
  3. Einrichten. Der Assistent fragt Sprache und Admin-Konto ab. Es gibt kein Standardpasswort. Danach schaltest du unter Einstellungen → Module ein, was du brauchst.
Image erscheint in Kürze

Das Image ghcr.io/ipv64net/node64:latest wird gerade für die Veröffentlichung vorbereitet. Die Befehle auf diesen Seiten funktionieren, sobald es öffentlich ist.

Mehr Varianten (docker compose, Host-Netz, Docker-Socket) findest du unter Installation, den Rundgang nach dem ersten Start unter Erste Schritte.

Systemvoraussetzungen

  • Docker auf Linux, optional mit Docker Compose.
  • Architektur: linux/amd64, linux/arm64 oder linux/arm/v7 – also PC, Server, VM, NAS oder Raspberry Pi.
  • Ein Volume für /data – das einzige Verzeichnis, in das Node64 schreibt.
  • Port 8080 frei für die Oberfläche (HTTP und HTTPS auf demselben Port).
  • Kein Account nötig. Ein ipv64.net-Account schaltet zusätzliche Online-Funktionen frei.

Alle Bereiche

Einstieg

Installation

docker run und docker compose, Plattformen, Ports, Rechte und das Volume /data.

Erste Schritte

Setup-Assistent, Dashboard, Module einschalten, erster Check und erste Benachrichtigung.

Konfiguration

Alle NODE64_*-Variablen, Netzwerkmodi, Reverse Proxy davor, Logs und Darstellung.

Update & Backup

Aktualisieren, vollständiges Backup, Wiederherstellen, Export/Import und Zurücksetzen.

Module

Healthchecks

Elf Check-Typen, Wartungsfenster, Docker-Checks und Prüfung von außen über ipv64.net.

Proxmox VE

Nodes, VMs und Container nur lesend überwachen – Abstürze, Neustarts, CPU, RAM und Disk.

Docker

Alle Container lokal und auf entfernten Hosts – per SSH, TLS oder Socket-Proxy, mit Verlauf und Regeln.

Benachrichtigungen

E-Mail, Telegram, Discord, Slack, Microsoft Teams, Matrix, ntfy, Gotify, Pushover, Home Assistant, Webhook – mit Schutz vor Alarmrauschen.

PROXY64 Reverse-Proxy

Proxy-Hosts, Weiterleitungen, TLS durchreichen, TCP/UDP-Streams und Zugriffslisten.

CDN64

Dienste per Tunnel ohne Portfreigabe veröffentlichen – auch an DS-Lite-Anschlüssen.

Zertifikate

Let's Encrypt per HTTP- oder DNS-Challenge, eigene CA und Uploads zentral verwalten.

DNS64

DNS-Filter mit Blocklisten, Freigaben, eigenen Einträgen und DoH/DoT/DoQ.

DynDNS64

ipv64.net-Domains automatisch auf IPv4 und IPv6 aktuell halten.

Honeypot64 Vorschau

Fallen-Dienste für SSH, Telnet, Web, Mail, FTP und TCP – sehen, wer anklopft. Auch als reiner Sensor.

System & Sicherheit

Souveränität & Datenflüsse

Alle Verbindungen nach außen – und warum das Zusammenspiel mit ipv64.net in Deutschland bleibt.

Anmeldung & Sicherheit

Zwei-Faktor, Passkeys, SSO über OpenID Connect, Forward-Auth und Audit-Log.

ipv64.net verknüpfen

API-Key und Healthchecks-Sync: was du online dazubekommst – und was ohne Account geht.

Cluster

Mehrere Nodes gleichen Checks, Zertifikate und mehr direkt untereinander ab – auch ohne ipv64-Account.

Schnittstellen

Lokale API

Alles, was die Oberfläche kann, als JSON-API mit API-Keys und OpenAPI 3.1.

Prometheus

Metriken aller Module unter /api/metrics, mit Beispiel-Alarmregeln.

KI-Schnittstelle (MCP)

Claude Code, Cursor und VS Code lesen den Zustand der Node – nur lesen, nur aus dem Heimnetz.

Hilfe

FAQ & Fehlerbehebung

Belegte Ports, ICMP ohne Root, Docker-Socket, Logs und häufige Fragen.

Offizielles Forum v64.tech

Fragen zu Node64 stellen, Lösungen finden und dich mit der Community austauschen.

ipv64.net-Wiki

Alles rund um deinen ipv64.net-Account, DynDNS und die Online-Dienste.

Weiter →Installation

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

Fragen zu Node64?
Für alle Fragen zum Produkt gibt es das offizielle Forum: Einrichtung, Fehlersuche, Ideen und Austausch mit der Community und dem ipv64.net-Team.
Zum Forum v64.tech