Aller au contenu
Localtonet Localtonet Tableau de bord

Installer Localtonet sur OpenWrt

Expérimental OpenWrt 24.10 et 25.12+ x64 et ARM64

Aide pour cette page
Sur cette page 12 sections
  1. Avant de commencer
  2. Versions et architectures prises en charge
  3. Ce qui n'est pas pris en charge
  4. Vérifier l'architecture
  5. OpenWrt 24.10 (opkg)
  6. Stockage et mémoire
  7. Ce que le paquet installe
  8. Fichier de jeton et configuration
  9. Le fichier de jeton
  10. La configuration UCI
  11. Le service
  12. Journaux
  13. Mettre à niveau et supprimer
  14. OpenWrt 24.10 (opkg)
  15. VPN sur OpenWrt
  16. Dépannage
  17. Pages associées

Exécutez le client Localtonet directement sur un routeur OpenWrt. Le paquet installe le client, un fichier de jeton, une configuration UCI et un service qui démarre avec le routeur.

Les paquets OpenWrt sont expérimentaux. Ce sont des fichiers non signés que vous installez à la main, et non des paquets d'un dépôt OpenWrt signé. Vérifiez la compatibilité du firmware, vos tunnels et le VPN sur votre propre appareil avant de vous y fier.

Avant de commencer #

  • Un routeur doté d'une version d'OpenWrt et d'une architecture de processeur pris en charge (voir la section suivante).
  • Un accès root au routeur via SSH.
  • Un accès à internet sur le routeur pendant l'installation. Le gestionnaire de paquets télécharge les dépendances depuis les dépôts de paquets de votre firmware.
  • Assez d'espace de stockage libre et de mémoire (voir Stockage et mémoire).
  • Un AuthToken de Mes jetons qu'aucun autre appareil n'utilise.

Versions et architectures prises en charge #

OpenWrt a changé de gestionnaire de paquets d'une version à l'autre, il existe donc deux formats de paquet. Choisissez celui de votre firmware :

Version d'OpenWrtFormat de paquetGestionnaire de paquetsArchitectures
24.10IPKopkgx64, ARM64
25.12 et ultérieuresAPK v3apkx64, ARM64

Ici, APK désigne un paquet OpenWrt. Ces fichiers .apk ne sont pas des applications Android et ne peuvent pas être installés sur un téléphone. Pour Android, voir Android.

Ce qui n'est pas pris en charge #

  • Les routeurs MIPS, MIPSEL et ARMv7. Il n'existe pas de paquets pour ces architectures.
  • L'installation depuis un dépôt de paquets. Les paquets sont des fichiers locaux ; votre routeur ne les trouve ni ne les met à jour avec opkg update ou apk update.
  • Forcer un paquet sur une autre architecture. Ne contournez jamais la vérification d'architecture du gestionnaire de paquets.

Vérifier l'architecture #

L'architecture du paquet doit correspondre à votre firmware. Demandez au routeur quelles architectures il accepte :

OpenWrt 24.10 (opkg) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

Un routeur x64 indique x86_64. Les routeurs ARM64 indiquent un nom qui commence par aarch64_, et ce nom diffère d'une version de firmware à l'autre. Chaque paquet est accompagné d'un court fichier d'instructions qui précise l'architecture exacte pour laquelle il a été construit, par exemple x86_64 ou aarch64_generic. Sur la page Téléchargements, choisissez votre paquet sous OpenWrt et ouvrez Instructions d'installation du paquet pour le lire. Comparez cette architecture à celle indiquée par votre routeur. Si elles ne correspondent pas, n'installez pas le paquet.

Stockage et mémoire #

Le paquet contient le client avec son propre runtime : il est donc bien plus volumineux qu'un paquet OpenWrt classique. Vérifiez le routeur avant d'installer :

Bash
df -h
free
  • Flash (overlay). Les fichiers du programme sont installés sous /usr/lib/localtonet. Un routeur avec une petite puce flash peut nécessiter extroot (stockage externe comme overlay racine) pour les accueillir.
  • RAM et /tmp. Au démarrage, le client décompresse ses bibliothèques natives dans /tmp/localtonet/bundle. Sous OpenWrt, /tmp est conservé en RAM : cet espace est donc pris sur la mémoire du routeur.

Ce que le paquet installe #

CheminDescription
/usr/bin/localtonetLa commande localtonet.
/usr/lib/localtonetLes fichiers du programme.
/etc/localtonet/auth-tokenLe fichier de jeton. Il contient l'espace réservé DUMMY_AUTH_TOKEN tant que vous ne l'avez pas remplacé. Lisible par root uniquement.
/etc/config/localtonetLa configuration UCI du service.
/etc/init.d/localtonetLe script du service (procd).

