O desenvolvedor Sjoerd Simons publicou em 15 de janeiro de 2026 o openwrt-one-debian, um projeto open source que facilita instalar e rodar um Debian completo no OpenWrt One usando NVMe. A proposta é simples: transformar um access point de hardware aberto, normalmente focado em firmware de roteador, em um Linux de propósito geral para serviços, automação, laboratório de rede e workloads leves.
Destaques
- Debian completo no NVMe: sistema inteiro com o ecossistema padrão do Debian, não apenas um userspace embarcado.
- Instalação em duas etapas: ajusta o boot no NAND (com U-Boot + recovery) e depois grava o Debian no NVMe.
- Recovery e flasher via serial: interface de flash no console serial e um Debian mínimo em RAM para depuração.
O que o openwrt-one-debian faz e o que ele não faz
O foco do repositório é tornar fácil instalar uma imagem inicial do Debian no OpenWrt One. Ele não tenta entregar uma experiência “pronta” de access point para usuário final como o OpenWrt faz.
Com isso em mente, o ganho é poder usar pacotes, serviços e workflows padrão do Debian, o que abre espaço para:
- serviços personalizados (DNS, proxy, monitoramento, automações)
- containers e stacks leves de auto-hospedagem
- ferramentas de desenvolvimento e testes
- tarefas de edge compute perto da rede
ANÁLISE: juntar hardware aberto e documentado com um Debian completo cria um “mini-servidor de borda” bem interessante para labs e redes avançadas, com liberdade para experimentar sem depender de firmwares fechados.
Por que usar NVMe em vez do NAND interno
O OpenWrt One tem 256 MiB de NAND. Dá para fazer o Debian caber, mas fica apertado e limitante no dia a dia. O diferencial do hardware é o slot M.2, que permite usar um NVMe e tornar o Debian realmente prático para uso geral.
Requisitos
- OpenWrt One
- NVMe instalado no dispositivo
- Acesso ao console serial pela porta USB-C frontal (baudrate 115200)
- Pendrive USB com uma única partição FAT ou FAT32
- Artefatos baixados do latest build (arquivos “openwrt*”) copiados para o pendrive
Como funciona a instalação
O processo tem duas partes:
- Flashing do NAND: substitui o conteúdo do NAND por um U-Boot capaz de bootar direto do NVMe e por uma recovery image (útil para flash e depuração).
- Flashing do NVMe: grava a imagem do Debian no NVMe usando a recovery e uma UI simples no console serial.
A vantagem é que você pode reutilizar o mesmo pendrive, mantendo-o em FAT/FAT32 e trocando apenas os arquivos entre as etapas.
Parte 1: gravando o NAND (U-Boot + recovery)
Arquivos necessários no pendrive
Copie para a raiz do pendrive:
openwrt-mediatek-filogic-openwrt_one-snand-preloader.binopenwrt-mediatek-filogic-openwrt_one-factory.ubi
Passo a passo do flash do NAND
- Conecte o pendrive com os arquivos acima.
- No seletor de boot traseiro, mude de NAND para NOR.
- Pressione e segure o botão na frente.
- Ligue o dispositivo na energia.
- Aguarde os LEDs frontais acenderem (os três).
- Quando apenas o LED branco ficar aceso, solte o botão.
- Espere finalizar, o LED verde indica que terminou.
- Remova a energia e volte o seletor de NOR para NAND.
Esse fluxo é intencionalmente parecido com o modo de recovery completo do próprio OpenWrt One.
Parte 2: gravando o Debian no NVMe
Arquivos necessários no pendrive
Troque os arquivos do pendrive e coloque:
- imagem do sistema (exemplo):
openwrt-one-debian-<data>.img.zst - arquivo bmap correspondente (exemplo):
openwrt-one-debian-<data>.img.bmap
Boot na recovery e flash do NVMe
- Conecte o pendrive com a imagem e o bmap.
- Ligue o dispositivo.
Durante o primeiro boot, podem aparecer mensagens “Bad EC magic”. Isso pode ser ignorado.
O comportamento do boot depende do estado do NVMe:
- se não houver OS no NVMe, o sistema tende a bootar automaticamente na recovery image
- se já houver algo no NVMe, interrompa o U-Boot e execute:
run boot_recoveryAo iniciar a recovery, uma UI de flasher aparece no console serial:
- selecione a imagem detectada no pendrive
- aguarde o flash terminar
- pressione Enter para reiniciar e bootar no Debian instalado no NVMe
Se você pressionar Ctrl+C quando o flasher aparecer, o sistema não faz o flash e segue para um login normal (getty).
Primeiro boot do Debian no NVMe
No primeiro boot, o systemd-firstboot vai solicitar configurações iniciais (como hostname, opção de root shell e senha do root). As mensagens de boot podem “encobrir” o prompt, então vale acompanhar o console com atenção.
Recovery image: Debian mínimo em RAM para depuração
A recovery incluída no NAND é um Debian mínimo rodando em memória.
- login: usuário
root, senharoot - ferramentas padrão do Debian funcionam, incluindo apt
- tudo é efêmero: ao reiniciar, as mudanças somem
Isso é útil para analisar problemas com a instalação principal no NVMe e repetir o processo com mais controle.
Rede e Wi-Fi na recovery
Por padrão, as interfaces sobem em DHCP, incluindo wireless. O iwd já vem instalado.
wlan0: 2,4 GHzwlan1: 5 GHz
Exemplo de conexão:
# Listar redes
iwctl station wlan1 get-networks
# Conectar
iwctl station wlan1 connect <network>O que vem na imagem do sistema (Debian no NVMe)
A imagem do sistema é um Debian mínimo com ferramentas e configurações úteis para começar:
- OpenSSH Server instalado
- por padrão no Debian, o root só entra via chaves no SSH (senha desabilitada para root)
- hostapd com exemplos para as duas interfaces Wi-Fi
- SSID:
openwrt-debian - PSK:
debian on openwrt one
- SSID:
- systemd-networkd configurado com:
- interface WAN em DHCP
- LAN em bridge com o Wi-Fi (
lanbr), também em DHCP
- LEDs via regra udev (
leds.role):- verde por porta Ethernet indica link
- âmbar por porta indica tráfego
- branco frontal em padrão de heartbeat
- vermelho em kernel panic
- o filesystem root expande automaticamente para ocupar o NVMe no primeiro boot
Como voltar para o OpenWrt
A NOR flash não é tocada. Para reverter ao OpenWrt, basta seguir o procedimento de recovery completo do OpenWrt One.