Zum Inhalt springen
Localtonet Localtonet Dashboard

Localtonet unter OpenWrt installieren

Experimentell OpenWrt 24.10 und 25.12+ x64 und ARM64

Hilfe zu dieser Seite
Auf dieser Seite 12 Abschnitte
  1. Bevor Sie beginnen
  2. Unterstützte Versionen und Architekturen
  3. Was nicht unterstützt wird
  4. Die Architektur prüfen
  5. OpenWrt 24.10 (opkg)
  6. Speicher und Arbeitsspeicher
  7. Was das Paket installiert
  8. Token-Datei und Konfiguration
  9. Die Token-Datei
  10. Die UCI-Konfiguration
  11. Der Dienst
  12. Protokolle
  13. Aktualisieren und entfernen
  14. OpenWrt 24.10 (opkg)
  15. VPN unter OpenWrt
  16. Fehlerbehebung
  17. 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-VersionPaketformatPaketmanagerArchitekturen
24.10IPKopkgx64, ARM64
25.12 und neuerAPK v3apkx64, 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 update oder apk 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) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

Ein 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:

Bash
df -h
free
  • Flash (Overlay). Die Programmdateien werden unter /usr/lib/localtonet installiert. 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 /tmp im RAM, daher geht dieser Platz vom Arbeitsspeicher des Routers ab.

Was das Paket installiert #

PfadWas es ist
/usr/bin/localtonetDer Befehl localtonet.
/usr/lib/localtonetDie Programmdateien.
/etc/localtonet/auth-tokenDie Token-Datei. Sie enthält den Platzhalter DUMMY_AUTH_TOKEN, bis Sie ihn ersetzen. Nur für root lesbar.
/etc/config/localtonetDie UCI-Konfiguration des Dienstes.
/etc/init.d/localtonetDas 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:

AusgabeBedeutung
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:

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
OptionFunktionWerte
enabledOb der Dienst den Client startet. Solange sie 0 ist, bewirkt das Starten des Dienstes nichts.0 (Standard) oder 1
token_filePfad der Datei, aus der der Client das Token liest.Standard /etc/localtonet/auth-token

Die aktuellen Werte zeigen Sie jederzeit so an:

Bash
uci show localtonet

Der 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.

BefehlFunktion
/etc/init.d/localtonet restartStoppt und startet den Client. Führen Sie ihn aus, nachdem Sie die Token-Datei oder die Konfiguration geändert haben.
/etc/init.d/localtonet stopStoppt den Client bis zum nächsten Neustart oder Reboot.
/etc/init.d/localtonet disableDer Dienst startet nicht mehr beim Booten.
/etc/init.d/localtonet enableDer Dienst startet wieder beim Booten.

So schalten Sie den Client aus, behalten das Paket aber installiert:

Bash
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restart

Beendet 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:

Bash
logread -e localtonet
logread -f -e localtonet
ZeileBedeutung
Localtonet - headless logDer 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 missingDer 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) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

Das 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.

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.ipk

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. 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 localtonet

    Für ein Upgrade installieren Sie das neue Paket und führen /etc/init.d/localtonet restart aus. 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.ipk

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. 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 localtonet

    Für ein Upgrade installieren Sie das neue Paket und führen /etc/init.d/localtonet restart aus. 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.apk

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. 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 localtonet

    Für ein Upgrade installieren Sie das neue Paket und führen /etc/init.d/localtonet restart aus. 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.apk

    2. AuthToken festlegen. Bearbeiten Sie /etc/localtonet/auth-token als root und ersetzen Sie DUMMY_AUTH_TOKEN durch 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-config

    3. 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 localtonet

    Für ein Upgrade installieren Sie das neue Paket und führen /etc/init.d/localtonet restart aus. 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.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support