homelab-network-readiness
Verifica a prontidão da rede doméstica para segmentação VLAN, filtragem DNS e acesso remoto seguro.
O que ela faz
Este agente ajuda a planejar e revisar mudanças na sua rede doméstica. Ele verifica se você está pronto para organizar sua rede em 'zonas' (como uma para convidados e outra para dispositivos inteligentes), configurar um bloqueador de anúncios local (como Pi-hole) ou adicionar acesso seguro à sua rede quando você estiver fora de casa.
Quando usar
- ✓Antes de separar sua rede atual em redes menores (VLANs).
- ✓Ao planejar usar um bloqueador de anúncios (Pi-hole) para todos os dispositivos.
- ✓Quando quiser acessar sua rede de casa de forma segura de qualquer lugar.
Exemplo do que pedir para a IA
“Estou pensando em separar minha rede para convidados e dispositivos de casa inteligente. O que preciso verificar antes de começar?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ele faz perguntas sobre sua rede atual (roteador, Wi-Fi, etc.) e os planos que você tem. Com base nas suas respostas, ele aponta os riscos e sugere um plano passo a passo para fazer as mudanças com segurança, garantindo que você não perca o acesso à sua própria rede.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add affaan-m/ECC --skill homelab-network-readinessOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/homelab-network-readiness/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Preparação de Rede para Homelab
Use esta habilidade antes de alterar uma rede doméstica ou de pequeno laboratório que misture VLANs, Pi-hole ou outro resolvedor DNS local, regras de firewall e acesso VPN remoto.
Esta é uma habilidade de planejamento e revisão. Não a transforme em copiar e colar configurações de roteador, firewall ou VPN, a menos que a plataforma de destino, a topologia atual, o caminho de reversão, o acesso ao console e a janela de manutenção sejam todos conhecidos.
Quando Usar
- Preparando-se para dividir uma rede plana em VLANs confiáveis, de IoT, de convidados, de servidores ou de gerenciamento.
- Movendo clientes DHCP para Pi-hole, AdGuard Home, Unbound ou outro resolvedor DNS local.
- Adicionando acesso VPN WireGuard, Tailscale, ZeroTier, OpenVPN ou nativo do roteador.
- Revisando se uma alteração no homelab pode bloquear o operador do gateway, switch, ponto de acesso, servidor DNS ou servidor VPN.
- Transformando uma ideia informal de rede doméstica em um plano de migração escalonado com evidências de validação.
Regras de Segurança
- Mantenha a primeira resposta somente leitura: inventário, riscos, plano escalonado, validação e reversão.
- Não exponha painéis de administração de gateway, resolvedores DNS, SSH, consoles NAS ou UIs de gerenciamento de VPN diretamente à internet pública.
- Não forneça comandos de firewall, NAT, VLAN, DHCP ou VPN sem uma plataforma confirmada e um procedimento de reversão.
- Exija acesso ao console fora de banda ou na mesma sala antes de alterar VLANs de gerenciamento, portas trunk, políticas padrão de firewall ou configurações de DHCP/DNS.
- Mantenha um caminho funcional de volta para a internet antes de apontar toda a rede para um novo resolvedor DNS ou rota VPN.
- Trate redes de IoT, convidados, câmeras e servidores de laboratório como zonas de confiança diferentes até que o operador escolha explicitamente o contrário.
Inventário Necessário
Colete isso antes de fornecer etapas de implementação:
| Área | Perguntas |
|---|---|
| Borda da Internet | Qual é o modem ou ONT? O roteador do ISP está em bridge ou ainda roteando? |
| Gateway | Quais rotas, firewalls, lida com DHCP e termina VPNs? |
| Switching | Quais portas de switch são uplinks, portas de acesso, trunks ou não gerenciadas? |
| Wi-Fi | Quais SSIDs mapeiam para quais redes e os APs são cabeados ou mesh? |
| Endereçamento | Quais sub-redes existem hoje e quais intervalos entram em conflito com sites VPN? |
| DNS/DHCP | Qual serviço atualmente distribui leases e endereços de resolvedor? |
| Gerenciamento | Como o operador acessará o gateway, o switch e o AP após as alterações? |
| Recuperação | O que pode ser revertido localmente se DNS, DHCP, VLANs ou rotas VPN quebrarem? |
Plano de VLAN e Zona de Confiança
Comece com a intenção em vez da sintaxe do fornecedor.
| Zona | Conteúdo Típico | Política Padrão |
|---|---|---|
| Confiável | Laptops, telefones, estações de trabalho administrativas | Pode acessar serviços compartilhados e gerenciamento apenas quando necessário |
| Servidores | NAS, Home Assistant, hosts de laboratório, resolvedor DNS | Aceita fluxos de entrada restritos de clientes confiáveis |
| IoT | TVs, tomadas inteligentes, câmeras, alto-falantes | Acesso à Internet mais exceções explícitas apenas |
| Convidados | Dispositivos de visitantes | Apenas acesso à Internet, sem alcançabilidade na LAN |
| Gerenciamento | Gateway, switches, APs, controladores | Acessível apenas a partir de dispositivos administrativos confiáveis |
| VPN | Clientes remotos | Acesso igual ou mais restrito que clientes confiáveis |
Antes de recomendar IDs de VLAN ou sub-redes, confirme:
- O gateway suporta roteamento inter-VLAN e regras de firewall.
- O switch suporta o comportamento necessário de porta marcada e não marcada.
- Os APs podem mapear SSIDs para VLANs.
- O operador sabe através de qual porta está conectado durante a alteração.
- A rede de gerenciamento permanece acessível após alterações de trunk e SSID.
Preparação para Filtragem de DNS
Pi-hole ou outro resolvedor local deve ser introduzido como uma dependência, não como um ponto único de falha.
- Dê ao resolvedor um endereço reservado antes de usá-lo nas opções de DHCP.
- Confirme se ele pode resolver nomes DNS públicos e locais
home.arpa. - Mantenha o gateway ou um segundo resolvedor disponível como fallback temporário.
- Teste um cliente ou uma VLAN antes de alterar todos os escopos de DHCP.
- Documente quais redes podem contornar a filtragem e por quê.
- Verifique se as regras de bloqueio não quebram portais cativos, VPNs de trabalho, atualizações de firmware ou dispositivos médicos/de segurança.
Evidências de validação úteis:
Client gets expected DHCP lease
Client receives expected DNS resolver
Public DNS lookup succeeds
Local home.arpa lookup succeeds
Blocked test domain is blocked only where intended
Gateway and DNS admin interfaces are not reachable from guest or IoT networks
Preparação para Acesso Remoto
Para acesso no estilo WireGuard, decida o que a VPN tem permissão para alcançar antes de
…
Perguntas frequentes
Por que não devo expor interfaces de administração diretamente à internet?
Expor interfaces de administração (como a do roteador ou do Pi-hole) diretamente à internet as torna alvos fáceis para hackers, que podem tentar roubar suas informações ou controlar sua rede.
O que é 'acesso fora de banda'?
É um método de acesso à sua rede que não depende da própria rede que está sendo alterada. Por exemplo, ter um cabo conectado diretamente ao seu computador para acessar o roteador, caso a rede Wi-Fi pare de funcionar após uma mudança.
O que é uma 'zona de confiança'?
É um grupo de dispositivos na sua rede que têm um nível de segurança semelhante. Por exemplo, seus computadores e celulares podem estar em uma zona 'confiável', enquanto dispositivos de IoT (como câmeras e lâmpadas inteligentes) podem estar em uma zona 'menos confiável' para limitar o dano caso sejam comprometidos.
Detalhes
Descrição original do autor
Readiness checklist for homelab VLAN segmentation, local DNS filtering (Pi-hole, AdGuard Home), and WireGuard-style remote access. Use when planning or reviewing home network changes — splitting a flat network into trusted, IoT, guest, or management VLANs, moving DHCP to a local resolver, or adding VPN access — before changing router, firewall, DHCP, or VPN configuration.
repo: affaan-m/ECC
Popularidade
- Estrelas no GitHub
- 280 mil
- Posição no ranking
- #206
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
accessibility
Ajuda seu agente a criar interfaces que todos possam usar. Garante que sites e aplicativos funcionem bem para pessoas com deficiência, como cegos ou com mobilidade reduzida.
affaan-m/ECC
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC
Skills parecidas
template-skill
Este é um modelo genérico para novas habilidades. Ele precisa de uma descrição específica para ser útil.
anthropics/skills
shipping-and-launch
Prepara seu código para ser lançado em produção com segurança. Ajuda a garantir que tudo esteja pronto, monitorado e com um plano de volta.
addyosmani/agent-skills
using-agent-skills
Faz seu agente descobrir e usar outras habilidades. É útil para decidir qual ferramenta ou fluxo de trabalho usar para uma tarefa específica.
addyosmani/agent-skills