NekoBox: eine Qt-Oberfläche für sing-box unter Windows und Linux
qr243vbi/nekobox bietet eine praxistaugliche Open-Source-Implementierung mit stabiler Einsatzbarkeit für reale Anwendungsfälle.
Auf einen Blick
- Was ist das?
- NekoBox verpackt den sing-box-Kern in eine plattformübergreifende Qt-Anwendung. Der Beitrag prüft Installation, Funktionsumfang und die Grenzen der Verpackung.
- Für wen ist es gedacht?
- NekoBox passt für Nutzer, die sing-box mit einer grafischen Oberfläche unter Windows oder Linux betreiben wollen und die portable ZIP-Variante oder ein Paket aus ihrem Distributionssystem bevorzugen. Die Abdeckung der Architekturen ist breit, die Integration in die jeweiligen Paketquellen aber unterschiedlich gepflegt.
- Darf ich es kommerziell nutzen?
- Ja, unter Bedingungen. GPL-3.0 ist eine Copyleft-Lizenz: Wenn Sie Software weitergeben, die sie enthält, müssen Sie deren Quellcode unter derselben Lizenz veröffentlichen. Wer sie nur intern betreibt, ohne sie weiterzugeben, löst diese Pflicht nicht aus.
- Wird es noch gepflegt?
- Ja. Die letzten Commits kamen vor 10 Tagen.
- In welcher Sprache ist es geschrieben?
- Hauptsächlich C++, laut der Sprachstatistik von GitHub.
Die Antworten beruhen auf den GitHub-Daten des Projekts (zuletzt abgeglichen am 14. September 2026) und auf unserer Analyse. Sie sind keine Rechtsberatung.
TIEFGEHENDE OPEN-SOURCE-ANALYSE
Ein Qt-Client für den sing-box-Kern
NekoBox verpackt den sing-box-Kern in eine Qt-basierte Desktop-Anwendung. Die Konfiguration erfolgt über eine grafische Oberfläche, während der eigentliche Datenverkehr durch den eingebetteten sing-box-Kern läuft. Das Projekt unterstützt Windows 11 und 10 in den Varianten arm64, x86_64 und x86 sowie Linux, und stellt portable ZIP-Archive, Windows-Installationsprogramme und AppImages bereit.
Der Name NyameBox trägt die aktuelle Entwicklung, während die ursprüngliche Bezeichnung NekoBox in der Community weiterhin gebräuchlich bleibt. Beide Namen verweisen auf dasselbe Projekt, das von einem einzelnen Entwickler gepflegt wird. Die Gesamtzahl der Sterne auf GitHub liegt im niedrigen vierstelligen Bereich, was auf eine aktive, aber überschaubare Nutzerschaft hinweist.
Vier Paketquellen nebeneinander
Die Installation ist über mehrere Wege möglich: Winget für Windows, Chocolatey als alternative Windows-Paketquelle, Scoop für Kommandozeilen-Nutzer sowie das Open Build Service für verschiedene Linux-Distributionen. Diese Vervielfältigung der Bezugsquellen erleichtert die Erstinstallation, bedeutet aber auch, dass nicht alle Quellen im gleichen Takt aktualisiert werden. Wer Wert auf die neueste Version legt, prüft die GitHub-Releases direkt.
Der Sing-Box-Kommandozeilenmodus
Neben der grafischen Steuerung bietet NekoBox einen Kommandozeilenmodus, der über nekobox_core angesprochen wird und die vollständige Funktionalität von sing-box offenlegt. Dieser Modus richtet sich an Nutzer, die Skripte schreiben oder die Konfiguration in Dateien verwalten wollen. Die Dokumentation beschreibt die zusätzlich verfügbaren Befehle, die über den üblichen Funktionsumfang eines GUI-Clients hinausgehen.
Die Trennung zwischen grafischer Oberfläche und Kern hat den Vorteil, dass ein Update der Oberfläche keine Auswirkungen auf die laufenden Verbindungen hat. Der Kern arbeitet unabhängig im Hintergrund, während die Oberfläche nur zur Konfiguration und Statusanzeige dient. Diese Architektur ähnelt der anderer Proxy-Clients und erleichtert den Umstieg von vergleichbaren Werkzeugen.
Was der Client nicht abdeckt
NekoBox ist ein Werkzeug für bestehende Konfigurationen: Es verwaltet Serverzugänge und Routing-Regeln, ersetzt aber weder einen Anbieter noch eine Anleitung zur Einrichtung solcher Zugänge. Nutzer ohne bestehende Konfiguration benötigen zusätzlich Informationen zur Netzwerkanbindung, die über den Umfang dieses Clients hinausgehen. Die Lizenz GPL-3.0 erlaubt die freie Nutzung und Modifikation, verlangt aber die Offenlegung von Änderungen bei Weitergabe.
Konfigurationsformate und Profilverwaltung
NekoBox akzeptiert Konfigurationen im JSON-Format von sing-box und ergänzt eigene Felder für die grafische Verwaltung. Die Profilverwaltung erlaubt mehrere Konfigurationen nebeneinander, zwischen denen ohne Neustart gewechselt werden kann. Wer Konfigurationen versioniert, sollte die exportierten Dateien in ein Repository übernehmen, denn die manuelle Eingabe über die Oberfläche ist fehleranfälliger als das Einspielen einer getesteten Datei.
Fehlerdiagnose bei Verbindungsproblemen
Wenn die Verbindung nicht zustande kommt, hilft die eingebaute Protokollansicht weiter: Sie zeigt die Meldungen des sing-box-Kerns in Echtzeit und erlaubt die Unterscheidung zwischen Konfigurations-, Netzwerk- und Berechtigungsfehlern. Unter Linux benötigt die Behandlung von TUN-Geräten erweiterte Berechtigungen, die auf verschiedenen Distributionen unterschiedlich konfiguriert werden. Die Fehlerbilder lassen sich meist auf drei Ursachen zurückführen: falsche Zugangsdaten, fehlende Berechtigungen oder abgelaufene Serveradressen.
Aktualisierungstakt und Stabilität
Das Projekt veröffentlicht in kurzen Abständen neue Versionen mit Fehlerbehebungen und angepassten Kernversionen. Die Release-Seite listet portable ZIP-Archive für Windows und AppImages für Linux, daneben stehen Pakete für verschiedene Distributionen bereit. Wer die portable Variante nutzt, aktualisiert durch Austausch des Programmordners und behält die alte Version als Fallback. Die Installationsvarianten richten die Aktualisierung teilweise selbstständig ein, erfordern aber Berechtigungen, die in verwalteten Umgebungen geprüft werden müssen.
Unterschiede zur Kommandozeilenversion von sing-box
Wer sing-box direkt über die Kommandozeile betreibt, verwaltet die Konfiguration in JSON-Dateien und steuert den Dienst über Systemkommandos. NekoBox erleichtert diese Arbeit durch grafische Formulare, bleibt aber intern bei denselben Konfigurationsstrukturen. Der Wechsel zwischen beiden Betriebsarten ist verlustfrei, solange die Konfigurationsdatei nicht manuell verändert wird. Für Nutzer, die beide Wege kombinieren, empfiehlt sich die Festlegung eines Kanons: Änderungen entweder nur über die Oberfläche oder nur über die Datei, nicht gemischt.
Redaktionelles Fazit
NekoBox passt für Nutzer, die sing-box mit einer grafischen Oberfläche unter Windows oder Linux betreiben wollen und die portable ZIP-Variante oder ein Paket aus ihrem Distributionssystem bevorzugen. Die Abdeckung der Architekturen ist breit, die Integration in die jeweiligen Paketquellen aber unterschiedlich gepflegt. Wer ein kernelnahes Tool ohne grafische Oberfläche sucht, bleibt bei der Kommandozeilenversion von sing-box. Vor dem Einsatz lohnt ein Blick auf die Release-Notizen: Das Projekt entwickelt sich schnell und veröffentliche häufig.
Community-Notizen