homelab-network-setup
Planeja redes domésticas e de homelab, cobrindo gateways, switches, IPs e DNS.
O que ela faz
Ajuda a planejar e organizar a rede da sua casa ou pequeno laboratório. Isso inclui decidir quais equipamentos usar (roteador, switch, Wi-Fi), como organizar os endereços de internet (IP) e nomes, e como conectar tudo.
Quando usar
- ✓Ao montar uma nova rede em casa.
- ✓Ao querer melhorar a rede atual com mais equipamentos.
- ✓Ao ter problemas com a internet ou Wi-Fi.
Exemplo do que pedir para a IA
“Quero montar uma rede para minha casa, tenho um modem da operadora e quero adicionar um roteador melhor, um switch e dois pontos de Wi-Fi. Como devo planejar os endereços IP e quais equipamentos seriam bons?”
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
A IA sugere separar os equipamentos por função (roteador, switch, Wi-Fi) e ajuda a escolher os tipos certos. Ela também propõe um plano de endereços IP para evitar conflitos e organizar os dispositivos.
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-setupOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/homelab-network-setup/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.
Configuração de Rede Homelab
Use esta habilidade para projetar uma rede doméstica ou de pequeno laboratório que possa crescer sem a necessidade de uma reconstrução completa.
Quando Usar
- Planejando uma nova rede doméstica ou redesenhando uma configuração apenas com roteador de ISP.
- Escolhendo funções de gateway, switch e ponto de acesso.
- Projetando intervalos de IP, escopos DHCP, reservas estáticas e DNS.
- Preparando-se para futuras VLANs, Pi-hole, NAS, servidores de laboratório ou acesso VPN.
- Solucionando problemas de uma nova rede que tem NAT duplo, Wi-Fi instável ou endereços de servidor em mudança.
Como Funciona
Comece separando as funções dos dispositivos:
Internet
|
Modem or ONT
|
Gateway or router NAT, firewall, DHCP, DNS, inter-VLAN routing
|
Managed switch wired clients, AP uplinks, optional VLAN trunks
|
Access points Wi-Fi only; ideally wired backhaul
Servers and NAS stable addresses, DNS names, monitoring
Clients and IoT DHCP pools, isolated later if VLANs are available
Escolha um gateway que corresponda ao operador, não apenas à lista de recursos:
| Opção | Melhor ajuste | Notas |
|---|---|---|
| Roteador do ISP | Apenas internet básica | Controle limitado e suporte a VLAN geralmente ruim |
| Gateway UniFi | Rede doméstica gerenciada | Boa interface de usuário, dependência do ecossistema |
| OPNsense ou pfSense | Homelab flexível | Forte controle de VLAN, firewall, VPN e DNS |
| MikroTik | Usuários avançados de rede | Poderoso, mas fácil de configurar incorretamente |
| Roteador Linux | Entusiastas | Documente o rollback antes de usar como gateway principal |
Plano de IP
Evite o padrão mais comum, 192.168.1.0/24, quando você espera usar VPNs.
Frequentemente, ele entra em conflito com hotéis, escritórios e roteadores de ISP.
Example small homelab plan:
192.168.10.0/24 trusted clients
192.168.20.0/24 IoT and media devices
192.168.30.0/24 servers and NAS
192.168.40.0/24 guest Wi-Fi
192.168.99.0/24 network management
Gateway convention: .1
Infrastructure reservations: .2 through .49
Dynamic DHCP pool: .50 through .240
Spare room: .241 through .254
Use home.arpa para nomes locais. Ele é reservado para redes domésticas e evita os problemas de vazamento/conflito de nomes ad hoc como home.lan.
nas.home.arpa
pihole.home.arpa
gateway.home.arpa
switch-01.home.arpa
DHCP E DNS
- Use reservas DHCP para qualquer coisa que você acesse via SSH, marque nos favoritos, monitore ou exponha como um serviço.
- Atribua o gateway como DNS até que um resolvedor local seja intencionalmente implantado.
- Se estiver usando Pi-hole ou outro filtro de DNS, primeiro dê uma reserva a ele e, em seguida, aponte as opções de DNS do DHCP para esse endereço.
- Mantenha um pequeno intervalo estático/reservado por sub-rede para que as substituições não colidam com os leases dinâmicos.
Cabeamento E Wi-Fi
- Prefira backhaul com fio para APs em vez de mesh quando puder executar Ethernet.
- Use um switch PoE para APs e câmeras se o orçamento permitir.
- Rotule ambas as extremidades de cada cabo e mantenha um mapa de portas simples.
- Coloque o gateway, switch, servidor DNS e NAS em energia UPS se as interrupções forem comuns.
Exemplos
Upgrade para Iniciantes
Objetivo: Manter o roteador do ISP, mas estabilizar um pequeno laboratório.
- Defina reservas DHCP para NAS, Pi e quaisquer hosts SSH.
- Mova os nomes locais para
home.arpa. - Desabilite servidores DHCP duplicados em roteadores ou APs secundários.
- Conecte o AP principal com fio em vez de depender do backhaul sem fio.
Plano Pronto para VLAN
Objetivo: Preparar-se para segmentação futura sem ativá-la imediatamente.
- Escolha intervalos /24 não sobrepostos para confiáveis, IoT, servidores, convidados e gerenciamento.
- Reserve .1 para o gateway e .2-.49 para infraestrutura em cada sub-rede.
- Compre um gateway e um switch que suportem VLANs e regras de firewall entre VLANs.
- Documente quais SSIDs e portas de switch eventualmente mapearão para cada rede.
Anti-Padrões
- NAT duplo sem motivo ou documentação.
- Usar
192.168.1.0/24quando o acesso VPN for planejado. - Endereços dinâmicos para NAS, Pi-hole, Home Assistant ou outros hosts de serviço.
- Roteadores de consumo reutilizados como APs enquanto seus servidores DHCP ainda estão ativados.
- Redes planas com câmeras, tomadas inteligentes, laptops e servidores compartilhando o mesmo limite de confiança.
Veja Também
- Habilidade:
network-interface-health - Habilidade:
network-config-validation
Perguntas frequentes
Por que não usar o IP padrão 192.168.1.0/24?
Esse é um endereço muito comum, usado por muitos roteadores e em locais públicos. Usá-lo pode causar conflitos quando você se conecta a outras redes, como em hotéis ou no trabalho, especialmente se estiver usando VPN.
O que são 'reservas DHCP'?
É como dar um endereço IP fixo para um aparelho específico na sua rede. Isso é útil para dispositivos que precisam ser encontrados sempre no mesmo lugar, como um servidor ou um sistema de segurança.
O que é 'VLAN'?
VLAN é uma forma de dividir sua rede em partes menores e separadas. Por exemplo, você pode colocar seus dispositivos de segurança em uma VLAN e seus computadores em outra, aumentando a segurança.
Detalhes
Descrição original do autor
Practical home and homelab network planning for gateways, switches, access points, IP ranges, DHCP reservations, DNS, cabling, and common beginner mistakes. Use when planning or fixing a home or homelab network — gateway, switch, AP, IP ranges, DHCP, DNS, or cabling.
repo: affaan-m/ECC
Popularidade
- Estrelas no GitHub
- 280 mil
- Posição no ranking
- #207
- 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