Kivuko-Symbol

Kivuko

Ein NordVPN-Client für die Mac-Menüleiste, geschrieben in Rust und auf Basis von WireGuard.

Kivuko (ki-WU-ko) ist Swahili und bedeutet „Überfahrt“ oder „Fähre“.

Aus dem Quellcode bauenApple Chip · macOS 14 oder neuer Quellcode auf GitHubgithub.com/piedol/kivuko

Kivuko ist ein unabhängiges Projekt. Es wird von Nord Security weder entwickelt noch empfohlen oder unterstützt. Sie benötigen Ihr eigenes NordVPN-Abo.

Kivukos Menü bei bestehender Verbindung: Disconnect, Location auf United States sowie Kill Switch, Auto-Connect und Block Ads and Trackers aktiviert

Kill Switch, automatisches Neuverbinden und Werbeblocker

Kivuko ist ein kostenloser Open-Source-NordVPN-Client für macOS, der sich über WireGuard (NordLynx) verbindet.

Den Kill Switch von Kivuko setzt macOS durch. Kivuko verbindet sich nach dem Ruhezustand und bei Netzwerkwechseln neu und kann Werbung und Tracker über das DNS von NordVPN blockieren. Die Menüleisten-App belegt etwa 23 MB Arbeitsspeicher, der Tunnel etwa 8 MB.

Der Tunnel nutzt GotaTun, Mullvads Rust-Implementierung von WireGuard, in einer Packet-Tunnel-Erweiterung von macOS. macOS startet diese Erweiterung und startet sie neu, etwa nach dem Ruhezustand.

Wenn ein Server nicht mehr antwortet

Kivuko prüft alle 15 Sekunden den WireGuard-Handshake.

  1. 8 sNächsten Server versuchenAntwortet ein Server nicht innerhalb von 8 Sekunden, versucht Kivuko den nächsten Server, bis zu drei.
  2. 3 Min.Handshake erzwingenKommt 3 Minuten lang kein WireGuard-Handshake an, erzwingt Kivuko einen neuen Handshake.
  3. 6 Min.Auf einem neuen Server neu startenNach 6 Minuten startet macOS den Tunnel auf einem neuen Server neu (bei aktiviertem Auto-Connect).

So funktioniert es

Kivuko.app                     app/       menu bar app: menu, token prompt, VPN configuration
└── Contents/PlugIns/
    └── KivukoTunnel.appex     provider/  packet-tunnel extension: server choice, GotaTun, watchdog
  • Die Menüleisten-App verwaltet die VPN-Konfiguration, die macOS unter Systemeinstellungen › VPN speichert, einschließlich Kill Switch, On-Demand-Regel und DNS-Auswahl.
  • Der Tunnel ist ein NetworkExtension-Packet-Tunnel-Provider. macOS startet ihn bei jedem Start des VPN, auch bei automatischen Neuverbindungen, während die App nicht läuft.
  • Bei jedem Start fragt der Tunnel NordVPN nach empfohlenen WireGuard-Servern, übergibt macOS die Adressen, Routen und DNS-Einstellungen und führt GotaTun auf der Tunnel-Schnittstelle aus, die macOS erstellt.
  • docs/architecture.md erklärt die Designentscheidungen, den Verbindungsablauf und den Watchdog.

Datenschutz und Sicherheit

Kivuko kommuniziert nur mit der API von NordVPN und dem VPN-Server, mit dem Sie verbunden sind, und sendet keine Analysedaten.

  • Ihr NordVPN-Zugriffstoken wird in Ihrem Anmeldeschlüsselbund gespeichert. Wenn Sie auf Connect klicken, übergibt die App es an den Tunnel, der damit Ihren WireGuard-Schlüssel von NordVPN abruft.
  • Der Tunnel bewahrt den WireGuard-Schlüssel in seinem eigenen Sandbox-Container auf, lesbar nur für Ihren Benutzer (Modus 0600).
  • Jeder Benutzer des Mac kann die VPN-Konfiguration von macOS lesen, daher speichert Kivuko dort nur Ihr Land und Ihre DNS-Auswahl.
  • Die Protokolle zeichnen Ereignisse auf, nie das Token oder den Schlüssel. docs/setup.md listet jede Datei auf, die Kivuko schreibt.

Ressourcenverbrauch

Gemessen auf einem MacBook Pro mit macOS 26.

SpeicherCPU
Menüleisten-App23 MB0 % im Leerlauf
Tunnel8 MBUnter 1 % bei Hintergrundverkehr; etwa 26 % eines Kerns beim Download mit 212 Mbit/s

Kivuko installieren

