Command Reference pt BR

🇺🇸 English

Cada subcomando, suas flags e o que esperar. Rode netwp help para a versão de uma linha. Comandos que só leem a rede nunca exigem admin no Windows.

scan

netwp scan [--json] [--diff] [--ports=<lista>] [--class=<classe>]

Varredura ARP única da sua sub-rede, depois enriquecimento por dispositivo: hostname (DNS reverso, depois mDNS/NetBIOS), fabricante pelo OUI do MAC, palpite de classe do dispositivo, RTT e TTL de um echo ICMP, e portas abertas de uma sondagem curada.

• --json imprime um array legível por máquina em vez da tabela.
• --diff imprime só o que mudou desde a última varredura (entradas, saídas, trocas de IP e possíveis conflitos de IP/MAC), comparando por MAC.
• --ports=22,80,443 sonda um conjunto de portas TCP custom em vez das ~29 padrão curadas. Portas individuais separadas por vírgula, sem intervalos.
• --class=media mostra só dispositivos de uma classe (router|computer|mobile|media|printer|iot). Só afeta a exibição: o cache do scan ainda guarda todos os dispositivos, então alias e --diff não são afetados. Um nome de classe inválido falha rápido, antes de escanear.

netwp scan
netwp scan --json | ConvertFrom-Json | Where-Object reachable
netwp scan --diff
netwp scan --ports=22,80,3000,32400
netwp scan --class=media

monitor

netwp monitor [--alert-down=<taxa>] [--quiet]

A versão ao vivo do scan: uma TUI que reescaneia num intervalo e reporta dispositivos entrando e saindo em tempo real. Um dispositivo desconhecido entrando (sem apelido) toca o bipe do terminal.

• --alert-down=50Mbps amostra a interface ativa uma vez por segundo e destaca a linha de banda quando o download cai abaixo do limiar (Mbps, Kbps, Gbps, bps). Sem a flag, não há linha de banda.
• --quiet roda headless (sem interface): imprime uma linha simples por entrada/saída no stdout e ainda registra os eventos, para um serviço em segundo plano ou um arquivo de log. Ctrl-C/SIGTERM para de forma limpa.
• Aperte / para filtrar a tabela (veja Filtragem) e s para ordená-la (veja Ordenação).
• r reescaneia agora (re-resolvendo os hostnames em vez de servir o cache), q sai.

dashboard

netwp dashboard

Uma visão ao vivo composta: Wi-Fi (com sugestão de canal pelo congestionamento de APs próximos), banda em tempo real, um speedtest periódico, a tabela de dispositivos e um painel LOG rastreando o próprio trabalho do dashboard (scans, speedtests, mudanças de internet/Wi-Fi). As mesmas teclas / filtro, s ordenação, r e q do monitor.

doctor

netwp doctor [--json]

Diagnostica a conectividade de cima para baixo: interface tem IP, gateway responde, internet alcançável, DNS resolve, sinal de Wi-Fi. Cada checagem imprime uma dica na falha. Leia de cima para baixo: o primeiro ✗ costuma ser a causa raiz e explica os de baixo. --json imprime as checagens como um array legível por máquina.

ports

netwp ports <ip> [--json]

Sonda um dispositivo diretamente e lista suas portas abertas por nome (SSH, SMB, RDP, ...), mais RTT e TTL. Sem histórico de portas entre execuções, só o estado atual. --json imprime o resultado como um objeto legível por máquina.

wake

netwp wake <ip-ou-mac-ou-apelido>

Faz broadcast de um pacote mágico Wake-on-LAN para ligar um dispositivo adormecido. Só funciona se aquele dispositivo tiver WoL habilitado na BIOS/SO. É dispare-e-esqueça: o netwp reporta "enviado", não "acordou". Aceita um apelido ou um IP em cache, então resolve mesmo com o alvo desligado.

speedtest

netwp speedtest [--json]

