Communitygithub.com

homelab-network-readiness

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

O que é homelab-network-readiness?

Esta skill fornece um checklist estruturado de prontidão para ambientes de homelab ou pequenos laboratórios que misturam VLANs, resolvedores DNS locais como Pi-hole, regras de firewall e acesso remoto VPN. Ela é uma skill de planejamento e revisão, projetada para evitar bloqueios operacionais e perda de acesso durante mudanças críticas na rede. A skill orienta o usuário a fazer um inventário completo dos equipamentos de borda, gateway, switches, Wi-Fi, endereçamento e DNS/DHCP antes de propor qualquer alteração. Além disso, ela aborda o planejamento de zonas de confiança (VLANs), introdução segura de filtragem DNS, configuração de acesso remoto estilo WireGuard/Tailscale e uma sequência de mudanças graduais com validação e rollback documentados. Útil para engenheiros de rede, entusiastas de homelab e administradores de TI que precisam planejar migrações de rede sem interromper serviços ou causar bloqueios de acesso remoto. A skill suporta qualquer plataforma (roteadores, switches, APs) e enfatiza a segurança, a revisão de dependências e a prevenção de anti-padrões comuns.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/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

Prontidão da Rede de Homelab

Use esta 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 VPN remoto.

Esta é uma skill de planejamento e revisão. Não a transforme em configuração copiar-e-colar 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

  • Preparar-se para dividir uma rede plana em VLANs de confiança, IoT, convidados, servidores ou gerenciamento.
  • Mover clientes DHCP para Pi-hole, AdGuard Home, Unbound ou outro resolvedor DNS local.
  • Adicionar acesso WireGuard, Tailscale, ZeroTier, OpenVPN ou VPN nativa do roteador.
  • Revisar se uma alteração no homelab pode bloquear o operador do gateway, switch, ponto de acesso, servidor DNS ou servidor VPN.
  • Transformar 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 de administração de 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 fora da banda ou console na mesma sala antes de alterar VLANs de gerenciamento, portas trunk, políticas padrão de firewall ou configurações DHCP/DNS.
  • Mantenha um caminho funcional de volta à internet antes de direcionar 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 isso 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?
GatewayQue rotas, firewalls, gerencia DHCP e termina VPNs?
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 com fio ou mesh?
EndereçamentoQuais sub-redes existem hoje, e quais intervalos entram em conflito com sites VPN?
DNS/DHCPQual serviço atualmente distribui leases 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 quebrarem?

Plano de VLAN e Zonas de Confiança

Comece pela intenção, não pela sintaxe do fornecedor.

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

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

  1. O gateway suporta roteamento entre VLANs e regras de firewall.
  2. O switch suporta o comportamento de porta marcada (tagged) e não marcada (untagged) necessário.
  3. Os APs podem mapear SSIDs para VLANs.
  4. O operador sabe qual porta eles estão conectados durante a alteração.
  5. A rede de gerenciamento permanece acessível após alterações de trunk e SSID.

Prontidão de Filtragem DNS

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

  1. Atribua um endereço reservado ao resolvedor antes de usá-lo nas opções DHCP.
  2. Confirme que ele pode resolver DNS público 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 de validação úteis:

Cliente recebe lease DHCP esperado
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 de administração do gateway e DNS não são acessíveis de redes convidadas ou IoT

Prontidão de Acesso Remoto

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

ModoUse quandoNotas de risco
Túnel dividido para uma sub-redeAdministração remota de NAS ou hosts de laboratórioMantenha a lista de rotas estreita
Túnel dividido para serviços confiáveisAcessar aplicativos selecionados por IP ou DNSRequer regras de firewall precisas
Túnel completoRedes não confiáveis ou viagensMais largura de banda e responsabilidade DNS
VPN overlayAcesso remoto mais simples com controles de identidadeAinda precisa de revisão de ACL

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

  • O endpoint VPN está corrigido e mantido ativamente.
  • A porta encaminhada vai apenas para o serviço VPN, não para uma interface de administração.
  • DNS dinâmico, comportamento de 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. Faça um snapshot da 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 de reversão ou etapas da interface.

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 da internet pública.
  • A falha de DNS não derruba a capacidade do operador de recuperar localmente.
  • Mudanças no escopo DHCP foram testadas em um cliente antes da implementação ampla.
  • Clientes VPN recebem apenas as rotas e configurações DNS que precisam.
  • Regras de firewall são padrão-negado entre zonas, com exceções nomeadas.
  • O operador ainda pode alcançar as superfícies de administração do gateway, switch, AP, DNS e VPN.
  • A reversão está documentada no mesmo vocabulário da interface ou CLI da plataforma escolhida.

Anti-Padrões

  • Segmentar redes antes de saber quais portas de switch e SSIDs carregam quais VLANs.
  • Mover a estação de trabalho de administração para fora da única rede de gerenciamento acessível.
  • Apontar todos os escopos DHCP para um Pi-hole antes de testar DNS de fallback.
  • Publicar NAS, DNS, roteador ou gerenciamento de 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/content-engine

Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns. Use when the user wants social posts, threads, scripts, content calendars, or one source asset adapted cleanly across platforms.

affaan-m/ECC

Multi-platform content distribution across X, LinkedIn, Threads, and Bluesky. Adapts content per platform using content-engine patterns. Never posts identical content cross-platform. Use when the user wants to distribute content across social platforms.

affaan-m/fal-ai-media

Unified media generation via fal.ai MCP — image, video, and audio. Covers text-to-image (Nano Banana), text/image-to-video (Seedance, Kling, Veo 3), text-to-speech (CSM-1B), and video-to-audio (ThinkSound). Use when the user wants to generate images, videos, or audio with AI.

affaan-m/manim-video

日本語翻訳:このファイルは manim-video 用の日本語翻訳が必要です

affaan-m/remotion-video-creation

Remotion のベストプラクティス - React で動画を作成する。3D、アニメーション、音声、字幕、チャート、トランジションなどをカバーするドメイン固有の29のルール。

affaan-m/video-editing

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

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.

agent-self-evaluation

Use after completing any non-trivial task. The agent self-rates its output on 5 axes — accuracy, completeness, clarity, actionability, conciseness — with concrete evidence per criterion. Produces a structured 1-5 scorecard with specific improvement suggestions.

agent-sort

Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.

ai-first-engineering

Engineering operating model for teams where AI agents generate a large share of implementation output. Use when setting team process, review gates, or ownership rules for a codebase largely written by agents.

ai-regression-testing

Regression testing strategies for AI-assisted development. Sandbox-mode API testing without database dependencies, automated bug-check workflows, and patterns to catch AI blind spots where the same model writes and reviews code. Use when adding regression coverage to AI-assisted code, or when the same model both wrote and reviewed a change.

android-clean-architecture

Clean Architecture patterns for Android and Kotlin Multiplatform projects — module structure, dependency rules, UseCases, Repositories, and data layer patterns. Use when structuring modules, layers, or data flow in an Android or KMP project.

angular-developer

Generates Angular code and provides architectural guidance. Trigger when creating projects, components, or services, or for best practices on reactivity (signals, linkedSignal, resource), forms, dependency injection, routing, SSR, accessibility (ARIA), animations, styling (component styles, Tailwind CSS), testing, or CLI tooling.

Habilidades Relacionadas