Habilidades routeros-netinstall
📦

routeros-netinstall

Seguro

Instalar e gerenciar dispositivos RouterOS com netinstall

A gravação de dispositivos MikroTik RouterOS requer compreensão de BOOTP, TFTP, gerenciamento de pacotes e scripts. Esta habilidade fornece documentação de referência completa para netinstall-cli com padrões de automação para instalações de dispositivo único e múltiplos dispositivos.

Suporta: Claude Codex Code(CC)
🥉 72 Bronze
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "routeros-netinstall". Instalar RouterOS 7.22 com pacotes container e WiFi em um dispositivo ARM64 via eth0.

Resultado esperado:

  • Execute: sudo netinstall-cli -r -b -i eth0 routeros-7.22-arm64.npk container-7.22-arm64.npk wifi-qcom-7.22-arm64.npk
  • Certifique-se de que o dispositivo esteja no modo etherboot (pressione o botão reset enquanto liga até aparecer no netinstall).
  • O pacote do sistema (routeros-*.npk) deve ser listado primeiro no comando.

A utilizar "routeros-netinstall". Como entro no modo etherboot usando o RouterOS CLI?

Resultado esperado:

  • Execute este comando no RouterOS CLI: /system/routerboard/settings/set boot-device=try-ethernet-once-then-nand
  • Depois reinicie o dispositivo. Ele tentará boot por ethernet uma vez antes de retornar ao NAND.
  • Após a conclusão do netinstall, a configuração boot-device retorna ao normal.

Auditoria de Segurança

Seguro
v2 • 4/16/2026

This skill is a documentation-only SKILL.md file (252 lines) describing MikroTik RouterOS netinstall-cli usage. The static analyzer flagged 124 patterns, but all are false positives from misinterpreting markdown formatting. Backtick-enclosed text (e.g., `netinstall-cli`) is markdown inline code formatting, not Ruby/shell execution. Sudo references, shell command substitution examples, and network URLs appear in documented code examples and reference links. The file contains no executable code, no secrets, and no malicious patterns. Safe for publication.

1
Arquivos analisados
252
Linhas analisadas
0
achados
2
Total de auditorias
Nenhum problema de segurança encontrado
Auditado por: claude Ver Histórico de Auditoria →

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
87
Conteúdo
32
Comunidade
100
Segurança
100
Conformidade com especificações

O Que Você Pode Construir

Administrador de rede implantando RouterOS em escala

Use padrões de automação netinstall para gravar múltiplos dispositivos RouterOS simultaneamente em ambiente de laboratório ou produção. Consulte o loop de serviço de instalação multi-dispositivo com flags -m -o para provisionamento em lote eficiente.

Engenheiro DevOps construindo pipelines CI/CD para RouterOS

Integre netinstall-cli em pipelines de build containerizados para testes automatizados de RouterOS. Consulte o padrão de netinstall containerizado com rede VETH e configuração de variáveis de ambiente.

Técnico recuperando dispositivos RouterOS inutilizados

Siga os procedimentos de entrada etherboot e etapas de instalação de dispositivo único para recuperar dispositivos que falharam em atualizações de firmware ou possuem configurações corrompidas. Use o padrão configure script para padrões personalizados.

Tente Estes Prompts

Construção básica de comando netinstall 
Preciso instalar RouterOS 7.22 em um dispositivo MikroTik ARM64. Construa o comando netinstall-cli com reinstall defaults e descarte o pacote branding na interface eth0.
Modescript para configuração device-mode 
Escreva um modescript que ative o advanced mode com suporte a container e zerotier, e depois mostre o comando netinstall-cli para aplicá-lo na primeira inicialização.
Netinstall multiplataforma em host ARM 
Tenho um servidor Linux ARM64 e preciso executar netinstall-cli. Explique a configuração de modo usuário QEMU e mostre como detectar automaticamente o binário QEMU correto para execução transparente.
Serviço netinstall containerizado no RouterOS 
Configure netinstall-cli como um container RouterOS que instala automaticamente RouterOS em dispositivos conectados à LAN. Configure o container com rede VETH, arquitetura arm64, canal stable e pacotes container plus wifi.

Melhores Práticas

  • Sempre liste o pacote do sistema (routeros-VER-ARCH.npk) primeiro na lista de pacotes do netinstall-cli para garantir a ordem correta de instalação.
  • Use uma interface de rede dedicada ou switch sem outras fontes DHCP para evitar conflitos BOOTP durante a descoberta de dispositivos etherboot.
  • Aplique lógica de retry DNS (5 tentativas com atrasos de 2 segundos) ao executar netinstall em containers na inicialização, pois o DNS pode não estar disponível imediatamente.

Evitar

  • Não combine as flags -r (reinstalar com defaults) e -e (reinstalar com config vazia). São mutuamente exclusivas e produzem comportamento indefinido.
  • Evite usar adaptadores USB Ethernet diretamente entre host e dispositivo. Quedas de link de adaptadores USB podem impedir a detecção do dispositivo. Use um switch como intermediário.
  • Não execute netinstall-cli em redes com servidores DHCP ativos sem isolamento. BOOTP usa as mesmas portas que DHCP e causará conflitos de endereço.

Perguntas Frequentes

Qual é a diferença entre netinstall e netinstall-cli?
Netinstall é o aplicativo GUI para Windows. Netinstall-cli é a ferramenta de linha de comando para Linux, distribuída como binário ELF x86. Ambos executam a mesma função de instalação RouterOS via Ethernet usando protocolos BOOTP e TFTP.
Por que netinstall-cli requer privilégios de root ou sudo?
Netinstall-cli usa BOOTP na porta 67/68 e TFTP na porta 69. São portas privilegiadas abaixo de 1024 que requerem acesso root em sistemas Linux. A ferramenta também executa operações de rede de baixo nível para descoberta de dispositivos.
Posso executar netinstall-cli em um Mac ou Linux ARM?
No Linux x86_64, netinstall-cli executa nativamente. No Linux ARM/ARM64, use emulação de modo usuário QEMU com qemu-i386-static ou qemu-i386. No macOS, é necessária uma máquina virtual QEMU completa com rede em ponte, pois a emulação de modo usuário QEMU é exclusiva do Linux.
Qual é a diferença entre um configure script e um mode script?
Um configure script (flag -s) é executado após a aplicação da config padrão e persiste através de atualizações até ser reinstalado via netinstall. Um mode script (flag -sm, RouterOS 7.22+) é executado uma vez na primeira inicialização antes de outros scripts e é auto-excluído após execução. Mode scripts são ideais para configuração inicial device-mode.
Como entro no modo etherboot em um dispositivo MikroTik?
Existem quatro métodos: pressione o botão reset enquanto liga até o dispositivo aparecer no netinstall; pressione Ctrl+E durante a inicialização via console serial; defina boot-device para try-ethernet-once-then-nand via RouterOS CLI e reinicie; ou use o método bootloader protegido se configurado previamente.
Onde baixo os arquivos de pacote RouterOS (.npk)?
Baixe pacotes de download.mikrotik.com usando o padrão: https://download.mikrotik.com/routeros/VERSION/routeros-VERSION-ARCH.npk. Você também pode extrair pacotes individuais do arquivo all_packages-ARCH-VERSION.zip para sua arquitetura.

Detalhes do Desenvolvedor

Autor

tikoci

Licença

MIT

Repositório

https://github.com/tikoci/routeros-skills/tree/main/routeros-netinstall

Referência

main

Estrutura de arquivos

📄 SKILL.md