Communitygithub.com

homelab-network-readiness

Lista de verificação de preparação para segmentação VLAN, filtragem DNS local e acesso remoto estilo WireGuard antes de alterar configurações de roteador, firewall, DHCP ou VPN em um homelab.

O que é homelab-network-readiness?

Este skill orienta a revisão e o planejamento de mudanças em redes domésticas ou pequenos laboratórios que combinam VLANs, resolvedores DNS locais (como Pi-hole), regras de firewall e acesso remoto via VPN. O foco principal é evitar bloqueios de acesso e perda de conectividade durante alterações na infraestrutura de rede. Ele suporta plataformas como WireGuard, Tailscale, OpenVPN, Pi-hole, AdGuard Home, switches gerenciados e roteadores, mas não gera comandos específicos sem antes confirmar o ambiente e o plano de reversão. O skill coleta um inventário detalhado da borda da internet, gateway, switches, Wi-Fi, endereçamento, DNS/DHCP e planos de gerenciamento e recuperação. Em seguida, propõe um plano de zonas de confiança (VLANs), verifica a prontidão para filtragem DNS e acesso remoto, e sugere uma sequência de mudanças pequenas e reversíveis. Também identifica antipadrões comuns, como expor painéis de administração à internet pública ou mover estações de trabalho para redes inacessíveis. O resultado final é uma lista de verificação que deve ser revisada antes de qualquer alteração significativa na rede.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/homelab-network-readiness

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Preparação de Rede Homelab

Use este skill antes de alterar uma rede doméstica ou de pequeno laboratório que mistura VLANs, Pi-hole ou outro resolvedor DNS local, regras de firewall e acesso remoto via VPN.

Este é um skill de planejamento e revisão. Não o transforme em configuração copia-e-cola de roteador, firewall ou VPN a menos que a plataforma alvo, a topologia atual, o caminho de reversão, o acesso ao console e a janela de manutenção sejam todos conhecidos.

Quando Usar

  • Preparando para dividir uma rede plana em VLANs confiáveis, IoT, convidados, servidores ou gerenciamento.
  • Movendo clientes DHCP para Pi-hole, AdGuard Home, Unbound ou outro resolvedor DNS local.
  • Adicionando acesso via WireGuard, Tailscale, ZeroTier, OpenVPN ou VPN nativa 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 em etapas com evidências de validação.

Regras de Segurança

  • Mantenha a primeira resposta somente leitura: inventário, riscos, plano em etapas, validação e reversão.
  • Não exponha painéis administrativos do gateway, resolvedores DNS, SSH, consoles NAS ou interfaces de gerenciamento 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 da banda ou na mesma sala antes de alterar VLANs de gerência, portas trunk, políticas padrão de firewall ou configurações DHCP/DNS.
  • Mantenha um caminho funcional de volta à internet antes de apontar toda a rede para um novo resolvedor DNS ou rota VPN.
  • Trate redes 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 isto antes de fornecer etapas de implementação:

ÁreaPerguntas
Borda da internetQual é o modem ou ONT? O roteador ISP está em modo bridge ou ainda roteando?
GatewayQuais rotas, firewalls, DHCP e VPNs são gerenciados?
SwitchingQuais portas do switch são uplinks, portas de acesso, trunks ou não gerenciadas?
Wi-FiQuais SSIDs mapeiam para quais redes, e os APs são cabeados ou mesh?
EndereçamentoQuais sub-redes existem hoje e quais faixas conflitam com sites VPN?
DNS/DHCPQual serviço atualmente fornece concessões e endereços de resolvedor?
GerenciamentoComo o operador alcançará o gateway, switch e AP após as alterações?
RecuperaçãoO que pode ser revertido localmente se DNS, DHCP, VLANs ou rotas VPN falharem?

Plano de VLAN e Zonas de Confiança

Comece com a intenção, não com a sintaxe do fornecedor.

ZonaConteúdo típicoPolítica padrão
ConfiávelLaptops, telefones, estações de trabalho administrativasPode alcançar serviços compartilhados e gerência apenas quando necessário
ServidoresNAS, Home Assistant, hosts de laboratório, resolvedor DNSAceita fluxos de entrada estreitos de clientes confiáveis
IoTTVs, tomadas inteligentes, câmeras, alto-falantesAcesso à internet mais exceções explícitas apenas
ConvidadosDispositivos de visitantesSomente internet, sem alcance à LAN
GerenciamentoGateway, switches, APs, controladoresAcessível apenas de dispositivos administrativos confiáveis
VPNClientes remotosAcesso igual ou mais restrito que clientes confiáveis