Le paquet dépend de libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft et ip6tables-nft. Le gestionnaire de paquets installe celles qui manquent depuis les dépôts de votre firmware, c'est pourquoi les instructions d'installation actualisent d'abord les listes de paquets. kmod-tun doit correspondre au noyau du firmware installé : prenez-le donc toujours dans les dépôts de ce firmware.

Fichier de jeton et configuration #

L'installation du paquet ne connecte rien. Le service reste désactivé tant que vous n'avez pas fait deux choses : placer votre jeton dans le fichier de jeton et activer le service dans UCI. Les commandes exactes pour votre paquet figurent dans ses Instructions d'installation, à la fin de cette page ; cette section explique ce qu'elles font.

Le fichier de jeton #

/etc/localtonet/auth-token contient votre AuthToken sur une seule ligne, et rien d'autre. Remplacez l'espace réservé DUMMY_AUTH_TOKEN par votre jeton, par exemple avec vi. Gardez le fichier lisible par root uniquement (mode 600).

Les instructions d'installation exécutent ensuite le client une fois avec --headless --authtoken-file /etc/localtonet/auth-token --check-config. Cela vérifie le fichier sans se connecter à Localtonet :

SortieSignification
Localtonet headless configuration OK.Le fichier contient un jeton bien formé : 33 caractères, sans espaces. La vérification ne prouve pas que le jeton est valide pour votre compte.
Invalid Localtonet headless configuration. Check the token file or environment settings.Le fichier est absent, contient encore l'espace réservé, ou le jeton ne compte pas 33 caractères.

La configuration UCI #

Le service lit ses paramètres dans /etc/config/localtonet. Une installation neuve contient :

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
OptionFonctionValeurs
enabledIndique si le service démarre le client. Tant que la valeur est 0, démarrer le service ne fait rien.0 (par défaut) ou 1
token_fileChemin du fichier dans lequel le client lit le jeton.Par défaut /etc/localtonet/auth-token

Affichez les valeurs actuelles à tout moment :

Bash
uci show localtonet

Le service #

Le client s'exécute comme un service procd nommé localtonet. L'installation du paquet l'enregistre pour démarrer au boot, mais il ne lance le client que lorsque enabled vaut 1 et que le fichier de jeton n'est pas vide. Une fois enabled mis à 1 et la modification validée, redémarrez le service une fois ; ensuite, il démarre avec le routeur.

CommandeFonction
/etc/init.d/localtonet restartArrête puis démarre le client. Exécutez-la après avoir modifié le fichier de jeton ou la configuration.
/etc/init.d/localtonet stopArrête le client jusqu'au prochain redémarrage.
/etc/init.d/localtonet disableCesse de démarrer le service au boot.
/etc/init.d/localtonet enableRedémarre de nouveau le service au boot.

Pour désactiver le client tout en gardant le paquet installé :

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

Si le client s'arrête de façon inattendue, procd le relance.

Une fois le client connecté, créez et démarrez des tunnels dans le tableau de bord avec le jeton du routeur. L'Adresse IP locale d'un tunnel peut être 127.0.0.1 pour un service sur le routeur lui-même, ou l'adresse LAN de n'importe quel appareil derrière le routeur, par exemple 192.168.1.20.

Journaux #

Le client écrit dans le journal système d'OpenWrt. Affichez ses lignes, ou suivez-les en direct :

Bash
logread -e localtonet
logread -f -e localtonet
LigneSignification
Localtonet - headless logLe client a démarré.
Connection: …L'état de la connexion à Localtonet.
AuthTokenName: …Le nom du jeton avec lequel le routeur s'est connecté.
OPEN …, ADDED …, STATUS …, CLOSED …Un tunnel de ce jeton a été trouvé, ajouté, a changé d'état ou a été supprimé.
Authentication failed: AuthToken was rejected.Localtonet n'a pas accepté le jeton du fichier de jeton.
AuthToken file missingLe service est activé, mais le fichier de jeton n'existe pas ou est vide.

Mettre à niveau et supprimer #

Pour mettre à niveau, installez le paquet plus récent par-dessus l'ancien et redémarrez le service. Le fichier de jeton et la configuration UCI sont conservés. Ces deux fichiers figurent aussi dans la liste des fichiers qu'OpenWrt conserve lors d'une mise à niveau du firmware, mais le paquet lui-même doit être réinstallé après avoir flashé un nouveau firmware.

Pour supprimer le client :

OpenWrt 24.10 (opkg) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

La suppression du paquet arrête le service et le retire de la séquence de démarrage.

VPN sur OpenWrt #

Le paquet installe ce dont la fonction VPN a besoin sur le routeur : kmod-tun, ip-full, bash, iptables-nft et ip6tables-nft. Le routage et le comportement du pare-feu dépendent de votre firmware et de vos propres règles de pare-feu : testez donc le VPN sur votre appareil avant de vous y fier. Pour la fonction elle-même, voir Gestionnaire VPN.

