MapNet - MT

Scanner de inventário de rede para Windows, da MT - Manfred Tecnologia. Roda na rede do cliente e mostra quais equipamentos estão ligados nela, com IP, MAC, fabricante, nome, tipo provável e, se você pedir, portas abertas e serviços, num relatório em HTML, CSV ou XML.

Página do programa: https://mapnet.manfred.com.br. Download da versão mais recente: mapnet.exe.

Software livre, sob licença GPL-3.0.

Não é scanner de vulnerabilidade: o programa não testa senha, não contorna autenticação e não explora vulnerabilidade. Para achar os equipamentos, ele manda ping, pedidos ARP e consultas de nome (DNS, NetBIOS e mDNS) aos endereços da sub-rede escolhida. Com a opção Verificar portas ligada, ele também abre e fecha uma conexão TCP em cada porta da lista, nos equipamentos que encontrou, sem enviar dados. Com Identificar serviços, que vem marcado junto com as portas, ele pede a página inicial dos serviços web que estiverem abertos (só um GET, sem senha), lê o certificado HTTPS e a primeira linha de SSH, FTP e SMTP, e faz uma busca UPnP na rede local.

Uso autorizado. O MapNet - MT serve para inventariar equipamentos em redes nas quais você tem autorização para fazer a verificação. Confira o intervalo de endereços antes de iniciar e respeite as regras da rede e dos dispositivos examinados.

As regras do projeto estão no AGENTS.md e o desenho em docs/superpowers/specs/2026-09-25-mapnet-design.md.

Situação do projeto

Versão 1.0 concluída em 26/09/2026, publicada como v1.0.0. O que ficou de fora é melhoria opcional e está em docs/superpowers/pendencias.md. O executável segue sem assinatura digital, por decisão do Manfred.

Fatia	Conteúdo	Ramo	Pull Request	Situação
0	Estrutura do método da MT: regras, ganchos, CI, spec	metodo-mt	#1	Concluída
1	Descoberta de hosts (ping e ARP), MAC, fabricante, nome (DNS reverso, NetBIOS, mDNS), relatório HTML básico, janela e linha de comando	descoberta-hosts	#2	Publicada na v0.1.2
1b	Página mapnet.manfred.com.br, código aberto (GPL-3.0), nome MapNet - MT, publicação do .exe pelo GitHub Releases	pagina-e-codigo-aberto	#3	Concluída
2	Tela WPF do painel do técnico, com a identidade da MT (a v0.2.0 fechava no fim da varredura e teve a Release retirada, a correção saiu na v0.2.1)	tela-wpf	#10, #12, #13	Publicada na v0.2.1
3	Painel "Minha máquina" completo: nome, domínio, DHCP, Wi-Fi e IP público sob demanda, e tabela de hosts sem texto cortado (sai como v0.2.2)	minha-maquina	Plano em #14, código em #16	Publicada na v0.2.5
4	Console de diagnóstico: ping, tracert, DNS, ARP, conexões e rotas (sai como v0.2.3)	diagnostico	#17	Publicada na v0.2.5
5	Ações de manutenção com elevação sob demanda, na aba Manutenção do console (sai como v0.2.4)	manutencao	#18	Publicada na v0.2.5
6	Painel de detalhe do host, com ping, tracert, navegador, área de trabalho remota e pasta compartilhada (sai como v0.2.5)	detalhe-host	#19	Publicada na v0.2.5
7	Portas TCP comuns abertas, com lista configurável, desligadas por padrão e com confirmação por rede (sai como v0.3.0)	portas	Plano em #26, código em #31	Publicada na v0.3.0
8	Identificação leve dos serviços nas portas abertas: título da página, certificado HTTPS, banner SSH, FTP e SMTP, e UPnP (sai como v0.4.0)	identificacao-servicos	Plano em #32, código em #34	Publicada na v1.0.0
9	Classificação por tipo de equipamento, com os motivos à vista (sai como v0.5.0)	classificacao	#35	Publicada na v1.0.0
10	Relatório também em CSV e XML, pela janela e pela linha de comando (sai como v1.0.0)	relatorios	#36	Publicada na v1.0.0

A versão 0.2 segue o desenho em docs/superpowers/specs/2026-09-25-mapnet-0.2-painel-do-tecnico-design.md.

O que ficou de fora de cada fatia está em docs/superpowers/pendencias.md.

Como usar

O programa é um arquivo só, mapnet.exe. Não precisa instalar nada no computador do cliente, nem o .NET, e não pede administrador.

Pela janela

