Naar de inhoud
Localtonet Localtonet Dashboard

Localtonet installeren op OpenWrt

Experimenteel OpenWrt 24.10 en 25.12+ x64 en ARM64

Hulp bij deze pagina
Op deze pagina 12 secties
  1. Voordat je begint
  2. Ondersteunde versies en architecturen
  3. Wat niet wordt ondersteund
  4. Controleer de architectuur
  5. OpenWrt 24.10 (opkg)
  6. Opslag en geheugen
  7. Wat het pakket installeert
  8. Tokenbestand en configuratie
  9. Het tokenbestand
  10. De UCI-configuratie
  11. De service
  12. Logboeken
  13. Upgraden en verwijderen
  14. OpenWrt 24.10 (opkg)
  15. VPN op OpenWrt
  16. Probleemoplossing
  17. Gerelateerde pagina's

Draai de Localtonet-client rechtstreeks op een OpenWrt-router. Het pakket installeert de client, een tokenbestand, een UCI-configuratie en een service die met de router meestart.

De OpenWrt-pakketten zijn experimenteel. Het zijn niet-ondertekende bestanden die je handmatig installeert, geen pakketten uit een ondertekende OpenWrt-feed. Controleer de compatibiliteit met je firmware, je tunnels en de VPN op je eigen apparaat voordat je erop vertrouwt.

Voordat je begint #

  • Een router met een ondersteunde OpenWrt-versie en cpu-architectuur (zie de volgende sectie).
  • Root-toegang tot de router via SSH.
  • Internettoegang op de router tijdens de installatie. De pakketbeheerder downloadt de afhankelijkheden uit de eigen pakketfeeds van je firmware.
  • Voldoende vrije opslagruimte en geheugen (zie Opslag en geheugen).
  • Een AuthToken van Mijn tokens die geen ander apparaat gebruikt.

Ondersteunde versies en architecturen #

OpenWrt heeft zijn pakketbeheerder tussen releases gewijzigd, dus er zijn twee pakketindelingen. Kies de indeling voor jouw firmware:

OpenWrt-versiePakketindelingPakketbeheerderArchitecturen
24.10IPKopkgx64, ARM64
25.12 en laterAPK v3apkx64, ARM64

APK betekent hier een OpenWrt-pakket. Deze .apk-bestanden zijn geen Android-apps en kunnen niet op een telefoon worden geïnstalleerd. Voor Android, zie Android.

Wat niet wordt ondersteund #

  • MIPS-, MIPSEL- en ARMv7-routers. Voor deze architecturen bestaan geen pakketten.
  • Installeren vanuit een pakketfeed. De pakketten zijn lokale bestanden; je router vindt of updatet ze niet via opkg update of apk update.
  • Een pakket op een andere architectuur afdwingen. Omzeil nooit de architectuurcontrole van de pakketbeheerder.

Controleer de architectuur #

De pakketarchitectuur moet overeenkomen met je firmware. Vraag de router welke architecturen hij accepteert:

OpenWrt 24.10 (opkg) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

Een x64-router meldt x86_64. ARM64-routers melden een naam die begint met aarch64_, en die naam verschilt per firmwarebuild. Bij elk pakket hoort een kort instructiebestand dat de exacte pakketarchitectuur vermeldt waarvoor het is gebouwd, bijvoorbeeld x86_64 of aarch64_generic. Kies op de pagina Downloads je pakket onder OpenWrt en open Installatie-instructies voor het pakket om het te lezen. Vergelijk die architectuur met wat je router meldt. Komen ze niet overeen, installeer het pakket dan niet.

Opslag en geheugen #

Het pakket bevat de client samen met zijn eigen runtime, dus het is veel groter dan een gebruikelijk OpenWrt-pakket. Controleer de router voordat je installeert:

Bash
df -h
free
  • Flash (overlay). De programmabestanden worden geïnstalleerd onder /usr/lib/localtonet. Een router met een kleine flashchip heeft mogelijk extroot nodig (externe opslag als root-overlay) om ze kwijt te kunnen.
  • RAM en /tmp. Wanneer de client start, pakt hij zijn native bibliotheken uit naar /tmp/localtonet/bundle. In OpenWrt staat /tmp in het RAM, dus deze ruimte gaat ten koste van het geheugen van de router.

Wat het pakket installeert #

PadWat het is
/usr/bin/localtonetDe opdracht localtonet.
/usr/lib/localtonetDe programmabestanden.
/etc/localtonet/auth-tokenHet tokenbestand. Het bevat de plaatsaanduiding DUMMY_AUTH_TOKEN totdat je die vervangt. Alleen leesbaar voor root.
/etc/config/localtonetDe UCI-configuratie van de service.
/etc/init.d/localtonetHet servicescript (procd).