Vazão de download/upload contra o anycast speed.cloudflare.com da Cloudflare; mostra qual edge respondeu (ex.: "via Cloudflare edge: GRU"). --json imprime o download/upload/edge como um objeto legível por máquina.

iface

netwp iface
netwp iface static <ip>/<bits> <gateway> [dns...]
netwp iface dhcp

iface sozinho inspeciona a configuração de IP da interface ativa (só leitura, qualquer SO). iface static e iface dhcp mudam a configuração real no Windows; ambos precisam de um terminal elevado e pedem um "yes" digitado. Não implementado no Linux.

netwp iface static 192.168.1.50/24 192.168.1.1 8.8.8.8 1.1.1.1
netwp iface dhcp

alias

netwp alias set <ip-ou-mac> <nome>
netwp alias ls
netwp alias rm <ip-ou-mac>

Apelida um dispositivo. Os apelidos são chaveados por MAC, então sobrevivem a uma troca de IP pelo DHCP. alias set <ip> resolve o MAC pelo cache do último scan quando possível; passe um MAC para pular a rede inteiramente.

netwp alias set 192.168.1.20 "TV da Sala"

class

netwp class set <ip-ou-mac> <classe>   # router|computer|mobile|media|printer|iot
netwp class ls
netwp class rm <ip-ou-mac>

Fixa a classe de um dispositivo quando o palpite automático erra (um celular com MAC aleatório e sem portas abertas costuma cair em Unknown). Um pin manual é mantido por MAC e sempre vence o palpite.

netwp class set 192.168.1.20 mobile

watch

netwp watch add <ip-ou-mac>
netwp watch ls
netwp watch rm <ip-ou-mac>

Marca um dispositivo cuja ausência importa (uma câmera, um servidor). Enquanto o monitor ou o dashboard roda, um dispositivo vigiado saindo destaca a linha do log e toca o bipe do terminal.

events

netwp events [n] [--device=<apelido-ou-mac>]

Imprime os últimos n eventos de entrada/saída (padrão 20) registrados pelo monitor e pelo dashboard em events.jsonl. --device restringe a um dispositivo; resolve um apelido para o MAC, então também pega eventos registrados antes de o apelido existir.

netwp events 50
netwp events --device="TV da Sala"

version / update / uninstall / help

• netwp version imprime a versão instalada.
• netwp update roda de novo go install ...@latest (precisa do Go).
• netwp uninstall remove os dados locais após uma confirmação e mostra como remover o binário.
• netwp help (ou sem argumentos) imprime a ajuda.

Filtragem

No monitor e no dashboard, aperte / para filtrar a tabela por um trecho (sem diferenciar maiúsculas) de qualquer campo (IP, apelido, hostname, fabricante, MAC, classe). Digite para estreitar, Enter mantém o filtro aplicado, Esc limpa. As contagens online/conhecidos continuam refletindo a rede inteira.

Ordenação

No monitor e no dashboard, aperte s para alternar a coluna de ordenação da tabela (IP, RTT, nome, classe); a coluna ativa aparece no rodapé. Os dispositivos online sempre ficam antes dos offline, então o s ordena dentro de cada grupo. RTT coloca os dispositivos alcançáveis primeiro, do mais rápido ao mais lento.

Onde ficam os dados

O netwp guarda alguns arquivos simples em <pasta-de-config-do-usuário>/netwp/ (%AppData%\netwp no Windows, ~/.config/netwp no Linux):

Arquivo	Escrito por
aliases.json	alias
classoverride.json	class
watchlist.json	watch
lastscan.json	scan (cache, pra alias set <ip> ser instantâneo)
events.jsonl	monitor / dashboard (incl. monitor --quiet)

Todos são legíveis e seguros de apagar; netwp uninstall os remove. O events.jsonl é limitado: quando passa de ~1 MB, é reduzido aos 5000 eventos mais recentes, então um monitor rodando por muito tempo não faz ele crescer sem limite.