Zum Inhalt springen
wavemesh
Frühe Entwicklung: Was schon geht

Erreiche deine Geräte von überall.Über deinen Server.

Ob im Büro, zu Hause oder unterwegs: wave-mesh verbindet Laptops, Server, NAS und Cluster über WireGuard direkt miteinander, auch hinter NAT und ohne Portfreigabe. Den Koordinationsserver betreibst du selbst, und er sieht nie einen privaten Schlüssel.

Mehrere Waves gleichzeitig. Ein Gerät ist zugleich im Netz der Firma, im eigenen und in dem eines Kunden, ohne umzuschalten.
*.wave.example.comwave0
relaylaptop10.77.0.2nas10.77.0.3workstation10.77.0.4grafanaDienst im Cluster

Alle Pfade direkt. Die Geräte haben sich gegenseitig durch ihre NATs gefunden.

  • Linux
  • macOS
  • Windows
  • Synology DSM 7
  • Kubernetes
  • iOSin Arbeit
  • Androidin Arbeit

Ein Binary für Linux, macOS und Windows (amd64/arm64). Für Synology DSM 7 gibt es ein SPK.

Downloads

Aktuelle Releases

Wähle eine Version und lade das Paket für dein System direkt von GitHub herunter.

In drei Schritten im Netz

Ein Wave ist ein Netz. Du startest den Server einmal und installierst dann den passenden Client auf jedem Gerät.

Zur ausführlichen Anleitung
  1. Control-Server starten

    Control-Server, Relay und Postgres per Kustomize im eigenen Kubernetes-Cluster; ein einzelner Server mit k3s genügt. Der Server vergibt Adressen, Namen und Regeln.

    $ cd deployment/server/overlays/mywave
    $ kubectl apply -k .
  2. Client installieren

    Auf Linux, macOS und Windows richtet wave install den Dienst ein. Auf Synology DSM 7 installierst du das SPK und führst das Setup einmal als root aus.

    $ sudo ./wave install
  3. Anmelden und verbinden

    Mit wave login meldest du den Client am Server an. Auf Synology geht das über die wave-Oberfläche in DSM. Danach findet das Gerät die anderen im Wave von selbst.

    $ wave login https://control.example.com
    $ wave up

Lokale Dienste im Internet: der Pier

Damit Geräte lokale Dienste im Internet erreichbar machen, brauchst du als Betreiber des Waves einen Pier-Knoten: set-pier legt den DNS-Eintrag *.pier.<domain> an, allow-pier erlaubt ihn je Gerät, und der Pier-Knoten läuft als Image wave-pier. Danach geben Geräte selbst Dienste frei.

Doku im README: „Ein Dienst im offenen Netz: der Pier“Pier im Installationsleitfaden

Was ein Wave kann

Direkt, wann immer es geht

Jedes Gerät erfährt über STUN seine öffentliche Adresse, und beide Seiten schlagen gleichzeitig ein Loch in ihr NAT. Gelingt das nicht, etwa bei symmetrischem NAT im Mobilfunk, läuft der Verkehr über ein Relay. Wird der direkte Weg frei, wechselt die Verbindung, ohne abzureißen.

Abgesichert durch Ende-zu-Ende-Tests mit echten NATs, die in jeder CI laufen.

wave status
wave0  10.77.0.2
name  laptop.wave.example.com
dns   *.wave.example.com
relay connected wss://relay.example.com

PEER         ADDRESS    PATH                                HANDSHAKE
nas          10.77.0.3  direct 192.168.1.20:41641 3ms       12s ago
workstation  10.77.0.4  via relay 61ms                      8s ago
cluster      10.77.0.9  direct 203.0.113.7:41641 18ms       31s ago
  ↳ https://grafana.wave.example.com  10.77.128.1

Mehrere Waves gleichzeitig

Ein Gerät ist in so vielen Waves, wie du brauchst, und zwar alle zugleich: im Wave der Firma, im eigenen zu Hause und in dem eines Kunden, auch an verschiedenen Control-Servern. Umschalten zwischen Netzen gibt es nicht. Jeder Wave bleibt für sich, mit eigenen Schlüsseln, eigenen Adressen und eigenen Namen, und einer kann nicht in den anderen sehen.