Het pakket is afhankelijk van libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft en ip6tables-nft. De pakketbeheerder installeert de ontbrekende uit de feeds van je firmware, en daarom vernieuwen de installatie-instructies eerst de pakketlijsten. kmod-tun moet passen bij de kernel van de geïnstalleerde firmware, haal hem dus altijd uit de eigen feeds van die firmware.

Tokenbestand en configuratie #

Het installeren van het pakket verbindt niets. De service blijft uit totdat je twee dingen hebt gedaan: je token in het tokenbestand zetten en de service inschakelen in UCI. De exacte opdrachten voor jouw pakket staan in de Installatie-instructies aan het einde van deze pagina; deze sectie legt uit wat ze doen.

Het tokenbestand #

/etc/localtonet/auth-token bevat je AuthToken op één regel en niets anders. Vervang de plaatsaanduiding DUMMY_AUTH_TOKEN door je token, bijvoorbeeld met vi. Houd het bestand alleen leesbaar voor root (modus 600).

De installatie-instructies voeren daarna de client één keer uit met --headless --authtoken-file /etc/localtonet/auth-token --check-config. Dit controleert het bestand zonder met Localtonet te verbinden:

UitvoerBetekenis
Localtonet headless configuration OK.Het bestand bevat een goed gevormde token: 33 tekens, geen spaties. De controle bewijst niet dat de token geldig is voor je account.
Invalid Localtonet headless configuration. Check the token file or environment settings.Het bestand ontbreekt, bevat nog de plaatsaanduiding, of de token is niet 33 tekens lang.

De UCI-configuratie #

De service leest zijn instellingen uit /etc/config/localtonet. Een verse installatie bevat:

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
OptieWat het doetWaarden
enabledOf de service de client start. Zolang het 0 is, doet het starten van de service niets.0 (standaard) of 1
token_filePad van het bestand waaruit de client de token leest.Standaard /etc/localtonet/auth-token

Toon op elk moment de huidige waarden:

Bash
uci show localtonet

De service #

De client draait als een procd-service met de naam localtonet. Het pakket registreert hem bij installatie om bij het opstarten te starten, maar hij start de client alleen als enabled 1 is en het tokenbestand niet leeg is. Nadat je enabled op 1 hebt gezet en de wijziging hebt vastgelegd, herstart je de service één keer; daarna start hij met de router mee.

OpdrachtWat het doet
/etc/init.d/localtonet restartStopt en start de client. Voer dit uit nadat je het tokenbestand of de configuratie hebt gewijzigd.
/etc/init.d/localtonet stopStopt de client tot de volgende herstart of reboot.
/etc/init.d/localtonet disableStopt met het starten van de service bij het opstarten.
/etc/init.d/localtonet enableStart de service weer bij het opstarten.

Om de client uit te zetten maar het pakket geïnstalleerd te laten:

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

Als de client onverwacht stopt, start procd hem opnieuw.

Zodra de client verbonden is, maak en start je tunnels in het dashboard met de token van de router. Het Lokaal IP-adres van een tunnel kan 127.0.0.1 zijn voor een service op de router zelf, of het LAN-adres van een apparaat achter de router, bijvoorbeeld 192.168.1.20.

Logboeken #

De client schrijft naar het OpenWrt-systeemlogboek. Toon de regels, of volg ze live:

Bash
logread -e localtonet
logread -f -e localtonet
RegelBetekenis
Localtonet - headless logDe client is gestart.
Connection: …De status van de verbinding met Localtonet.
AuthTokenName: …De naam van de token waarmee de router is ingelogd.
OPEN …, ADDED …, STATUS …, CLOSED …Een tunnel van deze token is gevonden, toegevoegd, heeft zijn status gewijzigd of is verwijderd.
Authentication failed: AuthToken was rejected.Localtonet heeft de token in het tokenbestand niet geaccepteerd.
AuthToken file missingDe service is ingeschakeld, maar het tokenbestand bestaat niet of is leeg.

Upgraden en verwijderen #

Om te upgraden installeer je het nieuwere pakket over het oude heen en herstart je de service. Het tokenbestand en de UCI-configuratie blijven behouden. Beide bestanden staan ook op de lijst met bestanden die OpenWrt bij een firmware-upgrade bewaart, maar het pakket zelf moet je opnieuw installeren nadat je nieuwe firmware hebt geflasht.

Om de client te verwijderen:

OpenWrt 24.10 (opkg) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

Het verwijderen van het pakket stopt de service en haalt hem uit de opstartvolgorde.

VPN op OpenWrt #

Het pakket haalt binnen wat de VPN-functie op de router nodig heeft: kmod-tun, ip-full, bash, iptables-nft en ip6tables-nft. Routering en firewallgedrag hangen af van je firmware en je eigen firewallregels, dus test de VPN op je apparaat voordat je ervan afhankelijk bent. Zie VPN-beheer voor de functie zelf.

Probleemoplossing #

