Localtonet installeren op OpenWrt
Experimenteel OpenWrt 24.10 en 25.12+ x64 en ARM64
Op deze pagina 12 secties
- Voordat je begint
- Ondersteunde versies en architecturen
- Wat niet wordt ondersteund
- Controleer de architectuur
- OpenWrt 24.10 (opkg)
- Opslag en geheugen
- Wat het pakket installeert
- Tokenbestand en configuratie
- Het tokenbestand
- De UCI-configuratie
- De service
- Logboeken
- Upgraden en verwijderen
- OpenWrt 24.10 (opkg)
- VPN op OpenWrt
- Probleemoplossing
- 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-versie | Pakketindeling | Pakketbeheerder | Architecturen |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 en later | APK v3 | apk | x64, 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 updateofapk 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) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archEen 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:
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/tmpin het RAM, dus deze ruimte gaat ten koste van het geheugen van de router.
Wat het pakket installeert #
| Pad | Wat het is |
|---|---|
/usr/bin/localtonet | De opdracht localtonet. |
/usr/lib/localtonet | De programmabestanden. |
/etc/localtonet/auth-token | Het tokenbestand. Het bevat de plaatsaanduiding DUMMY_AUTH_TOKEN totdat je die vervangt. Alleen leesbaar voor root. |
/etc/config/localtonet | De UCI-configuratie van de service. |
/etc/init.d/localtonet | Het 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:
| Uitvoer | Betekenis |
|---|---|
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:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Optie | Wat het doet | Waarden |
|---|---|---|
enabled | Of de service de client start. Zolang het 0 is, doet het starten van de service niets. | 0 (standaard) of 1 |
token_file | Pad van het bestand waaruit de client de token leest. | Standaard /etc/localtonet/auth-token |
Toon op elk moment de huidige waarden:
uci show localtonetDe 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.
| Opdracht | Wat het doet |
|---|---|
/etc/init.d/localtonet restart | Stopt en start de client. Voer dit uit nadat je het tokenbestand of de configuratie hebt gewijzigd. |
/etc/init.d/localtonet stop | Stopt de client tot de volgende herstart of reboot. |
/etc/init.d/localtonet disable | Stopt met het starten van de service bij het opstarten. |
/etc/init.d/localtonet enable | Start de service weer bij het opstarten. |
Om de client uit te zetten maar het pakket geïnstalleerd te laten:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartAls 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:
logread -e localtonet
logread -f -e localtonet| Regel | Betekenis |
|---|---|
Localtonet - headless log | De 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 missing | De 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) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetHet 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.
Gerelateerde pagina's #
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.ipk2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. 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 localtonetOm te upgraden installeer je het nieuwe pakket en voer je
/etc/init.d/localtonet restartuit. 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.ipk2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. 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 localtonetOm te upgraden installeer je het nieuwe pakket en voer je
/etc/init.d/localtonet restartuit. 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-untrustednodig.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-x64.apk2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. 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 localtonetOm te upgraden installeer je het nieuwe pakket en voer je
/etc/init.d/localtonet restartuit. 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-untrustednodig.apk --print-arch apk update apk add --allow-untrusted ./localtonet-openwrt-25.12-arm64.apk2. Stel je AuthToken in. Bewerk
/etc/localtonet/auth-tokenals root en vervangDUMMY_AUTH_TOKENdoor 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-config3. 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 localtonetOm te upgraden installeer je het nieuwe pakket en voer je
/etc/init.d/localtonet restartuit. 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.