Überschneiden sich die Adressen zweier Waves, verweigert der Client den zweiten, statt still eine Route zu überschreiben. In den Apps für iPhone und Android (in Arbeit) trägt ein einziger Tunnel alle Waves, und jeder lässt sich einzeln pausieren.

wave status
control.example.com https://control.example.com
wave0  10.64.0.12
name  laptop.corp.example.com
dns   *.corp.example.com

PEER     ADDRESS    PATH                                HANDSHAKE
gitlab   10.64.0.3  direct 198.51.100.4:41641 9ms       5s ago
staging  10.64.0.8  direct 198.51.100.9:41641 11ms      40s ago

────────────────────────────────────────────────

wave.example.net https://wave.example.net
wave1  10.80.0.5
name  laptop.home.example.net
dns   *.home.example.net

PEER     ADDRESS    PATH                                HANDSHAKE
nas      10.80.0.3  direct 192.168.1.20:41641 2ms       12s ago

Namen unter deiner Domain

Trägt ein Wave ein DNS-Suffix, das dir gehört, heißen deine Geräte laptop.wave.example.com statt 10.77.0.5. Ein lokaler Resolver beantwortet nur die Namen des Waves, alles andere geht unverändert an dein normales DNS.

  • laptop.wave.example.comverbunden
  • nas.wave.example.comverbunden
  • workstation.wave.example.comverbunden
  • build-runner.wave.example.comvor 3 Std.
$ ssh nas.wave.example.com

Echte Zertifikate für jedes Gerät

Jedes Gerät bekommt ein Let's-Encrypt-Zertifikat auf seinen Namen. Der private Schlüssel entsteht auf dem Gerät und verlässt es nie. Erneuert wird unbeaufsichtigt, über Cloudflare, Hetzner, IONOS oder INWX. Ohne Zugangsdaten geht es auch, dann legst du den TXT-Record selbst an.

wave cert
$ wave cert

This wave answers dns-01 by hand, so laptop.wave.example.com needs a record first:

  name   _acme-challenge.laptop.wave.example.com
  type   TXT
  value  0Zq8…

Waiting... Ctrl-C is safe: `wave cert` takes the same order up again.

Zugriff als Graph

Mitglieder, Gruppen, Tags und Dienste stehen als Karten nebeneinander. Eine Regel ist ein Pfeil, die Ports hängen an der Kante. Die Seite zeigt, wer danach wen erreicht, bevor du speicherst.

Cluster und Wave in beide Richtungen

Ein gewöhnlicher Ingress mit der Klasse wave macht einen internen Dienst im Wave erreichbar und sonst nirgends. Umgekehrt erreichen Pods Geräte und Dienste des Waves über deren Namen, per HTTP und HTTPS mit TLS Ende zu Ende. Der Connector im Cluster hat keinen eingehenden Port.

Updates, signiert

Der Dienst installiert neue Versionen selbst, aber nur mit gültiger Ed25519-Signatur. Erreicht die neue Fassung keinen Server, geht er von allein zurück.

Lokale Dienste im Internet

Ein Dienst auf localhost oder im LAN wird mit wave expose app http://localhost:3000 unter app.pier.wave.example.com aus dem Internet erreichbar. Der Name löst über das Wildcard *.pier.<domain> auf den Pier-Knoten auf, ein Ingress reicht TCP 443 per SNI durch, und der Pier-Knoten liest nur den Namen. TLS endet auf deinem Gerät mit dessen eigenem Zertifikat. Keine Portfreigabe, keine feste Adresse. wave expose --list zeigt deine Namen, wave expose --remove app nimmt einen heraus, wave pier status sagt, ob der Proxy läuft. Nicht geprüft: der Pier an einem echten Ingress und das Image wave-pier.

Was der Server weiß, und was nicht

wave-mesh trennt die Ebenen strikt. Der Control-Server verteilt nur öffentliche Schlüssel, das Relay reicht nur Chiffrat weiter, und der Pier-Knoten liest nur einen Namen aus dem Verbindungsaufbau. Den Verkehr zwischen deinen Geräten kann keiner von ihnen entschlüsseln.

EbeneKennt private Schlüssel
Control-Servernein
Relaynein
Pier-Knotennein
Gerätnur den eigenen

