Ir para o conteúdo
Localtonet Localtonet Painel

Instalar a Localtonet no OpenWrt

Experimental OpenWrt 24.10 e 25.12+ x64 e ARM64

Ajuda com esta página
Nesta página 12 seções
  1. Antes de começar
  2. Versões e arquiteturas compatíveis
  3. O que não é compatível
  4. Verifique a arquitetura
  5. OpenWrt 24.10 (opkg)
  6. Armazenamento e memória
  7. O que o pacote instala
  8. Arquivo de token e configuração
  9. O arquivo de token
  10. A configuração UCI
  11. O serviço
  12. Logs
  13. Atualizar e remover
  14. OpenWrt 24.10 (opkg)
  15. VPN no OpenWrt
  16. Solução de problemas
  17. Páginas relacionadas

Execute o cliente Localtonet diretamente em um roteador OpenWrt. O pacote instala o cliente, um arquivo de token, uma configuração UCI e um serviço que inicia junto com o roteador.

Os pacotes do OpenWrt são experimentais. São arquivos não assinados que você instala manualmente, não pacotes de um feed assinado do OpenWrt. Verifique a compatibilidade do firmware, os seus túneis e a VPN no seu próprio dispositivo antes de depender deles.

Antes de começar #

  • Um roteador com uma versão do OpenWrt e uma arquitetura de CPU compatíveis (veja a próxima seção).
  • Acesso root ao roteador por SSH.
  • Acesso à internet no roteador durante a instalação. O gerenciador de pacotes baixa as dependências dos feeds de pacotes do próprio firmware.
  • Armazenamento e memória livres suficientes (veja Armazenamento e memória).
  • Um AuthToken de Meus tokens que nenhum outro dispositivo use.

Versões e arquiteturas compatíveis #

O OpenWrt mudou de gerenciador de pacotes entre versões, então há dois formatos de pacote. Escolha o do seu firmware:

Versão do OpenWrtFormato do pacoteGerenciador de pacotesArquiteturas
24.10IPKopkgx64, ARM64
25.12 e posterioresAPK v3apkx64, ARM64

Aqui, APK significa um pacote do OpenWrt. Esses arquivos .apk não são apps Android e não podem ser instalados em um celular. Para Android, veja Android.

O que não é compatível #

  • Roteadores MIPS, MIPSEL e ARMv7. Não há pacotes para essas arquiteturas.
  • Instalar a partir de um feed de pacotes. Os pacotes são arquivos locais; seu roteador não os encontra nem os atualiza por opkg update ou apk update.
  • Forçar um pacote em uma arquitetura diferente. Nunca ignore a verificação de arquitetura do gerenciador de pacotes.

Verifique a arquitetura #

A arquitetura do pacote precisa corresponder ao seu firmware. Pergunte ao roteador quais arquiteturas ele aceita:

OpenWrt 24.10 (opkg) #

Bash
opkg print-architecture

OpenWrt 25.12+ (apk)

Bash
apk --print-arch

Um roteador x64 informa x86_64. Roteadores ARM64 informam um nome que começa com aarch64_, e esse nome varia entre as compilações do firmware. Cada pacote vem com um pequeno arquivo de instruções que indica a arquitetura exata para a qual foi compilado, por exemplo x86_64 ou aarch64_generic. Na página Downloads, escolha o seu pacote em OpenWrt e abra Instruções de configuração do pacote para ler. Compare essa arquitetura com a que o seu roteador informa. Se não corresponderem, não instale o pacote.

Armazenamento e memória #

O pacote contém o cliente junto com o próprio runtime, então é muito maior que um pacote típico do OpenWrt. Verifique o roteador antes de instalar:

Bash
df -h
free
  • Flash (overlay). Os arquivos do programa são instalados em /usr/lib/localtonet. Um roteador com um chip flash pequeno pode precisar de extroot (armazenamento externo como overlay raiz) para caber.
  • RAM e /tmp. Quando o cliente inicia, ele descompacta suas bibliotecas nativas em /tmp/localtonet/bundle. No OpenWrt, o /tmp fica na RAM, então esse espaço sai da memória do roteador.

O que o pacote instala #

CaminhoO que é
/usr/bin/localtonetO comando localtonet.
/usr/lib/localtonetOs arquivos do programa.
/etc/localtonet/auth-tokenO arquivo de token. Ele contém o marcador DUMMY_AUTH_TOKEN até você substituí-lo. Legível somente pelo root.
/etc/config/localtonetA configuração UCI do serviço.
/etc/init.d/localtonetO script do serviço (procd).