Antes de recomendar IDs de VLAN ou sub-redes, confirme:

  1. O gateway suporta roteamento inter-VLAN e regras de firewall.
  2. O switch suporta o comportamento de porta marcada e não marcada necessário.
  3. Os APs podem mapear SSIDs para VLANs.
  4. O operador sabe por qual porta está conectado durante a alteração.
  5. A rede de gerenciamento permanece acessível após mudanças em trunk e SSID.

Prontidão para Filtragem DNS

Pi-hole ou outro resolvedor local deve ser introduzido como uma dependência, não como um ponto único de falha.

  1. Dê ao resolvedor um endereço reservado antes de usá-lo nas opções DHCP.
  2. Confirme que ele pode resolver nomes públicos e nomes locais home.arpa.
  3. Mantenha o gateway ou um segundo resolvedor disponível como fallback temporário.
  4. Teste um cliente ou uma VLAN antes de alterar todos os escopos DHCP.
  5. Documente quais redes podem ignorar a filtragem e por quê.
  6. 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 úteis de validação:

Cliente recebe concessão DHCP esperada
Cliente recebe resolvedor DNS esperado
Consulta DNS pública bem-sucedida
Consulta local home.arpa bem-sucedida
Domínio de teste bloqueado é bloqueado apenas onde pretendido
Interfaces administrativas do gateway e DNS não são acessíveis das redes convidados ou IoT

Prontidão para Acesso Remoto

Para acesso estilo WireGuard, decida o que a VPN pode alcançar antes de gerar chaves ou abrir portas.

ModoUse quandoAnotações de risco
Split tunnel para uma sub-redeAdministração remota de NAS ou hosts de laboratórioMantenha a lista de rotas estreita
Split tunnel para serviços confiáveisAcessar aplicativos selecionados por IP ou DNSRequer regras de firewall precisas
Full tunnelRedes não confiáveis ou viagemMais largura de banda e responsabilidade DNS
Overlay VPNAcesso remoto mais simples com controles de identidadeAinda precisa de revisão ACL

Não recomende encaminhamento de porta até que o operador confirme:

  • O endpoint VPN está corrigido e ativamente mantido.
  • A porta encaminhada vai apenas para o serviço VPN, não para uma interface administrativa.
  • DNS dinâmico, comportamento do IP público e status CGNAT do ISP são compreendidos.
  • Chaves de pares podem ser revogadas sem reconstruir toda a rede.
  • Logs ou status de conexão podem verificar quem se conectou e quando.

Sequência de Mudanças

Prefira mudanças pequenas e reversíveis:

  1. Capture a topologia atual, plano IP, configurações DHCP, configurações DNS e regras de firewall.
  2. Reserve endereços de infraestrutura para gateway, DNS, controlador, APs, NAS e endpoint VPN.
  3. Crie a nova zona ou VLAN sem mover dispositivos críticos.
  4. Mova um cliente de teste e valide DHCP, DNS, roteamento, internet e comportamento de bloqueio.
  5. Adicione exceções de firewall estreitas para fluxos necessários.
  6. Mova um grupo de dispositivos de baixo risco.
  7. Adicione acesso VPN com a rota e política de firewall mais estreitas que satisfaçam o caso de uso.
  8. Documente o estado final, exceções conhecidas e comandos ou etapas de interface de reversão.

Lista de Verificação de Revisão

  • Cada rede tem uma razão para existir e um limite de confiança claro.
  • Nenhuma interface de gerenciamento é acessível de convidados, IoT ou internet pública.
  • Falha de DNS não interrompe a capacidade do operador de recuperar localmente.
  • Alterações de escopo DHCP foram testadas em um cliente antes da implantação ampla.
  • Clientes VPN recebem apenas as rotas e configurações DNS de que precisam.
  • Regras de firewall são negação padrão entre zonas, com exceções nomeadas.
  • O operador ainda pode alcançar as superfícies administrativas do gateway, switch, AP, DNS e VPN.
  • A reversão está documentada no mesmo vocabulário da interface do usuário ou CLI da plataforma escolhida.

Antipadrões

  • Segmentar redes antes de saber quais portas de switch e SSIDs carregam quais VLANs.
  • Mover a estação de trabalho administrativa da única rede de gerenciamento acessível.
  • Apontar todos os escopos DHCP para um Pi-hole antes de testar fallback DNS.
  • Publicar administração de NAS, DNS, roteador ou hipervisor diretamente na internet.
  • Tratar acesso VPN como equivalente a acesso completo à LAN confiável.
  • Adicionar regras de firewall permitir-tudo temporariamente e esquecer de removê-las.
  • Copiar comandos de outro fornecedor ou versão de firmware sem verificar a sintaxe exata da plataforma.

Veja Também

  • Skill: homelab-network-setup
  • Skill: network-config-validation
  • Skill: network-interface-health

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Habilidades Relacionadas