Dépannage #

Le gestionnaire de paquets refuse le paquet à cause de son architecture

Le paquet a été construit pour une autre architecture que celle de votre firmware. Comparez la sortie de opkg print-architecture ou apk --print-arch avec l'architecture indiquée dans le fichier d'instructions du paquet (Instructions d'installation du paquet sur la page Téléchargements). Ne forcez pas l'installation. Les routeurs MIPS, MIPSEL et ARMv7 ne sont pas pris en charge.

apk refuse d'installer le fichier car il n'est pas approuvé

Les paquets APK sont des fichiers locaux non signés. Pour en installer un, il faut l'option --allow-untrusted, comme l'indiquent les instructions d'installation du paquet.

L'installation échoue car une dépendance est introuvable

Actualisez d'abord les listes de paquets (opkg update ou apk update) et assurez-vous que le routeur a accès à internet. Les dépendances proviennent des dépôts de votre firmware.

Le service est activé mais rien n'apparaît dans le journal

Vérifiez uci show localtonet. Si enabled vaut encore 0, mettez-le à 1, validez et redémarrez le service. Si le journal affiche AuthToken file missing, placez votre jeton dans le fichier indiqué par token_file.

Le client ne démarre pas ou le routeur manque de mémoire

Vérifiez l'espace flash libre et la mémoire avec df -h et free. Le client a besoin de place sous /usr/lib/localtonet et dans /tmp.

OpenWrt

Expérimental. Choisissez IPK pour OpenWrt 24.10 ou APK v3 pour 25.12+. Ces fichiers APK sont des paquets OpenWrt, pas des applications Android.

x64 et ARM64 uniquement. L'architecture du paquet doit correspondre à votre firmware ; consultez les instructions d'installation du paquet et opkg print-architecture ou apk --print-arch. MIPS, MIPSEL et ARMv7 ne sont pas pris en charge par ces paquets. Vérifiez l'espace de stockage et la RAM disponibles avant l'installation.

  • OpenWrt 24.10 · x64 · IPK
    Instructions d'installation

    1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant localtonet-openwrt-24.10-x64.ipk.

    Exécutez ces commandes sur le routeur en tant que root. Vérifiez que l'architecture du paquet correspond à votre firmware avant l'installation.

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

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :

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

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

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

    Pour mettre à jour, installez le nouveau paquet et exécutez /etc/init.d/localtonet restart. Votre configuration est conservée.

  • OpenWrt 24.10 · ARM64 · IPK
    Instructions d'installation

    1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant localtonet-openwrt-24.10-arm64.ipk.

    Exécutez ces commandes sur le routeur en tant que root. Vérifiez que l'architecture du paquet correspond à votre firmware avant l'installation.

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

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :

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

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

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

    Pour mettre à jour, installez le nouveau paquet et exécutez /etc/init.d/localtonet restart. Votre configuration est conservée.

  • OpenWrt 25.12+ · x64 · APK v3
    Instructions d'installation

    1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant localtonet-openwrt-25.12-x64.apk.

    Exécutez ces commandes sur le routeur en tant que root. Vérifiez que l'architecture du paquet correspond à votre firmware avant l'installation.

    Ce paquet APK local n'est pas signé : l'installation nécessite donc --allow-untrusted.

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

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :

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

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

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

    Pour mettre à jour, installez le nouveau paquet et exécutez /etc/init.d/localtonet restart. Votre configuration est conservée.

  • OpenWrt 25.12+ · ARM64 · APK v3
    Instructions d'installation

    1. Installez le paquet téléchargé. Ouvrez un terminal dans le dossier contenant localtonet-openwrt-25.12-arm64.apk.

    Exécutez ces commandes sur le routeur en tant que root. Vérifiez que l'architecture du paquet correspond à votre firmware avant l'installation.

    Ce paquet APK local n'est pas signé : l'installation nécessite donc --allow-untrusted.

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

    2. Définissez votre AuthToken. Modifiez /etc/localtonet/auth-token en tant que root et remplacez DUMMY_AUTH_TOKEN par votre jeton sur une seule ligne. Protégez ensuite le fichier et vérifiez la configuration :

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

    3. Démarrez le service. Une fois la vérification de la configuration réussie :

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

    Pour mettre à jour, installez le nouveau paquet et exécutez /etc/init.d/localtonet restart. Votre configuration est conservée.

Lisez les instructions d'installation de votre paquet avant de l'installer. Les paquets ne sont pas signés ; la compatibilité du firmware, les tunnels et le VPN doivent être validés sur l'appareil cible. Ne forcez jamais une architecture qui ne correspond pas.

Support