O pacote depende de libc, libgcc1, libstdcpp6, libopenssl3, zlib, ca-bundle, kmod-tun, ip-full, bash, iptables-nft e ip6tables-nft. O gerenciador de pacotes instala os que faltam a partir dos feeds do seu firmware, e é por isso que as instruções de configuração atualizam primeiro as listas de pacotes. O kmod-tun precisa corresponder ao kernel do firmware instalado, então obtenha-o sempre dos feeds desse firmware.

Arquivo de token e configuração #

Instalar o pacote não conecta nada. O serviço permanece desligado até você fazer duas coisas: colocar o seu token no arquivo de token e ativar o serviço no UCI. Os comandos exatos para o seu pacote estão nas Instruções de configuração dele, no fim desta página; esta seção explica o que eles fazem.

O arquivo de token #

/etc/localtonet/auth-token guarda o seu AuthToken em uma única linha e nada mais. Substitua o marcador DUMMY_AUTH_TOKEN pelo seu token, por exemplo com o vi. Mantenha o arquivo legível somente pelo root (modo 600).

As instruções de configuração então executam o cliente uma vez com --headless --authtoken-file /etc/localtonet/auth-token --check-config. Isso verifica o arquivo sem se conectar à Localtonet:

SaídaSignificado
Localtonet headless configuration OK.O arquivo contém um token bem formado: 33 caracteres, sem espaços. A verificação não prova que o token é válido para a sua conta.
Invalid Localtonet headless configuration. Check the token file or environment settings.O arquivo não existe, ainda contém o marcador ou o token não tem 33 caracteres.

A configuração UCI #

O serviço lê as configurações de /etc/config/localtonet. Uma instalação nova contém:

/etc/config/localtonet
config localtonet 'main'
    option enabled '0'
    option token_file '/etc/localtonet/auth-token'
OpçãoO que fazValores
enabledSe o serviço inicia o cliente. Enquanto for 0, iniciar o serviço não faz nada.0 (padrão) ou 1
token_fileCaminho do arquivo de onde o cliente lê o token.Padrão /etc/localtonet/auth-token

Mostre os valores atuais a qualquer momento:

Bash
uci show localtonet

O serviço #

O cliente é executado como um serviço procd chamado localtonet. Instalar o pacote o registra para iniciar no boot, mas ele só inicia o cliente quando enabled é 1 e o arquivo de token não está vazio. Depois de definir enabled como 1 e confirmar a alteração, reinicie o serviço uma vez; a partir daí ele inicia junto com o roteador.

ComandoO que faz
/etc/init.d/localtonet restartPara e inicia o cliente. Execute depois de alterar o arquivo de token ou a configuração.
/etc/init.d/localtonet stopPara o cliente até a próxima reinicialização ou o próximo boot.
/etc/init.d/localtonet disableDeixa de iniciar o serviço no boot.
/etc/init.d/localtonet enableVolta a iniciar o serviço no boot.

Para desligar o cliente mas manter o pacote instalado:

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

Se o cliente parar inesperadamente, o procd o inicia de novo.

Depois que o cliente estiver conectado, crie e inicie túneis no painel com o token do roteador. O Endereço IP local de um túnel pode ser 127.0.0.1 para um serviço no próprio roteador, ou o endereço LAN de qualquer dispositivo atrás do roteador, por exemplo 192.168.1.20.

Logs #

O cliente escreve no log do sistema do OpenWrt. Mostre as linhas dele ou acompanhe-as ao vivo:

Bash
logread -e localtonet
logread -f -e localtonet
LinhaSignificado
Localtonet - headless logO cliente foi iniciado.
Connection: …O estado da conexão com a Localtonet.
AuthTokenName: …O nome do token com o qual o roteador fez login.
OPEN …, ADDED …, STATUS …, CLOSED …Um túnel deste token foi encontrado, adicionado, mudou de status ou foi removido.
Authentication failed: AuthToken was rejected.A Localtonet não aceitou o token do arquivo de token.
AuthToken file missingO serviço está ativado, mas o arquivo de token não existe ou está vazio.

Atualizar e remover #

Para atualizar, instale o pacote mais novo sobre o antigo e reinicie o serviço. O arquivo de token e a configuração UCI são mantidos. Os dois arquivos também estão na lista de arquivos que o OpenWrt mantém durante uma atualização de firmware, mas o próprio pacote precisa ser instalado de novo depois que você gravar um firmware novo.

Para remover o cliente:

OpenWrt 24.10 (opkg) #

Bash
opkg remove localtonet

OpenWrt 25.12+ (apk)

Bash
apk del localtonet

Remover o pacote para o serviço e o retira da sequência de boot.

VPN no OpenWrt #

