Se você quer instalar Python3 no OpenWRT, a notícia boa é que o processo é direto e funciona bem — desde que você entenda algumas limitações do ambiente embarcado. Já rodei esse setup em roteadores com apenas 16 MB de flash e aprendi na prática que escolher os módulos certos faz toda a diferença entre um roteador rodando scripts Python e um tijolo que não inicializa mais.

O OpenWRT é um Linux compacto feito para hardware com recursos limitados: pouca RAM, pouco armazenamento e processadores ARM ou MIPS modestos. Isso significa que você não vai instalar tudo de uma vez como faria num Ubuntu — aqui cada megabyte conta. Este guia vai te mostrar exatamente quais pacotes instalar, em qual ordem, e como evitar os erros mais comuns que eu mesmo cometi nas primeiras tentativas.

Por que instalar Python3 no seu roteador OpenWRT?

Ter Python disponível no roteador abre uma porta enorme para automações que antes exigiriam um servidor separado. Estes são os seis motivos reais que me levaram a fazer isso:

Como funciona a instalação

O gerenciador de pacotes do OpenWRT é o opkg — pense nele como o apt do Debian, mas para sistemas embarcados. O fluxo é simples e tem exatamente três etapas:

1. Atualizar o índice de pacotes com opkg update O OpenWRT não mantém o índice localmente de forma permanente — ele é descartado ao reiniciar para economizar RAM. Por isso, sempre que ligar o roteador e quiser instalar algo, rode opkg update primeiro. Sem isso, o opkg vai tentar usar um índice vazio ou desatualizado e você vai levar erros de "pacote não encontrado".

2. Instalar o Python3 base e os módulos necessários O pacote python3 instala o interpretador principal. Os módulos adicionais (asyncio, sqlite3, openssl etc.) são pacotes separados — o OpenWRT divide assim para economizar espaço em dispositivos que não precisam de tudo. Você instala só o que o seu projeto realmente usa.

3. Verificar espaço e testar a instalação Antes de instalar tudo de uma vez, cheque o espaço disponível com df -h. Depois da instalação, confirme que está funcionando com python3 --version e um python3 -c "import asyncio; print('ok')" para validar os módulos.

Para quem é este tutorial

Tutorial passo a passo: instalando Python3 no OpenWRT

Passo 1 — Acesse o roteador via SSH

Antes de qualquer coisa, conecte no roteador pelo terminal. O IP padrão do OpenWRT é 192.168.1.1, mas pode variar conforme sua configuração:

Se for o primeiro acesso, o OpenWRT vai pedir para definir uma senha. Faça isso antes de tentar instalar qualquer pacote.

Passo 2 — Verifique o espaço disponível

Este é o passo que mais gente pula e se arrepende depois. O Python3 com módulos básicos ocupa entre 8 MB e 15 MB dependendo da versão. Verifique antes:

Passo 3 — Atualize o índice de pacotes

Obrigatório sempre que reiniciar o roteador. O índice é armazenado na RAM e não persiste:

Passo 4 — Instale o Python3

Este comando instala o interpretador base. A versão exata depende do feed do OpenWRT para a sua release — o OpenWRT 23.05, por exemplo, já inclui Python 3.11. Após a instalação, confirme:

Passo 5 — Instale os módulos essenciais

Cada módulo é instalado individualmente com opkg install nome-do-modulo. Abaixo estão os módulos recomendados com uma explicação real do que cada um faz:

Para instalar um módulo específico, o comando é sempre o mesmo padrão:

Se quiser instalar todos de uma vez, você pode encadear em uma única linha — mas atenção ao espaço em disco antes de fazer isso:

Passo 6 — Validando a instalação dos módulos

Após instalar, sempre teste os módulos críticos para garantir que não houve erro silencioso durante o download. Abra o interpretador e importe:

O que cada módulo realmente faz

python3-asyncio — essencial para qualquer script que faça múltiplas operações de rede simultaneamente sem travar. Se você vai monitorar vários hosts ou fazer requests HTTP assíncronos, precisa deste módulo.

python3-openssl — permite conexões SSL/TLS direto do Python. Necessário para qualquer script que consuma APIs HTTPS ou que precise de criptografia. Sem ele, o módulo nativo ssl pode não funcionar completamente no OpenWRT.

python3-sqlite3 — banco de dados embutido sem servidor. Perfeito para armazenar logs de rede, listas de dispositivos ou qualquer dado estruturado diretamente no roteador.

python3-logging — o sistema de logs do Python. Sempre incluo em scripts de produção porque facilita muito o debug de problemas que só acontecem de madrugada quando ninguém está olhando.

python3-xml — se você vai consumir APIs REST que retornam XML (ainda existem muitas) ou processar arquivos de configuração em XML, este módulo é indispensável.

python3-multiprocessing — cuidado com este em hardware embarcado. Criar processos paralelos num roteador com 128 MB de RAM é arriscado. Use asyncio em vez disso sempre que possível — você economiza memória e evita instabilidades.

Erros comuns e como resolver

Recursos e documentação oficial

Para ir além deste tutorial, estas são as fontes que uso no dia a dia para consultar compatibilidade de pacotes, changelogs e configurações avançadas: