Instalar a Localtonet no OpenWrt
Experimental OpenWrt 24.10 e 25.12+ x64 e ARM64
Nesta página 12 seções
- Antes de começar
- Versões e arquiteturas compatíveis
- O que não é compatível
- Verifique a arquitetura
- OpenWrt 24.10 (opkg)
- Armazenamento e memória
- O que o pacote instala
- Arquivo de token e configuração
- O arquivo de token
- A configuração UCI
- O serviço
- Logs
- Atualizar e remover
- OpenWrt 24.10 (opkg)
- VPN no OpenWrt
- Solução de problemas
- 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 OpenWrt | Formato do pacote | Gerenciador de pacotes | Arquiteturas |
|---|---|---|---|
| 24.10 | IPK | opkg | x64, ARM64 |
| 25.12 e posteriores | APK v3 | apk | x64, 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 updateouapk 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) #
opkg print-architectureOpenWrt 25.12+ (apk)
apk --print-archUm 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:
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/tmpfica na RAM, então esse espaço sai da memória do roteador.
O que o pacote instala #
| Caminho | O que é |
|---|---|
/usr/bin/localtonet | O comando localtonet. |
/usr/lib/localtonet | Os arquivos do programa. |
/etc/localtonet/auth-token | O arquivo de token. Ele contém o marcador DUMMY_AUTH_TOKEN até você substituí-lo. Legível somente pelo root. |
/etc/config/localtonet | A configuração UCI do serviço. |
/etc/init.d/localtonet | O 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ída | Significado |
|---|---|
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:
config localtonet 'main'
option enabled '0'
option token_file '/etc/localtonet/auth-token'| Opção | O que faz | Valores |
|---|---|---|
enabled | Se o serviço inicia o cliente. Enquanto for 0, iniciar o serviço não faz nada. | 0 (padrão) ou 1 |
token_file | Caminho do arquivo de onde o cliente lê o token. | Padrão /etc/localtonet/auth-token |
Mostre os valores atuais a qualquer momento:
uci show localtonetO 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.
| Comando | O que faz |
|---|---|
/etc/init.d/localtonet restart | Para e inicia o cliente. Execute depois de alterar o arquivo de token ou a configuração. |
/etc/init.d/localtonet stop | Para o cliente até a próxima reinicialização ou o próximo boot. |
/etc/init.d/localtonet disable | Deixa de iniciar o serviço no boot. |
/etc/init.d/localtonet enable | Volta a iniciar o serviço no boot. |
Para desligar o cliente mas manter o pacote instalado:
uci set localtonet.main.enabled='0'
uci commit localtonet
/etc/init.d/localtonet restartSe 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:
logread -e localtonet
logread -f -e localtonet| Linha | Significado |
|---|---|
Localtonet - headless log | O 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 missing | O 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) #
opkg remove localtonetOpenWrt 25.12+ (apk)
apk del localtonetRemover 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.
Páginas relacionadas #
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.ipk2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. 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 localtonetPara 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.ipk2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. 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 localtonetPara 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.apk2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. 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 localtonetPara 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.apk2. Defina seu AuthToken. Edite
/etc/localtonet/auth-tokencomo root e substituaDUMMY_AUTH_TOKENpelo 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-config3. 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 localtonetPara 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.