Communitygithub.com

Configuração de Rede Homelab

Planejamento prático de rede doméstica e homelab para gateways, switches, pontos de acesso, faixas IP, reservas DHCP, DNS, cabeamento e erros comuns de iniciantes. Use ao planejar ou corrigir uma rede doméstica ou homelab — gateway, switch, AP, faixas IP, DHCP, DNS ou cabeamento.

O que é Configuração de Rede Homelab?

Esta habilidade orienta o planejamento e a configuração de redes domésticas e homelab, desde a escolha de hardware até a definição de esquemas de endereçamento IP, DHCP e DNS. Ela ajuda a evitar armadilhas comuns como double NAT, conflitos de sub-rede e falta de documentação. Suporta qualquer sistema operacional e plataforma de rede, como UniFi, OPNsense, pfSense, MikroTik ou roteadores Linux. O processo começa separando as funções dos dispositivos (gateway, switch, AP, servidores) e sugere boas práticas como usar `home.arpa` para nomes locais e reservar faixas IP que não conflitem com VPNs. Também aborda cabeamento, alimentação PoE e preparação para VLANs futuras, tornando-a útil tanto para iniciantes quanto para quem deseja expandir uma rede existente de forma organizada.

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

Perguntar na sua IA favorita

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

Documentação

O que Configuração de Rede Homelab faz?

Use esta habilidade para projetar uma rede doméstica ou de pequeno laboratório que possa crescer sem precisar de uma reconstrução completa.

Quando Usar

  • Planejando uma nova rede doméstica ou redesenho de uma configuração que usa apenas o roteador da operadora.
  • Escolhendo as funções de gateway, switch e ponto de acesso.
  • Projetando faixas IP, escopos DHCP, reservas estáticas e DNS.
  • Preparando para futuras VLANs, Pi-hole, NAS, servidores de laboratório ou acesso VPN.
  • Solucionando problemas em uma rede nova que apresenta double NAT, Wi-Fi instável ou mudanças constantes nos endereços dos servidores.

Como Funciona

Comece separando as funções dos dispositivos:

Internet
  |
Modem ou ONT
  |
Gateway ou roteador      NAT, firewall, DHCP, DNS, roteamento inter-VLAN
  |
Switch gerenciado         clientes cabeado, uplinks AP, trunks VLAN opcionais
  |
Pontos de acesso          Wi-Fi apenas; idealmente backhaul cabeado
Servidores e NAS          endereços estáveis, nomes DNS, monitoramento
Clientes e IoT            pools DHCP, isolados posteriormente se VLANs estiverem disponíveis

Escolha um gateway que corresponda à operadora, não apenas à lista de funcionalidades:

OpçãoMelhor paraNotas
Roteador da operadoraApenas internet básicaControle limitado e suporte a VLAN geralmente ruim
Gateway UniFiRede doméstica gerenciadaBoa interface, ecossistema fechado
OPNsense ou pfSenseHomelab flexívelForte controle de VLAN, firewall, VPN e DNS
MikroTikUsuários avançados de redePoderoso, mas fácil de configurar incorretamente
Roteador LinuxEntusiastasDocumente o rollback antes de usar como gateway principal

Plano IP

Evite o padrão mais comum, 192.168.1.0/24, quando você espera usar VPNs. Ele frequentemente entra em conflito com hotéis, escritórios e roteadores de operadoras.

Exemplo de plano de homelab pequeno:

192.168.10.0/24  clientes confiáveis
192.168.20.0/24  dispositivos IoT e mídia
192.168.30.0/24  servidores e NAS
192.168.40.0/24  Wi-Fi para convidados
192.168.99.0/24  gerenciamento de rede

Convenção de gateway: .1
Reservas para infraestrutura: .2 a .49
Pool DHCP dinâmico: .50 a .240
Espaço sobressalente: .241 a .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 dispositivo no qual você faça SSH, que adicione aos favoritos, monitore ou exponha como serviço.
  • Distribua o gateway como DNS até que um resolvedor local seja implantado intencionalmente.
  • Se usar Pi-hole ou outro filtro DNS, dê a ele uma reserva primeiro, depois aponte as opções de DNS do DHCP para esse endereço.
  • Mantenha uma pequena faixa estática/reservada por sub-rede para que substituições não colidam com leases dinâmicos.

Cabeamento e Wi-Fi

  • Prefira backhaul cabeado para APs em vez de mesh quando puder passar Ethernet.
  • Use um switch PoE para APs e câmeras se o orçamento permitir.
  • Identifique 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 quedas de energia forem frequentes.

Exemplos

Atualização para Iniciantes

Objetivo: Manter o roteador da operadora, mas estabilizar um pequeno laboratório.

  1. Defina reservas DHCP para NAS, Pi e qualquer host SSH.
  2. Mova os nomes locais para home.arpa.
  3. Desative servidores DHCP duplicados em roteadores secundários ou APs.
  4. Conecte o AP principal via cabo em vez de depender de backhaul sem fio.

Plano Pronto para VLANs

Objetivo: Preparar para segmentação futura sem ativá-la imediatamente.

  1. Escolha faixas /24 não sobrepostas para clientes confiáveis, IoT, servidores, convidados e gerenciamento.
  2. Reserve .1 para o gateway e .2-.49 para infraestrutura em cada sub-rede.
  3. Compre um gateway e switch que suportem VLANs e regras de firewall inter-VLAN.
  4. Documente quais SSIDs e portas do switch serão eventualmente mapeados para cada rede.

Anti-Padrões

  • Double NAT sem motivo ou documentação.
  • Usar 192.168.1.0/24 quando o acesso VPN está planejado.
  • Endereços dinâmicos para NAS, Pi-hole, Home Assistant ou outros hosts de serviço.
  • Roteadores de consumo reaproveitados como APs enquanto seus servidores DHCP ainda estão ativos.
  • Redes planas com câmeras, plugs inteligentes, laptops e servidores todos compartilhando o mesmo limite de confiança.

Veja Também

  • Habilidade: network-interface-health
  • Habilidade: network-config-validation

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