Es gibt keinen fertigen Download. macOS lädt VPN-Erweiterungen nur, wenn sie über eine kostenpflichtige Mitgliedschaft im Apple Developer Program signiert sind, deshalb bauen und signieren Sie Kivuko selbst. Die vollständige Anleitung ist docs/setup.md.

Voraussetzungen

Mac
Apple Chip
macOS
14 oder neuer (bisher nur unter macOS 26 getestet)
VPN-Dienst
Ihr eigenes NordVPN-Abo
Signierung
Eine kostenpflichtige Mitgliedschaft im Apple Developer Program

Zum Bauen

Xcode
Mit diesem Account angemeldet
XcodeGen
github.com/yonaskolb/XcodeGen
Rust
1.95 oder neuer

  1. Klonen Sie das Repository und wählen Sie ein eigenes Präfix für die Bundle-ID, etwa com.yourname:

    git clone https://github.com/piedol/kivuko.git
    cd kivuko && cp signing/local.env.example signing/local.env

    Setzen Sie KIVUKO_BUNDLE_PREFIX in signing/local.env und KIVUKO_TEAM, falls Ihre Apple-ID zu mehreren Entwicklerteams gehört. scripts/bundle.sh --check zeigt, was signiert wird.

  2. Bauen, signieren und installieren. Beim ersten Durchlauf registriert Xcode Ihren Mac und die beiden Bundle-IDs und lädt Entwicklungsprofile herunter:

    scripts/bundle.sh --install

  3. Holen Sie sich ein NordVPN-Zugriffstoken unter Nord Account › NordVPN › Advanced settings › Access token.

  4. Klicken Sie auf das Schild in der Menüleiste und wählen Sie Set Up and Connect. Setzen Sie das Token ein, klicken Sie auf Save and Connect und dann auf Erlauben, wenn macOS fragt, ob eine VPN-Konfiguration hinzugefügt werden soll.

Entwicklungsprofile gelten ein Jahr. Wenn sie ablaufen, lädt macOS Kivuko nicht mehr, und ein erneuter Aufruf von scripts/bundle.sh --install erneuert sie. Behalten Sie keine zweite Kopie von Kivuko auf Ihrem Mac. Wenn zwei Kopien der Tunnel-Erweiterung registriert sind, stoppt macOS beim Öffnen einer der beiden Apps den Tunnel der anderen, wodurch das VPN getrennt wird.

Zum Deinstallieren folgen Sie den Schritten unter Deinstallation in der angegebenen Reihenfolge. Wenn Sie zuerst die App löschen, kann der Kill Switch Ihre Verbindung blockieren, bis Sie die VPN-Konfiguration entfernen.

Häufige Fragen

Ist Kivuko kostenlos und Open Source?

Ja. Kivuko ist kostenlos herunterzuladen und zu nutzen, und der Quellcode steht auf GitHub unter der GNU General Public License v3.0 oder später.

Brauche ich ein NordVPN-Abo?

Ja. Kivuko verbindet sich mit Ihrem eigenen Abo mit NordVPN und verwendet dazu ein Zugriffstoken aus Nord Account › NordVPN › Advanced settings.

Ist Kivuko mit Nord Security verbunden?

Nein. Kivuko ist ein unabhängiges Projekt. Es wird von Nord Security weder entwickelt noch empfohlen oder unterstützt.

Wie installiere ich Kivuko?

Bauen Sie es aus dem Quellcode auf einem Mac mit Apple Chip und macOS 14 oder neuer. macOS lädt VPN-Erweiterungen nur, wenn sie über eine kostenpflichtige Mitgliedschaft im Apple Developer Program signiert sind, deshalb gibt es keinen fertigen Download. docs/setup.md beschreibt die Schritte.

Was sendet Kivuko über das Netzwerk?

Es kommuniziert nur mit der API von NordVPN und dem VPN-Server, mit dem Sie verbunden sind, und sendet keine Analysedaten. Ihr Zugriffstoken bleibt in Ihrem Anmeldeschlüsselbund.

Wie deinstalliere ich Kivuko?

Beenden Sie zuerst Kivuko, entfernen Sie dann seine Konfiguration unter Systemeinstellungen › VPN, legen Sie Kivuko.app in den Papierkorb und löschen Sie sein Token aus dem Anmeldeschlüsselbund. Wenn Sie zuerst die App löschen, kann der Kill Switch Ihre Verbindung weiter blockieren.

Lizenz

Kivuko ist freie Software unter der GNU General Public License v3.0 oder später. Fehlerberichte und Pull-Requests sind auf GitHub willkommen.

Nutzen Sie es überall, auch beruflich, und lesen, ändern und teilen Sie den Quellcode. Wenn Sie eine veränderte Version weitergeben, veröffentlichen Sie deren Quellcode unter derselben Lizenz.

Danksagung: GotaTun von Mullvad, wireguard-apple und objc2.