O pacote traz o que o recurso de VPN precisa no roteador: kmod-tun, ip-full, bash, iptables-nft e ip6tables-nft. O roteamento e o comportamento do firewall dependem do seu firmware e das suas próprias regras de firewall, então teste a VPN no seu dispositivo antes de depender dela. Veja o Gerenciador de VPN para o recurso em si.

Solução de problemas #

O gerenciador de pacotes recusa o pacote por causa da arquitetura

O pacote foi compilado para uma arquitetura diferente da do seu firmware. Compare a saída de opkg print-architecture ou apk --print-arch com a arquitetura indicada no arquivo de instruções do pacote (Instruções de configuração do pacote na página Downloads). Não force a instalação. Roteadores MIPS, MIPSEL e ARMv7 não são compatíveis.

O apk se recusa a instalar o arquivo por ser não confiável

Os pacotes APK são arquivos locais não assinados. Instalar um exige a opção --allow-untrusted, como mostrado nas instruções de configuração do pacote.

A instalação falha porque uma dependência não é encontrada

Atualize primeiro as listas de pacotes (opkg update ou apk update) e confirme que o roteador tem acesso à internet. As dependências vêm dos feeds do próprio firmware.

O serviço está ativado, mas nada aparece no log

Verifique uci show localtonet. Se enabled ainda for 0, defina como 1, confirme e reinicie o serviço. Se o log mostrar AuthToken file missing, coloque o seu token no arquivo indicado por token_file.

O cliente não inicia ou o roteador fica sem memória

Verifique o espaço livre em flash e a memória com df -h e free. O cliente precisa de espaço em /usr/lib/localtonet e em /tmp.

OpenWrt

Experimental. Escolha IPK para OpenWrt 24.10 ou APK v3 para 25.12+. Estes arquivos APK são pacotes do OpenWrt, não apps Android.

Somente x64 e ARM64. A arquitetura do pacote precisa corresponder ao seu firmware; confira as instruções de configuração do pacote e opkg print-architecture ou apk --print-arch. MIPS, MIPSEL e ARMv7 não são compatíveis com estes pacotes. Verifique o armazenamento e a RAM disponíveis antes de instalar.

  • OpenWrt 24.10 · x64 · IPK
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-openwrt-24.10-x64.ipk.

    Execute estes comandos no roteador como root. Confirme que a arquitetura do pacote corresponde ao seu firmware antes de instalar.

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

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

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

    3. Inicie o serviço. Quando a verificação da configuração passar:

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

    Para atualizar, instale o novo pacote e execute /etc/init.d/localtonet restart. Sua configuração é mantida.

  • OpenWrt 24.10 · ARM64 · IPK
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-openwrt-24.10-arm64.ipk.

    Execute estes comandos no roteador como root. Confirme que a arquitetura do pacote corresponde ao seu firmware antes de instalar.

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

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

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

    3. Inicie o serviço. Quando a verificação da configuração passar:

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

    Para atualizar, instale o novo pacote e execute /etc/init.d/localtonet restart. Sua configuração é mantida.

  • OpenWrt 25.12+ · x64 · APK v3
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-openwrt-25.12-x64.apk.

    Execute estes comandos no roteador como root. Confirme que a arquitetura do pacote corresponde ao seu firmware antes de instalar.

    Este pacote APK local não é assinado, então a instalação exige --allow-untrusted.

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

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

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

    3. Inicie o serviço. Quando a verificação da configuração passar:

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

    Para atualizar, instale o novo pacote e execute /etc/init.d/localtonet restart. Sua configuração é mantida.

  • OpenWrt 25.12+ · ARM64 · APK v3
    Instruções de configuração

    1. Instale o pacote baixado. Abra um terminal no diretório que contém localtonet-openwrt-25.12-arm64.apk.

    Execute estes comandos no roteador como root. Confirme que a arquitetura do pacote corresponde ao seu firmware antes de instalar.

    Este pacote APK local não é assinado, então a instalação exige --allow-untrusted.

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

    2. Defina seu AuthToken. Edite /etc/localtonet/auth-token como root e substitua DUMMY_AUTH_TOKEN pelo seu token em uma única linha. Depois proteja o arquivo e verifique a configuração:

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

    3. Inicie o serviço. Quando a verificação da configuração passar:

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

    Para atualizar, instale o novo pacote e execute /etc/init.d/localtonet restart. Sua configuração é mantida.

Leia as instruções de configuração do seu pacote antes de instalar. Os pacotes não são assinados; a compatibilidade do firmware, os túneis e a VPN precisam ser validados no dispositivo de destino. Nunca force uma arquitetura incompatível.

Suporte