Communitygithub.com

configuración-de-red-homelab

Planificación práctica de redes para hogar y homelab: pasarelas, switches, puntos de acceso, rangos IP, reservas DHCP, DNS, cableado y errores comunes para principiantes.

¿Qué es configuración-de-red-homelab?

Esta skill aborda el diseño y la resolución de problemas de redes domésticas y de homelab, desde la elección de componentes (pasarela, switch, punto de acceso) hasta la planificación de direcciones IP, DHCP, DNS y cableado. Es especialmente útil para evitar configuraciones frágiles que requieran una reconstrucción total más adelante. Soporta planificación básica con router ISP, así como configuraciones avanzadas con OPNsense, pfSense, MikroTik o Linux, y prepara el camino para VLANs, Pi-hole, NAS y VPN. La skill enfatiza buenas prácticas como usar el dominio `home.arpa`, evitar el rango `192.168.1.0/24` cuando se usen VPN, mantener reservas DHCP para servicios críticos y preferir backhaul cableado para puntos de acceso.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Configuración de Red Homelab

Usa esta skill para diseñar una red doméstica o de pequeño laboratorio que pueda crecer sin necesidad de una reconstrucción completa.

Cuándo Usarla

  • Planificar una nueva red doméstica o rediseñar una configuración basada solo en el router del ISP.
  • Elegir los roles de pasarela, switch y punto de acceso.
  • Diseñar rangos IP, ámbitos DHCP, reservas estáticas y DNS.
  • Prepararse para futuras VLANs, Pi-hole, NAS, servidores de laboratorio o acceso VPN.
  • Solucionar problemas en una red nueva que presenta doble NAT, Wi-Fi inestable o direcciones de servidor cambiantes.

Cómo Funciona

Comienza separando los roles de los dispositivos:

Internet
  |
Módem u ONT
  |
Pasarela o router      NAT, cortafuegos, DHCP, DNS, enrutamiento entre VLANs
  |
Switch gestionado      clientes cableados, uplinks de AP, troncales VLAN opcionales
  |
Puntos de acceso       solo Wi-Fi; idealmente con backhaul cableado
Servidores y NAS        direcciones estables, nombres DNS, monitorización
Clientes e IoT          pools DHCP, aislados más tarde si hay VLANs disponibles

Elige una pasarela que se ajuste al operador, no solo a la lista de funciones:

OpciónMejor paraNotas
Router ISPSolo Internet básicoControl limitado y a menudo soporte VLAN deficiente
Pasarela UniFiRed doméstica gestionadaBuena interfaz, dependencia del ecosistema
OPNsense o pfSenseHomelab flexibleFuerte control de VLAN, cortafuegos, VPN y DNS
MikroTikUsuarios de red avanzadosPotente, pero fácil de configurar incorrectamente
Router LinuxAficionadosDocumentar el rollback antes de usarlo como pasarela principal

Plan IP

Evita el valor predeterminado más común, 192.168.1.0/24, cuando planees usar VPNs. A menudo entra en conflicto con hoteles, oficinas y routers ISP.

Ejemplo de plan para homelab pequeño:

192.168.10.0/24  clientes de confianza
192.168.20.0/24  dispositivos IoT y medios
192.168.30.0/24  servidores y NAS
192.168.40.0/24  Wi-Fi para invitados
192.168.99.0/24  gestión de red

Convención de pasarela: .1
Reservas de infraestructura: .2 a .49
Pool DHCP dinámico: .50 a .240
Espacio libre: .241 a .254

Usa home.arpa para nombres locales. Está reservado para redes domésticas y evita los problemas de fuga/conflicto de nombres ad hoc como home.lan.

nas.home.arpa
pihole.home.arpa
gateway.home.arpa
switch-01.home.arpa

DHCP Y DNS

  • Usa reservas DHCP para cualquier equipo al que te conectes por SSH, marques como favorito, monitorees o expongas como servicio.
  • Entrega la pasarela como DNS hasta que se implemente intencionadamente un resolvedor local.
  • Si usas Pi-hole u otro filtro DNS, asígnale primero una reserva, luego apunta las opciones DNS de DHCP a esa dirección.
  • Mantén un pequeño rango estático/reservado por subred para que los reemplazos no colisionen con las concesiones dinámicas.

Cableado Y Wi-Fi

  • Prefiere backhaul cableado para puntos de acceso en lugar de malla cuando puedas tender Ethernet.
  • Usa un switch PoE para puntos de acceso y cámaras si el presupuesto lo permite.
  • Etiqueta ambos extremos de cada cable y mantén un mapa de puertos simple.
  • Conecta la pasarela, el switch, el servidor DNS y el NAS a un SAI si los cortes de luz son frecuentes.

Ejemplos

Actualización para Principiantes

Objetivo: Mantener el router ISP pero estabilizar un laboratorio pequeño.

  1. Configura reservas DHCP para NAS, Raspberry Pi y cualquier equipo SSH.
  2. Cambia los nombres locales a home.arpa.
  3. Desactiva servidores DHCP duplicados en routers o puntos de acceso secundarios.
  4. Conecta el punto de acceso principal por cable en lugar de usar backhaul inalámbrico.

Plan Preparado para VLANs

Objetivo: Prepararse para una segmentación futura sin activarla de inmediato.

  1. Elige rangos /24 que no se superpongan para clientes de confianza, IoT, servidores, invitados y gestión.
  2. Reserva .1 para la pasarela y .2-.49 para infraestructura en cada subred.
  3. Compra una pasarela y un switch que soporten VLANs y reglas de cortafuegos entre VLANs.
  4. Documenta qué SSIDs y puertos del switch se asignarán finalmente a cada red.

Anti-Patrones

  • Doble NAT sin motivo ni documentación.
  • Usar 192.168.1.0/24 cuando se planea acceso VPN.
  • Direcciones dinámicas para NAS, Pi-hole, Home Assistant u otros hosts de servicio.
  • Routers de consumo reutilizados como puntos de acceso pero con sus servidores DHCP aún activos.
  • Redes planas donde cámaras, enchufes inteligentes, portátiles y servidores comparten el mismo límite de confianza.

Ver También

  • Skill: network-interface-health
  • Skill: 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.

Skills relacionados