1. Abra o mapnet.exe.
2. Na faixa verde do topo, escolha a interface de rede. A primeira da lista é a que tem gateway, quase sempre a certa. A coluna Minha máquina mostra o computador (nome, grupo de trabalho ou domínio, usuário), a placa (tipo, MAC, velocidade, MTU), os endereços (IPv4, IPv6, gateway, DNS, sufixo e a sub-rede que vai ser varrida) e o DHCP com a validade da concessão. No Wi-Fi, mostra também a rede, a banda, o canal e o sinal.
3. O botão Consultar IP público, na faixa do topo, pergunta o IP ao serviço 1.1.1.1, do Cloudflare, e só roda com o clique. Se o relatório for gravado depois da consulta, o IP público vai junto.
4. Para saber também as portas abertas de cada equipamento, marque Verificar portas acima da tabela. A Lista vem com padrão, as 24 portas comuns (a dica do campo mostra quais são), ou aceita até 100 portas separadas por vírgula, como 80,443,9100. Os aparelhos com MAC aleatório, quase sempre celulares e notebooks pessoais, ficam de fora, a não ser que você marque Incluir aparelhos com MAC aleatório. Identificar serviços vem marcado e preenche a coluna Serviço com o que o equipamento diz de si: modelo pelo UPnP, título da página, certificado ou banner. Na primeira varredura com portas em cada rede, o programa diz o que vai enviar e pede confirmação. Use só em rede que você tem autorização para verificar.
5. Clique em Iniciar varredura. Clicar numa linha da tabela abre, ao lado, o detalhe do host: MAC, fabricante, os nomes pelo DNS reverso, NetBIOS e mDNS, o grupo de trabalho, o ping com o TTL, uma pista do sistema pelo TTL e as portas abertas, com o serviço de cada uma. Os botões do detalhe fazem ping contínuo e tracert no console, abrem http e https no navegador (na 8080, 8000 ou 8443 quando só ela está aberta, e desligados quando as portas web foram verificadas e estão fechadas), a área de trabalho remota e a pasta compartilhada, e copiam os dados. Um novo clique na mesma linha, a tecla Esc ou o botão Fechar fecham o detalhe. A tabela vai se enchendo enquanto os hosts respondem, e o mesmo botão vira Cancelar. O campo Filtrar procura por IP, nome, MAC, fabricante, observação ou número de porta aberta (9100 lista as impressoras), e cada coluna ordena com um clique no título.
6. O console embaixo registra o andamento e os avisos, e a barra de estado mostra o resumo. O console tem também uma aba para cada ferramenta: Ping (normal ou contínuo), Tracert, DNS com escolha do servidor, ARP, Conexões e Rotas. Os campos de host e de servidor DNS já vêm com o gateway e o DNS da interface. Enquanto a ferramenta roda, Executar vira Parar. Copiar e Limpar valem para a aba aberta.
7. No fim, clique em Salvar relatório, escolha onde gravar e o tipo: HTML, para abrir no navegador; CSV, para o Excel; ou XML, para outro programa ler. A janela abre em Documentos\MapNet - MT com um nome pronto, e da segunda vez abre na pasta usada por último. O programa não grava sozinho: fechar a janela com a varredura sem salvar pergunta antes. O botão Abrir abre o relatório salvo no navegador ou a pasta dele.
8. A aba Manutenção tem quatro botões, que rodam os comandos oficiais do Windows e mostram a saída ali mesmo: Limpar cache DNS (ipconfig /flushdns), Liberar e renovar IP (ipconfig /release e /renew), Limpar tabela ARP (netsh interface ip delete arpcache) e Resetar Winsock e TCP/IP (netsh winsock reset e netsh int ip reset). O programa continua abrindo como usuário comum. Quando a ação pede administrador, o Windows mostra a tela do UAC só para aquele comando. Renovar o IP e resetar o Winsock derrubam a rede por alguns segundos e pedem confirmação antes. O reset só vale depois de reiniciar o computador.

Pela linha de comando

mapnet --interfaces
mapnet --varrer
mapnet --varrer --interface 2 --saida C:\Relatorios --abrir
mapnet --varrer --portas 80,443,9100
mapnet --ajuda

Opção	Para que serve
--interfaces	Lista as interfaces ativas, numeradas
--varrer	Varre a sub-rede e grava o relatório (HTML, ou o formato de --formato)
--interface <n ou nome>	Escolhe a interface pelo número de --interfaces, pelo nome ou pelo IP
--saida <pasta ou arquivo>	Onde gravar o relatório. Padrão: a pasta atual. Arquivo terminado em .html, .csv ou .xml define o formato
--formato <f>	html, csv, xml ou todos. Padrão: html. Com todos, grava os três na pasta de --saida
--abrir	Abre o relatório no navegador ao terminar
--tempo-ping <ms>	Espera de cada ping, de 100 a 10000. Padrão: 1000
--paralelo <n>	Endereços sondados ao mesmo tempo, de 1 a 256. Padrão: 64
--sem-arp	Descobre hosts só pelo ping
--portas [lista]	Verifica as portas TCP dos hosts encontrados, só abrindo e fechando a conexão. Sem lista, usa as 24 portas comuns; com lista, até 100 portas, como 22,80,443. Desligado sem esta opção
--incluir-mac-aleatorio	Com --portas, inclui os aparelhos com MAC aleatório, que ficam de fora por padrão
--sem-identificar	Com --portas, não identifica os serviços das portas abertas