Signierte Netzkarte

Der Control-Server signiert die Netzkarte mit seinem Ed25519-Schlüssel, und Geräte übernehmen nur, was dazu passt.

Authentifizierte Discovery

Auch die Pakete, mit denen sich Geräte finden, sind verschlüsselt: X25519 und XChaCha20-Poly1305.

Anmeldung, die du kontrollierst

E-Mail und Passwort mit Argon2id und auf Wunsch einem zweiten Faktor per Authenticator-App, oder dein OpenID-Connect-Anbieter wie Pocket ID, Keycloak oder Google. Konten legt der Betreiber an, eine offene Registrierung gibt es nicht.

Kein Klartext am Pier

Der Pier-Knoten liest nur den Namen aus dem Verbindungsaufbau und reicht die Verbindung durch den Wave an das Gerät weiter. Die Verschlüsselung endet auf dem Gerät, mit dessen eigenem Zertifikat. Der Pier hält keinen Schlüssel.

Zwei Schlösser am Pier

Der Betreiber erlaubt den Pier je Gerät, Vorgabe ist aus. Erst danach kann der Besitzer des Geräts einen Namen und einen Port freigeben. Nimmt der Betreiber die Erlaubnis zurück, gehen die Namen des Geräts mit.

Zertifikate nur für eigene Namen

Ein Gerät bekommt ein Zertifikat für die Namen, die es selbst freigegeben hat: nicht für den ganzen Wave, nicht für Namen anderer Geräte, und nur solange der Betreiber den Pier erlaubt. Ein schon ausgestelltes Zertifikat läuft bis zu seinem Ablauf weiter.

Was es kostet

wave-mesh steht unter der Elastic License 2.0. Selbst betreiben ist und bleibt kostenlos.

Selbst betreiben

0 €ohne Gerätelimit

Alle Funktionen, auf deiner eigenen Infrastruktur. Nutzen, ändern und im eigenen Unternehmen einsetzen ist erlaubt.

  • Control-Server und Relay
  • Clients für alle Plattformen
  • Updates über deinen Server

Gehostet gratis

0 €pro Kundenkonto

Wir betreiben Control-Server und Relays für dich, du verbindest nur noch Geräte. Die Limits gelten für dein ganzes Kundenkonto, über alle Waves zusammen.

  • Bis zu 3 Personen
  • Bis zu 100 verschiedene Geräte
  • Control-Server und Relays von uns

So zählen wir

  • Dieselbe Person oder dasselbe Gerät in mehreren Waves zählt einmal.
  • Offene Einladungen reservieren Plätze.
  • Bestandskunden behalten ihre Waves.

Die Netze der Waves bleiben getrennt, nur die Limits zählen kontoweit.

Mehr Personen oder Geräte? Dafür gibt es „Gehostet bezahlt“.

Gehostet bezahlt

4 €pro Nutzer und Monat

Wir betreiben Control-Server und Relays für dich, du verbindest nur noch Geräte. Jährlich zahlst du 40 € statt 48 € pro Nutzer. Die Zahl der Nutzer wählst du beim Buchen und änderst sie jederzeit.

  • Control-Server und Relays von uns
  • Updates und Backups inklusive
  • Eigene Domain für deine Geräte
Abo verwalten

Installation in deiner Cloud

4.650 €einmalig

Wir installieren wave-mesh in der Cloud deines Unternehmens. Danach übernehmen wir auf Wunsch mit einem Wartungspaket Updates und Betrieb.

  • Control-Server und Relays in deiner Cloud
  • Anbindung deiner Cluster und Geräte
  • Optional: Wartungspaket für Updates und Betrieb

Angebote für Unternehmen. Alle Preise zzgl. gesetzlicher MwSt., es gelten unsere AGB. Nicht erlaubt ist nur, wave-mesh Dritten als gehosteten oder verwalteten Dienst anzubieten.

Roadmap

Alles unter „Verfügbar“ steckt in den stabilen Releases. „Als Nächstes“ ist in Arbeit oder geplant; was neu dazukommt, steht im Changelog.

Changelog lesen