De pakketbeheerder weigert het pakket vanwege de architectuur

Het pakket is voor een andere architectuur gebouwd dan je firmware. Vergelijk de uitvoer van opkg print-architecture of apk --print-arch met de architectuur in het instructiebestand van het pakket (Installatie-instructies voor het pakket op de pagina Downloads). Forceer de installatie niet. MIPS-, MIPSEL- en ARMv7-routers worden niet ondersteund.

apk weigert het bestand te installeren als niet-vertrouwd

De APK-pakketten zijn niet-ondertekende lokale bestanden. Voor het installeren is de optie --allow-untrusted nodig, zoals in de installatie-instructies van het pakket staat.

De installatie mislukt omdat een afhankelijkheid niet wordt gevonden

Vernieuw eerst de pakketlijsten (opkg update of apk update) en zorg dat de router internettoegang heeft. De afhankelijkheden komen uit de eigen feeds van je firmware.

De service is ingeschakeld maar er verschijnt niets in het logboek

Controleer uci show localtonet. Als enabled nog 0 is, zet je het op 1, leg je de wijziging vast en herstart je de service. Toont het logboek AuthToken file missing, zet dan je token in het bestand dat token_file aanwijst.

De client start niet of de router heeft te weinig geheugen

Controleer de vrije flashruimte en het geheugen met df -h en free. De client heeft ruimte nodig onder /usr/lib/localtonet en in /tmp.

OpenWrt

Experimenteel. Kies IPK voor OpenWrt 24.10 of APK v3 voor 25.12+. Deze APK-bestanden zijn OpenWrt-pakketten, geen Android-apps.

Alleen x64 en ARM64. De architectuur van het pakket moet bij je firmware passen; bekijk de installatie-instructies van het pakket en opkg print-architecture of apk --print-arch. MIPS, MIPSEL en ARMv7 worden door deze pakketten niet ondersteund. Controleer de beschikbare opslag en het RAM-geheugen voordat je installeert.

  • OpenWrt 24.10 · x64 · IPK
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-openwrt-24.10-x64.ipk.

    Voer deze opdrachten als root uit op de router. Controleer vóór de installatie of de architectuur van het pakket bij je firmware past.

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-x64.ipk

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Om te upgraden installeer je het nieuwe pakket en voer je /etc/init.d/localtonet restart uit. Je configuratie blijft behouden.

  • OpenWrt 24.10 · ARM64 · IPK
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-openwrt-24.10-arm64.ipk.

    Voer deze opdrachten als root uit op de router. Controleer vóór de installatie of de architectuur van het pakket bij je firmware past.

    opkg print-architecture
    opkg update
    opkg install ./localtonet-openwrt-24.10-arm64.ipk

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Om te upgraden installeer je het nieuwe pakket en voer je /etc/init.d/localtonet restart uit. Je configuratie blijft behouden.

  • OpenWrt 25.12+ · x64 · APK v3
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-openwrt-25.12-x64.apk.

    Voer deze opdrachten als root uit op de router. Controleer vóór de installatie of de architectuur van het pakket bij je firmware past.

    Dit lokale APK-pakket is niet ondertekend, dus voor de installatie is --allow-untrusted nodig.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Om te upgraden installeer je het nieuwe pakket en voer je /etc/init.d/localtonet restart uit. Je configuratie blijft behouden.

  • OpenWrt 25.12+ · ARM64 · APK v3
    Installatie-instructies

    1. Installeer het gedownloade pakket. Open een terminal in de map met localtonet-openwrt-25.12-arm64.apk.

    Voer deze opdrachten als root uit op de router. Controleer vóór de installatie of de architectuur van het pakket bij je firmware past.

    Dit lokale APK-pakket is niet ondertekend, dus voor de installatie is --allow-untrusted nodig.

    apk --print-arch
    apk update
    apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk

    2. Stel je AuthToken in. Bewerk /etc/localtonet/auth-token als root en vervang DUMMY_AUTH_TOKEN door je token op één regel. Beveilig daarna het bestand en controleer de configuratie:

    chmod 600 /etc/localtonet/auth-token
    localtonet --headless --authtoken-file /etc/localtonet/auth-token --check-config

    3. Start de service. Zodra de configuratiecontrole slaagt:

    uci set localtonet.main.enabled='1'
    uci commit localtonet
    /etc/init.d/localtonet enable
    /etc/init.d/localtonet restart
    logread -e localtonet

    Om te upgraden installeer je het nieuwe pakket en voer je /etc/init.d/localtonet restart uit. Je configuratie blijft behouden.

Lees de installatie-instructies voor je pakket voordat je installeert. De pakketten zijn niet ondertekend; firmwarecompatibiliteit, tunnels en VPN moeten op het beoogde apparaat worden gecontroleerd. Forceer nooit een niet-passende architectuur.

Support