O .exe é de janela, então o Prompt de Comando devolve o cursor antes de o programa terminar. Para esperar o fim, use start /wait mapnet --varrer no Prompt de Comando ou termine a linha com | Out-Host no PowerShell. Redirecionar para arquivo (> saida.txt) funciona direto, em UTF-8.

Códigos de saída: 0 concluído, 1 erro nos argumentos, 2 interface não encontrada, 3 falha, 4 interrompido com Ctrl+C.

Primeira execução

O Windows pode avisar antes de abrir. O executável não tem assinatura digital, e todo arquivo baixado da internet recebe do navegador a Marca da Web (Mark of the Web), que faz o Windows mostrar "O Windows protegeu o seu computador" (SmartScreen). O arquivo está perfeito; o aviso vem da falta de assinatura. Para abrir, escolha um caminho:

1. Na tela de aviso, clique em Mais informações e depois em Executar assim mesmo.
2. Clique com o botão direito no arquivo, abra Propriedades, marque Desbloquear e confirme em OK.
3. Pelo PowerShell, na pasta do arquivo:

Unblock-File .\mapnet.exe

Copiar o .exe por pen drive ou pasta de rede não aplica a Marca da Web, e o programa abre direto. Cada versão nova começa sem reputação no SmartScreen, então o aviso tende a aparecer nos primeiros dias depois de cada publicação.

Se o computador tiver o Controle de Aplicativo Inteligente (Smart App Control) ligado, em Segurança do Windows, Controle de aplicativos e navegador, o bloqueio não oferece a opção de executar assim mesmo. Nesse caso, só a assinatura digital resolve.

A primeira execução demora alguns segundos, porque o Windows descompacta o conteúdo do executável numa pasta temporária. Da segunda vez em diante, abre rápido.

Conferir se o arquivo chegou íntegro

Cada versão publicada leva um arquivo mapnet.exe.sha256.txt. Na máquina que recebeu o .exe:

Get-FileHash .\mapnet.exe -Algorithm SHA256

Se o valor bater com o do .txt, o executável é exatamente o que foi publicado.

O que a fatia 1 faz

• Interfaces: lê as placas ativas com IPv4 e calcula a sub-rede pelo IP e pela máscara. Adaptadores virtuais (Hyper-V, VMware, VPN) vão para o fim da lista.

• Descoberta: cada endereço da sub-rede recebe um ping e um pedido ARP (SendARP do Windows), 64 de cada vez. Responder a qualquer um dos dois basta, então o host que bloqueia ping no firewall também aparece.

• Fabricante: pelos três primeiros bytes do MAC, na tabela OUI do IEEE embutida no programa (35.084 prefixos). MAC com o bit de administração local ligado aparece como "MAC aleatório (privativo)", que é o caso do celular com endereço privado.

• Nome: DNS reverso, NetBIOS (o mesmo do nbtstat -A, que traz também o grupo de trabalho ou domínio) e mDNS (nomes .local de celulares, Macs, impressoras e aparelhos Linux).

• Relatório HTML: arquivo único, com resumo da varredura, cartões de contagem, tabela filtrável e ordenável, detalhe de cada host ao clicar na linha e a lista de fabricantes.

• CSV e XML (desde a v1.0.0): o CSV tem uma linha por host, com ponto e vírgula e acentos certos no Excel, e protege contra texto que viraria fórmula. O XML traz tudo o que o HTML mostra, para outro programa ler.

• Portas (desde a v0.3.0, desligadas por padrão): para cada host encontrado, abre e fecha a conexão TCP em cada porta da lista, sem enviar nenhum dado, com até 128 conexões ao mesmo tempo, 8 por host e 800 ms de espera por porta. Porta que aceita a conexão aparece como aberta. Este computador e os aparelhos com MAC aleatório ficam de fora, e o motivo aparece no detalhe. O relatório ganha a coluna Portas e diz quais portas foram verificadas.