Verfügbar

  • Direkte Verbindung durch NAT
  • Relay, wenn Punching scheitert
  • Namen unter eigener Domain
  • Let's-Encrypt-Zertifikate
  • Dienste aus dem Kubernetes-Cluster
  • Aus dem Cluster in den Wave
  • Anmeldung per OpenID Connect und zweitem Faktor
  • Zugriffsregeln und Audit-Log
  • Signierte Selbstaktualisierung
  • Signierte und notarisierte macOS-Clients
  • Dienste aus dem Wave im offenen NetzPier und wave expose; am echten Ingress im Internet noch nicht geprüft

Als Nächstes

  • Apps für iOS und AndroidKern fertig, Apps in Arbeit
  • Subnetz-Router und Exit-Nodes

Häufige Fragen

Was ist anders als bei einem gehosteten Mesh-VPN?

Der Koordinationsserver gehört dir: Er läuft auf deiner Infrastruktur, nicht bei einem Anbieter. Deine Geräte tragen Namen unter deiner eigenen Domain, und jedes bekommt ein öffentlich gültiges Zertifikat.

Wie schnell ist es?

Der Datenpfad läuft heute im Userspace. Realistisch sind 100 bis 300 Mbit/s je Gerät. Ein schnellerer Pfad über Kernel-WireGuard ist geplant, aber noch nicht gebaut.

Brauche ich eine eigene Domain?

Nein. Ohne Domain heißen deine Geräte unter .internal und sind trotzdem per Namen erreichbar. Öffentlich gültige Zertifikate gibt es nur mit einer Domain, die dir gehört.

Was darf ich mit der Lizenz?

Nutzen, verändern und weitergeben, auch im eigenen Unternehmen. Nicht erlaubt ist, wave-mesh Dritten als gehosteten oder verwalteten Dienst anzubieten.

Was brauche ich auf dem Server?

Einen Kubernetes-Cluster; ein einzelner Server mit k3s genügt. Control-Server, Relay und Postgres kommen als fertige Images und werden per Kustomize eingerichtet. Nach außen braucht es HTTPS und UDP 3478 für STUN.

Brauche ich eine Portfreigabe, um einen Dienst ins Internet zu stellen?

Nein, und auch keine feste Adresse. wave expose macht einen Dienst deines Geräts unter einem Namen wie app.pier.wave.example.com erreichbar, ohne eingehenden Port. Dafür muss der Betreiber des Waves einen Pier-Knoten betreiben und ihn für dein Gerät erlauben.

Sieht der Pier meinen Verkehr?

Nein. Der Pier-Knoten liest nur den Namen aus dem Verbindungsaufbau und reicht die Verbindung weiter. Die Verschlüsselung endet auf deinem Gerät, mit dessen eigenem Zertifikat. Der Pier hält keinen Schlüssel und sieht keinen Klartext.

Wie liste ich freigegebene Namen auf und nehme sie wieder heraus?

wave expose --list zeigt die Namen und wie es um jeden steht, wave expose --remove app nimmt einen heraus. wave pier status sagt dir, warum ein Name noch nicht geht, etwa weil ein Zertifikat fehlt, der Tunnel unten ist oder das Gerät offline ist.

Was bietet „Gehostet gratis“?

Wir betreiben Control-Server und Relays für dich. Pro Kundenkonto sind bis zu 3 Personen und 100 verschiedene Geräte inklusive, über alle Waves des Kontos zusammen. Mehr gibt es im bezahlten Tarif, der pro Nutzer abgerechnet wird.

Wie zählt der Gratis-Tarif Personen und Geräte?

Dieselbe Person oder dasselbe Gerät in mehreren Waves zählt einmal. Die Limits gelten für das ganze Kundenkonto, nicht für einen einzelnen Wave. Die Netze der Waves bleiben getrennt, nur die Limits zählen kontoweit.

Zählen offene Einladungen schon mit?

Offene Einladungen reservieren Plätze. Eine Einladung belegt also einen der Plätze, bevor die Person sie angenommen hat.

Was ändert sich für Bestandskunden?

Bestandskunden behalten ihre Waves. Der bezahlte Tarif rechnet weiter pro Nutzer ab.

Bring deine Geräte zusammen.

Ein Server, der passende Client auf jedem Gerät, und alles spricht direkt miteinander.