Localtonet unter OpenWrt installieren
Experimentell OpenWrt 24.10 und 25.12+ x64 und ARM64
Auf dieser Seite 12 Abschnitte
- Bevor Sie beginnen
- Unterstützte Versionen und Architekturen
- Was nicht unterstützt wird
- Die Architektur prüfen
- OpenWrt 24.10 (opkg)
- Speicher und Arbeitsspeicher
- Was das Paket installiert
- Token-Datei und Konfiguration
- Die Token-Datei
- Die UCI-Konfiguration
- Der Dienst
- Protokolle
- Aktualisieren und entfernen
- OpenWrt 24.10 (opkg)
- VPN unter OpenWrt
- Fehlerbehebung
- Verwandte Seiten
Führen Sie den Localtonet-Client direkt auf einem OpenWrt-Router aus. Das Paket installiert den Client, eine Token-Datei, eine UCI-Konfiguration und einen Dienst, der mit dem Router startet.
Die OpenWrt-Pakete sind experimentell. Es sind unsignierte Dateien, die Sie von Hand installieren, keine Pakete aus einem signierten OpenWrt-Feed. Prüfen Sie die Firmware-Kompatibilität, Ihre Tunnel und das VPN auf Ihrem eigenen Gerät, bevor Sie sich darauf verlassen.
Bevor Sie beginnen #
- Ein Router mit einer unterstützten OpenWrt-Version und CPU-Architektur (siehe nächster Abschnitt).
- Root-Zugriff auf den Router per SSH.
- Internetzugang des Routers während der Installation. Der Paketmanager lädt die Abhängigkeiten aus den eigenen Paket-Feeds Ihrer Firmware herunter.
- Genügend freier Speicher und Arbeitsspeicher (siehe Speicher und Arbeitsspeicher).
- Ein AuthToken aus Meine Tokens, das kein anderes Gerät verwendet.
Unterstützte Versionen und Architekturen #
OpenWrt hat seinen Paketmanager zwischen Releases gewechselt, daher gibt es zwei Paketformate. Wählen Sie das passende für Ihre Firmware:
| OpenWrt-Version | Paketformat | Paketmanager | Architekturen |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 und neuer | APK v3 | apk | x64, ARM64 |
APK bedeutet hier ein OpenWrt-Paket. Diese .apk-Dateien sind keine Android-Apps und lassen sich nicht auf einem Smartphone installieren. Für Android siehe Android.
Was nicht unterstützt wird #
- MIPS-, MIPSEL- und ARMv7-Router. Für diese Architekturen gibt es keine Pakete.
- Die Installation aus einem Paket-Feed. Die Pakete sind lokale Dateien; Ihr Router findet oder aktualisiert sie nicht über
opkg updateoderapk update. - Ein Paket auf eine andere Architektur zu erzwingen. Umgehen Sie niemals die Architekturprüfung des Paketmanagers.
Die Architektur prüfen #
Die Paketarchitektur muss zu Ihrer Firmware passen. Fragen Sie den Router, welche Architekturen er akzeptiert:
OpenWrt 24.10 (opkg) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archEin x64-Router meldet x86_64. ARM64-Router melden einen Namen, der mit aarch64_ beginnt und sich je nach Firmware-Build unterscheidet. Zu jedem Paket gehört eine kurze Anleitungsdatei, die die genaue Paketarchitektur nennt, für die es gebaut wurde, zum Beispiel x86_64 oder aarch64_generic. Wählen Sie auf der Seite Downloads unter OpenWrt Ihr Paket und öffnen Sie Anleitung zur Paketeinrichtung, um sie zu lesen. Vergleichen Sie diese Architektur mit der Angabe Ihres Routers. Stimmen sie nicht überein, installieren Sie das Paket nicht.
Speicher und Arbeitsspeicher #
Das Paket enthält den Client samt eigener Laufzeitumgebung und ist daher viel größer als ein typisches OpenWrt-Paket. Prüfen Sie den Router vor der Installation:
df -h
free- Flash (Overlay). Die Programmdateien werden unter
/usr/lib/localtonetinstalliert. Ein Router mit kleinem Flash-Chip benötigt eventuell Extroot (externer Speicher als Root-Overlay), damit sie hineinpassen. - RAM und
/tmp. Beim Start entpackt der Client seine nativen Bibliotheken nach/tmp/localtonet/bundle. Unter OpenWrt liegt/tmpim RAM, daher geht dieser Platz vom Arbeitsspeicher des Routers ab.
Was das Paket installiert #
| Pfad | Was es ist |
|---|---|
/usr/bin/localtonet | Der Befehl localtonet. |
/usr/lib/localtonet | Die Programmdateien. |
/etc/localtonet/auth-token | Die Token-Datei. Sie enthält den Platzhalter DUMMY_AUTH_TOKEN, bis Sie ihn ersetzen. Nur für root lesbar. |
/etc/config/localtonet | Die UCI-Konfiguration des Dienstes. |
/etc/init.d/localtonet | Das Dienstskript (procd). |
Das Paket hängt ab von libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft und ip6tables-nft. Der Paketmanager installiert die fehlenden aus den Feeds Ihrer Firmware, weshalb die Einrichtungsanleitung zuerst die Paketlisten aktualisiert. kmod-tun muss zum Kernel der installierten Firmware passen, beziehen Sie es daher immer aus den Feeds dieser Firmware.
Token-Datei und Konfiguration #
Die Installation des Pakets verbindet nichts. Der Dienst bleibt aus, bis Sie zwei Dinge getan haben: Ihr Token in die Token-Datei eintragen und den Dienst in UCI aktivieren. Die genauen Befehle für Ihr Paket stehen in seiner Einrichtungsanleitung am Ende dieser Seite; dieser Abschnitt erklärt, was sie bewirken.
Die Token-Datei #
/etc/localtonet/auth-token enthält Ihren AuthToken in einer einzigen Zeile und sonst nichts. Ersetzen Sie den Platzhalter DUMMY_AUTH_TOKEN durch Ihr Token, zum Beispiel mit vi. Lassen Sie die Datei nur für root lesbar (Modus 600).
Die Einrichtungsanleitung führt den Client anschließend einmal mit --headless --authtoken-file /etc/localtonet/auth-token --check-config aus. Das prüft die Datei, ohne sich mit Localtonet zu verbinden:
| Ausgabe | Bedeutung |
|---|---|
Localtonet headless configuration OK. | Die Datei enthält ein korrekt aufgebautes Token: 33 Zeichen, keine Leerzeichen. Die Prüfung beweist nicht, dass das Token für Ihr Konto gültig ist. |
Invalid Localtonet headless configuration. Check the token file or environment settings. | Die Datei fehlt, enthält noch den Platzhalter, oder das Token ist nicht 33 Zeichen lang. |
Die UCI-Konfiguration #
Der Dienst liest seine Einstellungen aus /etc/config/localtonet. Eine frische Installation enthält:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Option | Funktion | Werte |
|---|---|---|
enabled | Ob der Dienst den Client startet. Solange sie 0 ist, bewirkt das Starten des Dienstes nichts. | 0 (Standard) oder 1 |
token_file | Pfad der Datei, aus der der Client das Token liest. | Standard /etc/localtonet/auth-token |
Die aktuellen Werte zeigen Sie jederzeit so an:
uci show localtonetDer Dienst #
Der Client läuft als procd-Dienst namens localtonet. Die Installation des Pakets registriert ihn für den Start beim Booten, er startet den Client aber nur, wenn enabled auf 1 steht und die Token-Datei nicht leer ist. Nachdem Sie enabled auf 1 gesetzt und die Änderung übernommen (commit) haben, starten Sie den Dienst einmal neu; ab dann startet er mit dem Router.
| Befehl | Funktion |
|---|---|
/etc/init.d/localtonet restart | Stoppt und startet den Client. Führen Sie ihn aus, nachdem Sie die Token-Datei oder die Konfiguration geändert haben. |
/etc/init.d/localtonet stop | Stoppt den Client bis zum nächsten Neustart oder Reboot. |
/etc/init.d/localtonet disable | Der Dienst startet nicht mehr beim Booten. |
/etc/init.d/localtonet enable | Der Dienst startet wieder beim Booten. |
So schalten Sie den Client aus, behalten das Paket aber installiert:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartBeendet sich der Client unerwartet, startet procd ihn erneut.
Sobald der Client verbunden ist, erstellen und starten Sie Tunnel im Dashboard mit dem Token des Routers. Die Lokale IP-Adresse eines Tunnels kann 127.0.0.1 für einen Dienst auf dem Router selbst sein oder die LAN-Adresse eines beliebigen Geräts hinter dem Router, zum Beispiel 192.168.1.20.
Protokolle #
Der Client schreibt in das OpenWrt-Systemprotokoll. So zeigen Sie seine Zeilen an oder verfolgen sie live:
logread -e localtonet
logread -f -e localtonet| Zeile | Bedeutung |
|---|---|
Localtonet - headless log | Der Client wurde gestartet. |
Connection: … | Der Zustand der Verbindung zu Localtonet. |
AuthTokenName: … | Der Name des Tokens, mit dem sich der Router angemeldet hat. |
OPEN …, ADDED …, STATUS …, CLOSED … | Ein Tunnel dieses Tokens wurde gefunden, hinzugefügt, hat seinen Status geändert oder wurde entfernt. |
Authentication failed: AuthToken was rejected. | Localtonet hat das Token in der Token-Datei nicht akzeptiert. |
AuthToken file missing | Der Dienst ist aktiviert, aber die Token-Datei existiert nicht oder ist leer. |
Aktualisieren und entfernen #
Zum Aktualisieren installieren Sie das neuere Paket über das alte und starten den Dienst neu. Die Token-Datei und die UCI-Konfiguration bleiben erhalten. Beide Dateien stehen außerdem auf der Liste der Dateien, die OpenWrt bei einem Firmware-Upgrade behält, das Paket selbst muss nach dem Flashen einer neuen Firmware jedoch erneut installiert werden.
So entfernen Sie den Client:
OpenWrt 24.10 (opkg) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetDas Entfernen des Pakets stoppt den Dienst und nimmt ihn aus dem Bootvorgang.
VPN unter OpenWrt #
Das Paket zieht nach, was die VPN-Funktion auf dem Router benötigt: kmod-tun, ip-full, bash, iptables-nft und ip6tables-nft. Routing und Firewall-Verhalten hängen von Ihrer Firmware und Ihren eigenen Firewall-Regeln ab, testen Sie das VPN daher auf Ihrem Gerät, bevor Sie sich darauf verlassen. Zur Funktion selbst siehe VPN-Manager.
Fehlerbehebung #
Der Paketmanager lehnt das Paket wegen der Architektur ab
Das Paket wurde für eine andere Architektur gebaut als Ihre Firmware. Vergleichen Sie die Ausgabe von opkg print-architecture oder apk --print-arch mit der Architektur, die in der Anleitungsdatei des Pakets genannt wird (Anleitung zur Paketeinrichtung auf der Seite Downloads). Erzwingen Sie die Installation nicht. MIPS-, MIPSEL- und ARMv7-Router werden nicht unterstützt.
apk lehnt die Datei als nicht vertrauenswürdig ab
Die APK-Pakete sind unsignierte lokale Dateien. Ihre Installation erfordert die Option --allow-untrusted, wie in der Einrichtungsanleitung des Pakets gezeigt.
Die Installation schlägt fehl, weil eine Abhängigkeit nicht gefunden wird
Aktualisieren Sie zuerst die Paketlisten (opkg update oder apk update) und stellen Sie sicher, dass der Router Internetzugang hat. Die Abhängigkeiten stammen aus den eigenen Feeds Ihrer Firmware.
Der Dienst ist aktiviert, aber im Protokoll erscheint nichts
Prüfen Sie uci show localtonet. Steht enabled noch auf 0, setzen Sie es auf 1, übernehmen Sie die Änderung (commit) und starten Sie den Dienst neu. Zeigt das Protokoll AuthToken file missing, tragen Sie Ihr Token in die Datei ein, die token_file nennt.
Der Client startet nicht oder dem Router geht der Arbeitsspeicher aus
Prüfen Sie den freien Flash-Speicher und den Arbeitsspeicher mit df -h und free. Der Client braucht Platz unter /usr/lib/localtonet und in /tmp.
Verwandte Seiten #
OpenWrt
Experimentell. Wählen Sie IPK für OpenWrt 24.10 oder APK v3 für 25.12+. Diese APK-Dateien sind OpenWrt-Pakete, keine Android-Apps.
Nur x64 und ARM64. Die Paketarchitektur muss zu Ihrer Firmware passen; prüfen Sie die Einrichtungsanleitung des Pakets sowie opkg print-architecture oder apk --print-arch. MIPS, MIPSEL und ARMv7 werden von diesen Paketen nicht unterstützt. Prüfen Sie vor der Installation freien Speicher und RAM.
-
OpenWrt 24.10 · x64 · IPK
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-openwrt-24.10-x64.ipk.Führen Sie diese Befehle auf dem Router als root aus. Stellen Sie vor der Installation sicher, dass die Paketarchitektur zu Ihrer Firmware passt.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-x64.ipk2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetFür ein Upgrade installieren Sie das neue Paket und führen
/etc/init.d/localtonet restartaus. Ihre Konfiguration bleibt erhalten. -
OpenWrt 24.10 · ARM64 · IPK
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-openwrt-24.10-arm64.ipk.Führen Sie diese Befehle auf dem Router als root aus. Stellen Sie vor der Installation sicher, dass die Paketarchitektur zu Ihrer Firmware passt.
opkg print-architecture opkg update opkg install ./localtonet-openwrt-24.10-arm64.ipk2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetFür ein Upgrade installieren Sie das neue Paket und führen
/etc/init.d/localtonet restartaus. Ihre Konfiguration bleibt erhalten. -
OpenWrt 25.12+ · x64 · APK v3
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-openwrt-25.12-x64.apk.Führen Sie diese Befehle auf dem Router als root aus. Stellen Sie vor der Installation sicher, dass die Paketarchitektur zu Ihrer Firmware passt.
Dieses lokale APK-Paket ist unsigniert, daher erfordert die Installation
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetFür ein Upgrade installieren Sie das neue Paket und führen
/etc/init.d/localtonet restartaus. Ihre Konfiguration bleibt erhalten. -
OpenWrt 25.12+ · ARM64 · APK v3
Einrichtungsanleitung
1. Heruntergeladenes Paket installieren. Öffnen Sie ein Terminal im Verzeichnis mit
localtonet-openwrt-25.12-arm64.apk.Führen Sie diese Befehle auf dem Router als root aus. Stellen Sie vor der Installation sicher, dass die Paketarchitektur zu Ihrer Firmware passt.
Dieses lokale APK-Paket ist unsigniert, daher erfordert die Installation
--allow-untrusted.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. AuthToken festlegen. Bearbeiten Sie
/etc/localtonet/auth-tokenals root und ersetzen SieDUMMY_AUTH_TOKENdurch Ihren Token in einer einzigen Zeile. Schützen Sie dann die Datei und prüfen Sie die Konfiguration:chmod 600 /etc/localtonet/auth-token localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config3. Dienst starten. Sobald die Konfigurationsprüfung erfolgreich ist:
uci set localtonet.main.enabled='1' uci commit localtonet /etc/init.d/localtonet enable /etc/init.d/localtonet restart logread -e localtonetFür ein Upgrade installieren Sie das neue Paket und führen
/etc/init.d/localtonet restartaus. Ihre Konfiguration bleibt erhalten.
Lesen Sie vor der Installation die Einrichtungsanleitung für Ihr Paket. Die Pakete sind unsigniert; Firmware-Kompatibilität, Tunnel und VPN müssen auf dem vorgesehenen Gerät geprüft werden. Erzwingen Sie niemals eine nicht passende Architektur.