• Tipo provável (desde a v0.5.0): roteador, impressora, câmera ou gravador, NAS, computador Windows, Linux, access point, TV ou mídia, videogame, celular ou tablet, automação ou desconhecido. É um palpite pelo que as outras etapas levantaram (fabricante, nomes, TTL, portas e serviços), sem mandar nada para a rede, e o detalhe mostra os motivos.

• Serviços (desde a v0.4.0, com as portas): só nas portas abertas. Nas web (80, 8000, 8080, 443, 8443), um GET / para ler o título e o servidor, sem seguir redirecionamento, e o certificado HTTPS, aceitando autoassinado e vencido. Em SSH, FTP e SMTP, só lê a primeira linha que o servidor manda. O UPnP é um M-SEARCH na rede local, e a descrição do equipamento é lida dele mesmo. Telnet fica de fora. No máximo 16 ao mesmo tempo, 3 s por serviço e 64 KB lidos por resposta.

Sub-rede maior que /22 (1022 endereços) é varrida só no bloco /22 em volta do IP do computador, com aviso no relatório. A faixa manual fica para uma próxima versão.

Primeira vez na máquina

git clone https://github.com/manfredjr/mapnet.git MAPNET-MT
cd MAPNET-MT
git config core.hooksPath .githooks

O último comando liga os ganchos que enviam cada commit ao GitHub na hora. A configuração é local e não vem com o clone.

Como compilar

O jeito mais simples de ter o .exe é baixar do CI: no GitHub, Actions, a execução do commit e, no fim da página, Artifacts. Todo Pull Request e todo push no main geram um.

Para compilar na máquina, precisa do SDK do .NET 8 no Windows.

ferramentas\publicar.cmd

O roteiro roda os testes e, se passarem, gera publicar\mapnet.exe (cerca de 67 MB, já com o .NET dentro).

Para ver a tela com dados de exemplo, sem varrer nem consultar nada, abra mapnet --demonstracao. As imagens da documentação saem dele, com endereços reservados para documentação.

Comandos avulsos:

dotnet build mapnet.sln -c Release
dotnet test mapnet.sln -c Release
dotnet publish src\mapnet\mapnet.csproj -c Release -o publicar

Publicação

São duas publicações, que não se misturam:

O quê	Para onde	Como
O programa (mapnet.exe)	GitHub Releases	Enviar a marca da versão (git tag v0.1.0 e git push origin v0.1.0). O CI testa, gera o .exe e publica a Release
A página (pasta public/)	mapnet.manfred.com.br	Git Version Control do cPanel, com o .cpanel.yml

O passo a passo, com "Antes de publicar" e "Depois de publicar", está em docs/publicacao.md.

Tabela de fabricantes

A tabela fica em src/mapnet.nucleo/dados/oui.txt.gz. Para atualizar a partir do site do IEEE:

powershell -ExecutionPolicy Bypass -File ferramentas\atualizar-oui.ps1

Depois, compile e rode os testes de novo antes do commit.

Estrutura

Pasta	Conteúdo
src/mapnet.nucleo	Biblioteca sem janela: interfaces, sub-rede, ping, ARP, OUI, nomes, relatório e linha de comando
src/mapnet	Aplicativo WPF que gera o mapnet.exe, com a tela, o tema da MT e a fonte Montserrat
testes/mapnet.testes	Testes do núcleo e da lógica da tela (xUnit)
ferramentas/	Roteiros de compilação e de atualização da tabela OUI
public/	Página do programa em mapnet.manfred.com.br
docs/superpowers/	Desenho, planos e pendências
.githooks/	Ganchos que enviam cada commit ao GitHub
.github/workflows/	CI em Windows: compila, testa e gera o .exe

Como contribuir

Relatar problema, sugerir melhoria ou mandar código: veja o CONTRIBUTING.md.

Licença

Distribuído sob a GNU General Public License v3.0. Qualquer pessoa pode usar, estudar e modificar o programa. Quem distribuir uma versão modificada precisa abrir o código dela sob a mesma licença.

Licença e garantias. O MapNet - MT é distribuído de graça sob a GPL-3.0. O inventário depende das respostas dos dispositivos e pode sair incompleto ou impreciso. A licença não promete funcionamento em toda rede nem inclui suporte técnico. Quem executa o programa deve definir uma rede autorizada e conferir o alcance da verificação antes de iniciar. As disposições da GPL-3.0 sobre garantias e responsabilidade valem nos limites da lei brasileira e não restringem direitos que a lei assegura ao consumidor.

A fonte Montserrat, embutida no .exe, é do Montserrat Project e vai sob a SIL Open Font License 1.1, em src/mapnet/recursos/fontes/ofl.txt.

A confirmar com

Nada no momento.

Autor

Manfred Heil Junior - MT - Manfred Tecnologia.