Skip to content

Troubleshooting pt BR

gsjonio edited this page Jul 13, 2026 · 1 revision

🇺🇸 English

netwp não é encontrado após go install

O binário está em $(go env GOPATH)\bin (muitas vezes %USERPROFILE%\go\bin no Windows, ~/go/bin no Linux). Adicione essa pasta ao seu PATH, ou rode com o caminho completo uma vez para confirmar que compilou.

Linux: scan não acha nada / "operation not permitted"

O scanner ARP cru precisa da capability CAP_NET_RAW. Conceda uma vez:

sudo setcap cap_net_raw+ep $(which netwp)

Depois rode netwp scan como seu usuário normal. Rodar sob sudo também funciona, mas é mais bruto.

Linux: "too many open files" durante um scan grande

Cada dispositivo é sondado em muitas portas concorrentemente. Numa sub-rede grande e movimentada isso pode se aproximar do limite de descritores de arquivo (padrão 1024 em muitas distros). O netwp limita o fan-out da sondagem, mas se ainda assim bater no limite, aumente-o para a sessão:

ulimit -n 4096

O scan mostra menos dispositivos do que eu esperava

  • Um dispositivo dormindo ou que não responde ARP não vai aparecer. Acorde-o (ou espere ele falar) e reescaneie.
  • Alguns dispositivos limitam a taxa ou ignoram sondagens. O monitor os pega ao longo do tempo, conforme ficam ativos.
  • Você só escaneia a sub-rede da interface ativa. Um dispositivo em outra VLAN ou sub-rede está fora de alcance.

Um dispositivo está classificado errado (CLASS errada)

Fixe: netwp class set <ip|mac> <router|computer|mobile|media|printer|iot>. O pin é mantido por MAC e sempre sobrescreve o palpite. netwp class ls mostra seus pins; netwp class rm remove um.

O dashboard fica apertado ou o rodapé é cortado

O dashboard precisa de um terminal razoavelmente alto (ele empilha vários painéis). Numa janela curta o painel LOG encolhe e depois some, e a tabela de dispositivos trunca, para o rodapé continuar visível. Deixe o terminal mais alto para a visão completa.

Cores ou desenho de caixas parecem errados

Use um terminal com UTF-8 e suporte a 256 cores/ANSI (Windows Terminal, a maioria dos terminais Linux). O clássico console cmd.exe renderiza a TUI mal.

iface static / iface dhcp não faz nada

Eles mudam a configuração de rede real, então precisam de um terminal elevado no Windows (Executar como administrador) e sempre pedem um "yes" digitado. Não são implementados no Linux.

O painel de Wi-Fi está em branco no dashboard

O netwp lê o estado do Wi-Fi do netsh wlan (Windows). Numa máquina só com fio não há Wi-Fi para mostrar, o que é esperado. O netwp doctor vai reportar "not on Wi-Fi (wired connection)".

O netwp update falha

O update precisa do toolchain Go no PATH (ele encapsula go install ...@latest). Se você instalou por um binário pronto e não tem Go, baixe o binário novo na página de Releases.

Ainda travado? Abra uma issue com seu SO, o netwp version e o que você rodou.

Clone this wiki locally