Windscribe bietet zwei Linux-Apps: eine grafische App und eine Befehlszeilen-App. Die grafische App benötigt eine Desktop-Umgebung. Verwende daher auf einem Headless-System oder einem Rechner, der nur über das Terminal bedient wird, die Linux CLI-App. In dieser Anleitung erfährst du, wie du sie installierst, dich anmeldest, eine Verbindung herstellst und wo du die übrigen Einstellungen konfigurierst.
Linux CLI-Befehle verwenden den Namen windscribe-cli (mit dem Suffix -cli), zum Beispiel windscribe-cli login und windscribe-cli connect.
Downloads für die GUI- und CLI-Apps findest du auf der Windscribe-Download-Seite. Windscribe ist Open Source. Der Quellcode und die Release-Dateien werden auf GitHub veröffentlicht.
Lade für die Verwendung auf einem Headless-System den Linux CLI-Build herunter, der zu deiner Distribution und Architektur passt.
AMD64:
curl -L https://windscribe.com/install/desktop/linux_deb_x64_cli -o windscribe.deb sudo apt install ./windscribe.deb
ARM64:
curl -L https://windscribe.com/install/desktop/linux_deb_arm64_cli -o windscribe.deb sudo apt install ./windscribe.deb
Linux CLI-Builds für Fedora/CentOS, Arch und openSUSE sind auf der Download-Seite verfügbar. Lade den Build für deine Distribution herunter und installiere ihn mit dem Paketmanager deiner Distribution.
Führe windscribe-cli-Befehle als normaler Benutzer aus. Nur für die oben beschriebene Paketinstallation wird sudo benötigt.
Melde dich mit deinem Windscribe-Konto an:
windscribe-cli login
Stelle eine Verbindung zum VPN her:
windscribe-cli connect
Prüfe deinen Verbindungsstatus:
windscribe-cli status
Nach dem Herstellen der Verbindung solltest du überprüfen, ob dein Datenverkehr tatsächlich durch das VPN geleitet wird. Der Status Connected ist ein gutes Zeichen, allein aber noch kein Beweis. Beginne mit:
windscribe-cli status
Neben dem Verbindungsstatus und der Stadt zeigt die Statusausgabe dein Protokoll und deinen Port, den Status der Firewall sowie deinen Datenverbrauch an. So kannst du das monatliche Datenvolumen eines kostenlosen Tarifs bequem im Blick behalten. Zwei Hinweise solltest du kennen: Ein Sternchen vor Connected bedeutet, dass der Tunneltest noch läuft. Ein Hinweis auf Netzwerkstörungen bedeutet, dass der Test etwas gefunden hat, das du genauer prüfen solltest.
Prüfe auf einem Headless-System unabhängig davon, ob sich deine öffentliche IP-Adresse geändert hat. Dazu kannst du vor und nach dem Verbindungsaufbau ohne Browser einen IP-Abfragedienst aufrufen:
curl ifconfig.me
Wenn die während der Verbindung zurückgegebene Adresse dem von dir gewählten Standort und nicht deinem tatsächlichen Standort entspricht, wird der Datenverkehr durch den Tunnel geleitet. Prüfe das lieber selbst, statt uns einfach zu glauben.
Auch DNS solltest du berücksichtigen. Standardmäßig leiten wir DNS-Anfragen während der Verbindung über unsere eigenen Server. Dadurch wird die R.O.B.E.R.T.-Filterung angewendet. Wenn du in der Konfigurationsdatei einen benutzerdefinierten DNS-Server festgelegt hast, prüfe, ob dieser deine Anfragen auflöst und nicht der Server deines Anbieters.
Wenn du windscribe-cli connect ohne weitere Angaben ausführst, wirst du erneut mit deinem zuletzt verwendeten Standort verbunden oder die App wählt einen für dich aus. So zeigst du die vollständige Liste der verfügbaren Standorte an:
windscribe-cli locations
Standorte werden im Format Region - City - Nickname aufgeführt. Du kannst dich über den Stadtnamen, den Spitznamen, den Regionsnamen oder den aus zwei Buchstaben bestehenden Ländercode verbinden. Bei der Suche wird nicht zwischen Groß- und Kleinschreibung unterschieden.
windscribe-cli connect "Toronto" windscribe-cli connect CA
So lässt du die App anhand der Latenz einen Server für dich auswählen:
windscribe-cli connect best
So zeigst du deine bevorzugten Standorte einschließlich angehefteter IPs an:
windscribe-cli locations fav
So trennst du die VPN-Verbindung jederzeit:
windscribe-cli disconnect
Die Linux CLI-App unterstützt WireGuard, OpenVPN im UDP- und TCP-Modus, Stealth und WStunnel. IKEv2 ist in den Windows- und macOS-Apps verfügbar, aber nicht unter Linux. Stealth und WStunnel sind langsamer und vor allem in restriktiven Netzwerken nützlich. Füge zum Ändern des Protokolls den Protokollnamen hinter dem Standort hinzu:
windscribe-cli connect best wireguard windscribe-cli connect "Toronto" stealth
Bei Protokollnamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Füge nach dem Protokoll einen Doppelpunkt und den gewünschten Port hinzu, um dich über einen bestimmten Port zu verbinden:
windscribe-cli connect best udp:443
So listest du die für ein Protokoll verfügbaren Ports auf:
windscribe-cli ports wireguard
Wenn du einen nicht verfügbaren Port eingibst, verwendet die App stattdessen den Standardport für dieses Protokoll.
Die Firewall blockiert Datenverkehr außerhalb des VPN-Tunnels. Das hilft, Datenlecks zu verhindern, wenn die Verbindung abbricht. So schaltest du sie ein oder aus:
windscribe-cli firewall on windscribe-cli firewall off
Sei mit der Firewall auf Rechnern vorsichtig, die du über SSH verwaltest. Wenn das VPN nicht verbunden und die Firewall eingeschaltet ist, kann sie neben allem anderen auch deine SSH-Sitzung blockieren. Wenn du dich über das lokale Netzwerk verbindest, lässt die nachfolgend beschriebene Option AllowLANTraffic lokalen Datenverkehr zu.
Wenn du dich mit windscribe-cli logout abmeldest, wird die VPN-Verbindung getrennt und die Firewall ausgeschaltet. So meldest du dich ab, ohne die Firewall auszuschalten:
windscribe-cli logout on
Die Linux CLI-App liest ihre Einstellungen aus einer Konfigurationsdatei:
~/.config/Windscribe/windscribe_cli.conf
Bei den Werten in dieser Datei wird zwischen Groß- und Kleinschreibung unterschieden. Sie müssen genau mit den zulässigen Werten übereinstimmen. Stimmt ein Wert nicht überein, verwendet die App stattdessen den Standardwert. Wenden Sie Ihre Änderungen nach dem Bearbeiten der Datei an:
windscribe-cli preferences reload
Damit können Geräte in deinem lokalen Netzwerk den Rechner erreichen, während das VPN und die Firewall aktiv sind. Aktiviere diese Einstellung, wenn du per SSH von demselben Netzwerk aus auf ein Headless-System zugreifst:
[Connection] AllowLANTraffic=true
Stellt automatisch eine VPN-Verbindung her, wenn der Windscribe-Dienst startet:
[Connection] Autoconnect=true
Standardmäßig verwendet die App während der Verbindung das DNS von Windscribe. Dadurch wird die R.O.B.E.R.T.-Filterung angewendet. Um einen anderen DNS-Server zu verwenden, stelle den Modus auf Custom und lege einen Upstream-Server fest. Als Upstream-Werte werden einfache IP-Adressen oder DNS-over-HTTPS/TLS-URLs akzeptiert:
[Connection] ConnectedDNSMode=Custom ConnectedDNSUpstream1=1.1.1.1
Mit Split-Tunneling werden bestimmte Apps oder Netzwerkbereiche innerhalb oder außerhalb des VPN-Tunnels geroutet. Im Exclude-Modus wird alles außer den von dir aufgeführten Einträgen durch das VPN geleitet. Im Include-Modus werden nur die aufgeführten Einträge durch das VPN geleitet:
[Connection] SplitTunnelingEnabled=true SplitTunnelingMode=Exclude SplitTunnelingApps=/usr/bin/curl SplitTunnelingRoutes=192.168.1.0/24
App-Einträge sind vollständige, durch Kommas getrennte Pfade zu ausführbaren Dateien. Nicht vorhandene Pfade werden ohne Meldung übersprungen. Überprüfe sie daher sorgfältig, wenn sich eine App nicht wie erwartet verhält.
Du kannst die VPN-Verbindung als HTTP- oder SOCKS-Proxy mit anderen Geräten in deinem Netzwerk teilen:
[Connection] ShareProxyGatewayEnabled=true ShareProxyGatewayMode=HTTP ShareProxyGatewayPort=8888
Setze ShareProxyGatewayMode auf HTTP oder SOCKS und wähle einen beliebigen Port zwischen 1024 und 65535.
Eine vollständige Liste der verfügbaren Optionen findest du in der Referenz zur Linux CLI-Konfigurationsdatei.
Fordere auf demselben Server eine neue IP-Adresse an. Diese Funktion ist bei bestehender Verbindung in manchen Tarifen verfügbar:
windscribe-cli ip rotate
Suche nach App-Updates und installiere sie:
windscribe-cli update
Sende Debug-Protokolle an den Windscribe-Support. Das ist bei der Fehlerbehebung auf einem Headless-System hilfreich:
windscribe-cli logs send
R.O.B.E.R.T. ist die Funktion von Windscribe zum Blockieren von Domains. Regeln werden nicht über die CLI verwaltet, sondern unter My Account festgelegt. Die Anzahl der benutzerdefinierten Regeln hängt von deinem Tarif ab:
Wenn etwas schiefgeht, gibt die CLI den Fehler im Terminal aus und liefert den Exit-Code 1 statt 0 zurück. Dadurch können Skripte Erfolg und Fehlschlag unterscheiden. Hier sind einige der häufigeren Meldungen:
Die CLI konnte den Hintergrunddienst, mit dem sie kommuniziert, nicht starten. Warte einen Moment und führe den Befehl erneut aus. Wenn das Problem wiederholt auftritt, prüfe, ob der windscribe-helper-Dienst ausgeführt wird.
Die Verbindung zwischen der CLI und dem Hintergrunddienst wurde während eines Befehls unterbrochen. Das Problem ist häufig vorübergehend. Führe den Befehl daher erneut aus. Es kann auch direkt nach einer Änderung an den Firewall- oder LAN-Einstellungen auftreten, während das VPN aktiv ist. Warte dann einen Moment, bevor du es erneut versuchst.
Die Firewall befindet sich im Modus Always On und kann nicht über die CLI ausgeschaltet werden. Dieser Modus wird in der Desktop-App festgelegt. Wenn du ihn deaktivieren möchtest, musst du das dort ändern. Auf einem Headless-System wirst du diese Meldung wahrscheinlich nur sehen, wenn die Einstellung zuvor auf einem System mit der grafischen App festgelegt wurde.
Dies deutet normalerweise auf ein Problem beim Einrichten des Netzwerkadapters hin. Wenn du zu einem anderen Protokoll wie UDP oder TCP wechselst, kannst du häufig eine Verbindung herstellen, während du das Problem untersuchst:
windscribe-cli connect best udp
Wenn keine dieser Beschreibungen passt, sende deine Debug-Protokolle an unser Support-Team, damit es sich das Problem ansehen kann:
windscribe-cli logs send
Führe den folgenden Befehl aus, um die vollständige Liste der von der CLI unterstützten Befehle mit einer kurzen Beschreibung anzuzeigen:
windscribe-cli --help
Für Schritt-für-Schritt-Anleitungen und Antworten auf häufige Fragen ist unsere Wissensdatenbank eine gute nächste Anlaufstelle: windscribe.com/knowledge-base.
Wenn du die CLI-App entfernen möchtest, verwende den Paketmanager deiner Distribution. Das Paket heißt windscribe-cli.
Entferne das Paket:
sudo apt remove windscribe-cli
Um auch die Systemkonfiguration zu löschen, verwende stattdessen purge:
sudo apt purge windscribe-cli
Entferne unter Fedora/CentOS, Arch oder openSUSE das Paket windscribe-cli mit deinem Paketmanager, zum Beispiel mit dnf remove, pacman -R oder zypper remove.
Deine persönlichen Einstellungen befinden sich in einem separaten Konfigurationsverzeichnis, das vom Paketmanager nicht verändert wird. Wenn du auch diese Einstellungen entfernen möchtest, lösche das Verzeichnis:
rm -r ~/.config/Windscribe
Verwende den reinen Linux CLI-Build. Die grafische App benötigt eine Desktop-Umgebung und wird daher nicht auf einem Rechner ausgeführt, der nur über das Terminal bedient wird, oder auf einem Headless-System. Beim CLI-Build enden die Download-Links auf _cli, und die Ausgabe erfolgt immer im Terminal.
Ja. Kostenlose Konten enthalten 2 GB Datenvolumen pro Monat. Nach Bestätigung deiner E-Mail-Adresse erhöht sich das Volumen auf 10 GB pro Monat. Du kannst dich damit mit den kostenlosen Standorten verbinden. Die CLI funktioniert bei kostenlosen und kostenpflichtigen Tarifen gleich. Für einige Funktionen wie statische IPs und die IP-Rotation ist ein kostenpflichtiger Tarif erforderlich.
Nein. Führe windscribe-cli-Befehle als normaler Benutzer aus. Nur für die Paketinstallation während der Einrichtung wird sudo benötigt.
WireGuard ist eine gute Standardeinstellung und unterstützt Post-Quanten-Verschlüsselung. Wenn du dich in einem Netzwerk befindest, das VPNs blockiert oder drosselt, sind Stealth und WStunnel dafür ausgelegt, diese Einschränkungen zu umgehen. Sie sind allerdings meist langsamer. Bei Bedarf ist OpenVPN im UDP- oder TCP-Modus verfügbar. Mit windscribe-cli ports kannst du auflisten, welche Ports ein Protokoll anbietet.
Beim reinen CLI-Build gibt locations die Liste wie erwartet im Terminal aus. Wenn die Ausgabe leer ist, verwendest du höchstwahrscheinlich stattdessen die grafische Desktop-App. Dort öffnet der Befehl locations die Liste im App-Fenster und nicht im Terminal. Installiere auf einem Headless-System den reinen CLI-Build.
Führe windscribe-cli login aus und gib deinen Benutzernamen und dein Passwort ein. Wenn die Zwei-Faktor-Authentifizierung aktiviert ist, wirst du anschließend zur Eingabe des Codes aufgefordert. Wenn ein CAPTCHA erforderlich ist, stellt der reine CLI-Build es als ASCII-Grafik im Terminal dar. So kannst du es auch ohne Browser lösen.
Füge der Konfigurationsdatei wie oben gezeigt Autoconnect=true hinzu, damit die VPN-Verbindung automatisch hergestellt wird, wenn der Dienst startet. Auf einem Headless-System, auf dem nie eine interaktive Anmeldesitzung ausgeführt wird, muss der Dienst außerdem ohne deine Anmeldung laufen können. Aktiviere Lingering für deinen Benutzer:
loginctl enable-linger <username>
Nein. Diese Funktionen werden im My Account-Dashboard auf der Website und nicht über die Befehlszeile verwaltet. Dasselbe gilt für das Freischalten von Streaming, die Verwaltung statischer IPs und das Herunterladen manueller Konfigurationsdateien. Die CLI deckt Verbindungen, Protokolle, die Firewall, DNS, Split-Tunneling und die Proxy-Freigabe ab.
Wenn die Firewall eingeschaltet und das VPN nicht verbunden ist, wird sämtlicher Datenverkehr außerhalb des VPNs blockiert. Dazu kann auch die SSH-Sitzung gehören, über die du den Rechner verwaltest. Wenn du dich über das lokale Netzwerk verbindest, setze AllowLANTraffic=true in der Konfigurationsdatei, damit lokaler Datenverkehr auch bei aktiver Firewall zugelassen wird. Wenn du bereits ausgesperrt bist, benötigst du Konsolen- oder physischen Zugriff, um windscribe-cli firewall off auszuführen. Um dies zu vermeiden, lege AllowLANTraffic fest, bevor du die Firewall einschaltest, statt die Einstellung während einer laufenden Sitzung zu ändern.