Localtonet unter Linux installieren
Auf dieser Seite 9 Abschnitte
- Bevor Sie beginnen
- Mit dem Skript installieren
- Das Installationsskript ausführen
- Die Installation prüfen
- Manuell installieren
- Herunterladen und entpacken
- Optional: in Ihren PATH verschieben
- Den Client starten
- Mit Ihrem Token starten
- Die Sitzung prüfen
- Als systemd-Dienst ausführen
- Den Dienst installieren
- Prüfen, ob er läuft
- Dienstbefehle
- Die Unit und ihre Protokolle
- Aktualisieren
- Den Client ersetzen
- Den Dienst neu starten
- Deinstallieren
- Fehlerbehebung
- Verwandte Seiten
Unter Linux ist der Localtonet-Client ein einzelnes Konsolenprogramm. Installieren Sie ihn mit dem Installationsskript oder aus einem ZIP-Archiv, starten Sie ihn mit Ihrem AuthToken und installieren Sie ihn als systemd-Dienst, wenn er nach jedem Neustart starten soll.
Bevor Sie beginnen #
- Ein Localtonet-Konto. Erstellen Sie kostenlos eines, falls Sie noch keins haben.
- Ihr AuthToken. Wählen Sie Kopieren auf der Karte AuthToken im Dashboard, oder kopieren Sie ein Token aus Meine Tokens.
curloderwgetsowieunzip.- Für den systemd-Dienst: Root-Zugriff und eine Distribution, die systemd verwendet.
Weitere Möglichkeiten, Localtonet unter Linux zu betreiben. Unter Debian, Ubuntu, Fedora und RHEL können Sie ein DEB- oder RPM-Paket installieren, das eigene Dienste mitbringt. Es gibt eigene Anleitungen für Docker, OpenWrt-Router und Termux unter Android.
Mit dem Skript installieren #
-
Das Installationsskript ausführen #
Terminalcurl -fsSL https://localtonet.com/install.sh | shDas Skript erkennt Ihre CPU (x64, ARM64 oder ARM) und ob das System glibc oder musl verwendet, lädt die passende Version herunter und installiert sie nach
/usr/local/bin/localtonet. Es legt außerdem den Link/usr/bin/localtonetan, damitsudo localtonetauch auf Distributionen funktioniert, bei denensudonicht in/usr/local/binsucht.Das Skript verwendet
sudo, wenn Ihr Benutzer nicht in den Installationsordner schreiben kann, weshalb es möglicherweise nach Ihrem Passwort fragt. Fehltunzip, versucht es, es mit dem Paketmanager Ihrer Distribution zu installieren. -
Die Installation prüfen #
Das Skript gibt am Ende die installierte Version aus. Sie können sie jederzeit erneut ausgeben:
Terminallocaltonet --version
Manuell installieren #
Wenn Sie lieber direkt herunterladen, nehmen Sie das Archiv für Ihr System. Jede ZIP-Datei enthält eine einzige Datei, localtonet.
| CPU | glibc (Debian, Ubuntu, Fedora, RHEL und die meisten anderen) | musl (Alpine) |
|---|---|---|
| x64 | localtonet-linux-x64.zip | localtonet-linux-musl-x64.zip |
| ARM64 | localtonet-linux-arm64.zip | localtonet-linux-musl-arm64.zip |
| ARM (32 Bit) | localtonet-linux-arm.zip | localtonet-linux-musl-arm.zip |
uname -m gibt Ihren CPU-Typ aus: x86_64 ist x64, aarch64 ist ARM64 und armv7l ist ARM.
-
Herunterladen und entpacken #
Das Beispiel verwendet die x64-glibc-Version. Ersetzen Sie den Dateinamen durch das Archiv für Ihr System.
Terminalwget https://localtonet.com/download/localtonet-linux-x64.zip unzip localtonet-linux-x64.zip -d ~/localtonet chmod 755 ~/localtonet/localtonet -
Optional: in Ihren PATH verschieben #
Ohne diesen Schritt starten Sie den Client über seinen Pfad,
~/localtonet/localtonet. Danach können Sie in jedem Ordnerlocaltoneteingeben.Terminalsudo mv ~/localtonet/localtonet /usr/local/bin/localtonet
Den Client starten #
-
Mit Ihrem Token starten #
Terminallocaltonet --authtoken <YOUR_TOKEN>Der Client speichert das Token lokal für Ihren Benutzer. Beim nächsten Mal können Sie ihn allein mit
localtonetstarten. Starten Sie ihn ohne gespeichertes Token, fragt erPlease Enter AuthToken or PIN. -
Die Sitzung prüfen #
Das Terminal zeigt
Session Status: Connectedüber einer Tabelle mit einer Zeile pro laufendem Tunnel:IP/Url,Protocol,Client IP,Client Port,PingundStatus. Die Tabelle bleibt leer, bis Sie im Dashboard einen Tunnel starten, siehe Schnellstart.Drücken Sie Ctrl + C, um den Client zu beenden. Drücken Sie F12, um das gespeicherte Token zu entfernen und das Programm zu beenden.
Ist die Ausgabe kein Terminal, zum Beispiel wenn Sie sie in eine Datei umleiten, schreibt der Client statt der Tabelle bei jeder Änderung eine einfache Zeile.
VPN benötigt Root. Gehört das Gerät zu einem Netzwerk des VPN-Managers und der Client läuft ohne Root, zeigt die VPN-Zeile der Tabelle Admin rights required.. Starten Sie den Client in diesem Fall mit sudo oder als Dienst.
Als systemd-Dienst ausführen #
Ein Dienst startet Localtonet nach jedem Neustart, hält es nach dem Abmelden am Laufen und benötigt kein geöffnetes Terminal. Die Dienstbefehle benötigen Root.
-
Den Dienst installieren #
Terminalsudo localtonet --install-service --authtoken <YOUR_TOKEN>Der Befehl schreibt eine systemd-Unit für dieses Token, aktiviert sie und startet sie sofort. Er antwortet mit dem Namen der Unit:
[CLI] Installed service 'Localtonet_<TOKEN_PREFIX>'<TOKEN_PREFIX>sind die ersten 9 Zeichen Ihres Tokens. Jedes Token erhält eine eigene Unit, daher benötigen die anderen Dienstbefehle dasselbe--authtoken, um sie zu finden. -
Prüfen, ob er läuft #
Terminalsudo localtonet --status-service --authtoken <YOUR_TOKEN>Ein laufender Dienst antwortet
[CLI] Service 'Localtonet_<TOKEN_PREFIX>' status: Running. Im Dashboard zeigt das Token unter Meine Tokens Online an.
Dienstbefehle #
Führen Sie jeden Befehl mit sudo aus und fügen Sie --authtoken <YOUR_TOKEN> hinzu.
| Befehl | Funktion |
|---|---|
--install-service | Schreibt die Unit-Datei, aktiviert die Unit und startet sie. |
--start-service | Startet die Unit, zum Beispiel nachdem Sie sie gestoppt haben. |
--stop-service | Stoppt die Unit. Sie bleibt aktiviert und startet nach einem Neustart wieder. |
--status-service | Gibt den Zustand aus, zum Beispiel Running, Stopped oder Error, wenn die Unit fehlgeschlagen ist. |
--remove-service | Stoppt und deaktiviert die Unit und löscht die Unit-Datei. |
Der Dienst wird mit den Optionen installiert, die Sie zusammen mit --install-service übergeben. Die Optionen sind in der CLI-Referenz aufgeführt.
Die Unit und ihre Protokolle #
Die Unit-Datei ist /etc/systemd/system/Localtonet_<TOKEN_PREFIX>.service. systemd startet den Client fünf Sekunden nach einem Fehler neu. Da es eine normale systemd-Unit ist, können Sie sie auch mit systemctl verwalten und ihre Ausgabe mit journalctl lesen:
systemctl list-units 'Localtonet_*'
systemctl status Localtonet_<TOKEN_PREFIX>
journalctl -u Localtonet_<TOKEN_PREFIX> -fDie Unit startet die Datei localtonet aus dem Pfad, den sie bei der Installation des Dienstes hatte. Eine Ausnahme: Liegt dieser Pfad unter /root/, kopiert der Installationsbefehl die Datei nach /usr/local/lib/Localtonet_<TOKEN_PREFIX>/, und der Dienst führt die Kopie aus.
Aktualisieren #
-
Den Client ersetzen #
Führen Sie das Installationsskript erneut aus. Es lässt sich bedenkenlos wiederholen und überschreibt den installierten Client mit der aktuellen Version. Laden Sie nach einer manuellen Installation das aktuelle Archiv herunter und ersetzen Sie die Datei
localtonet.Terminalcurl -fsSL https://localtonet.com/install.sh | sh -
Den Dienst neu starten #
Ein laufender Dienst verwendet weiter die alte Version, bis er neu gestartet wird.
Terminalsudo systemctl restart Localtonet_<TOKEN_PREFIX>Führt der Dienst eine Kopie unter
/usr/local/lib/aus, entfernen Sie stattdessen den Dienst und installieren Sie ihn mit dem neuen Client erneut.
Unter Meine Tokens zeigt die Spalte Client die Version, die das Gerät zuletzt gemeldet hat, und ein Badge Update nötig, wenn eine neuere verfügbar ist.
Deinstallieren #
- Wenn Sie den Dienst installiert haben, entfernen Sie ihn:
sudo localtonet --remove-service --authtoken <YOUR_TOKEN> - Um das gespeicherte Token zu entfernen, starten Sie den Client und drücken Sie F12.
- Löschen Sie den Client:
sudo rm /usr/local/bin/localtonet /usr/bin/localtonetnach der Skript-Installation, oder den Ordner, in den Sie das Archiv entpackt haben.
Fehlerbehebung #
Installationsskript: Unsupported architecture
Das Skript hat Versionen für x64 (x86_64), ARM64 (aarch64) und 32-Bit-ARM (armv7l). Andere CPU-Typen werden von den Linux-Versionen nicht unterstützt.
Installationsskript: Neither curl nor wget found
Installieren Sie curl oder wget mit Ihrem Paketmanager und führen Sie das Skript erneut aus.
Installationsskript: Failed to install 'unzip'
Das Skript konnte unzip nicht selbst installieren. Installieren Sie es mit Ihrem Paketmanager und führen Sie das Skript erneut aus.
Installed but not found in PATH
Öffnen Sie eine neue Shell, oder starten Sie den Client über seinen vollständigen Pfad, /usr/local/bin/localtonet.
sudo: localtonet: command not found
Nach einer manuellen Installation liegt der Client nicht im Suchpfad von sudo. Verwenden Sie den vollständigen Pfad, zum Beispiel sudo ~/localtonet/localtonet --install-service --authtoken <YOUR_TOKEN>, oder verschieben Sie die Datei zuerst nach /usr/local/bin.
Install failed: 'Linux systemd service installation' requires elevated (admin/root) privileges.
Der Befehl wurde ohne Root ausgeführt. Wiederholen Sie ihn mit sudo. Dasselbe gilt für --start-service, --stop-service und --remove-service.
Install failed: Systemd unit already exists for 'Localtonet_…'
Für dieses Token ist bereits ein Dienst installiert. Prüfen Sie ihn mit --status-service. Um ihn erneut zu installieren, führen Sie zuerst --remove-service aus.
Die Dienstbefehle schlagen auf einem System ohne systemd fehl
Der Dienstmodus verwendet systemd. Starten Sie den Client auf Systemen ohne systemd auf andere Weise, zum Beispiel in einem Docker-Container. Der Konsolen-Client hat dafür einen Headless-Modus: --headless läuft ohne Eingabeaufforderungen und liest das Token aus einer Datei, die mit --authtoken-file angegeben wird. Siehe die CLI-Referenz.
Wrong Token!
Der Client erwartet das 33-stellige AuthToken aus Meine Tokens oder eine 6-stellige PIN, die noch nicht abgelaufen ist. Kopieren Sie das Token erneut und geben Sie es an der Eingabeaufforderung ein.
This token is used in another localtonet application!
Ein anderer Localtonet-Client auf diesem Rechner läuft bereits mit demselben Token. Schließen Sie ihn, oder starten Sie diesen mit einem anderen Token. Verwenden Sie pro Token einen laufenden Client.