Communitygithub.com

homelab-network-readiness

Lista de verificación de preparación para segmentación VLAN, filtrado de DNS local y acceso remoto estilo WireGuard antes de cambiar la configuración del router, firewall, DHCP o VPN en un laboratorio doméstico.

¿Qué es homelab-network-readiness?

Esta skill proporciona una lista de verificación estructurada y basada en seguridad para planificar cambios en redes de laboratorios domésticos (homelab) que combinan VLANs, resolutores DNS locales (como Pi-hole) y acceso remoto mediante VPN (WireGuard, Tailscale, etc.). Su objetivo principal es evitar bloqueos del operador, exponer riesgos de seguridad y guiar al usuario hacia una migración por etapas con rollback documentado. Está diseñada para ser una herramienta de revisión y planificación, no de ejecución directa de comandos: exige confirmar plataforma, topología actual, ruta de rollback y ventana de mantenimiento antes de proporcionar pasos de implementación. La skill es útil para administradores de TI, entusiastas de homelab y desarrolladores que gestionan redes pequeñas con múltiples zonas de confianza, ya que organiza la preparación en áreas clave: inventario de equipos, plan de VLANs/zonas de confianza, preparación para filtrado DNS, configuración de acceso remoto y una secuencia de cambios segura. También identifica antipatrones comunes y proporciona una lista de verificación final para garantizar que la red modificada siga siendo gestionable, segura y recuperable.

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

Preguntar en tu IA favorita

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

Documentación

Homelab Network Readiness

Utiliza esta skill antes de realizar cambios en una red doméstica o de laboratorio pequeño que combine VLANs, Pi-hole u otro resolutor DNS local, reglas de firewall y acceso VPN remoto.

Esta es una skill de planificación y revisión. No la conviertas en comandos de copiar y pegar para el router, firewall o VPN a menos que la plataforma de destino, la topología actual, la ruta de reversión, el acceso a la consola y la ventana de mantenimiento sean todos conocidos.

Cuándo Usarla

  • Prepararse para dividir una red plana en VLANs de confianza, IoT, invitados, servidores o administración.
  • Mover clientes DHCP a Pi-hole, AdGuard Home, Unbound u otro resolutor DNS local.
  • Agregar acceso mediante WireGuard, Tailscale, ZeroTier, OpenVPN o VPN nativa del router.
  • Revisar si un cambio en el homelab puede bloquear al operador del gateway, switch, punto de acceso, servidor DNS o servidor VPN.
  • Convertir una idea informal de red doméstica en un plan de migración por etapas con evidencia de validación.

Reglas de Seguridad

  • Mantén la primera respuesta como solo lectura: inventario, riesgos, plan por etapas, validación y reversión.
  • No expongas paneles de administración de gateway, resolutores DNS, SSH, consolas NAS o interfaces de gestión de VPN directamente a Internet público.
  • No proporciones comandos de firewall, NAT, VLAN, DHCP o VPN sin una plataforma confirmada y un procedimiento de reversión.
  • Exige acceso fuera de banda o en la misma sala antes de cambiar VLANs de gestión, puertos trunk, políticas predeterminadas del firewall o configuraciones DHCP/DNS.
  • Mantén una ruta de retorno a Internet antes de dirigir toda la red hacia un nuevo resolutor DNS o ruta VPN.
  • Trata las redes de IoT, invitados, cámaras y servidores de laboratorio como diferentes zonas de confianza hasta que el operador decida explícitamente lo contrario.

Inventario Necesario

Recopila esto antes de proporcionar pasos de implementación:

ÁreaPreguntas
Borde de Internet¿Cuál es el módem u ONT? ¿El router del ISP está en modo puente o aún enrutando?
Gateway¿Qué enruta, cortafuegos, maneja DHCP y termina VPNs?
Conmutación¿Qué puertos del switch son uplinks, puertos de acceso, trunks o no gestionados?
Wi-Fi¿Qué SSID se asignan a qué redes, y los APs están cableados o en malla?
Direccionamiento¿Qué subredes existen hoy, y qué rangos entran en conflicto con sitios VPN?
DNS/DHCP¿Qué servicio otorga actualmente concesiones y direcciones de resolutor?
Gestión¿Cómo llegará el operador al gateway, switch y AP después de los cambios?
Recuperación¿Qué se puede revertir localmente si fallan DNS, DHCP, VLANs o rutas VPN?

Plan de VLANs y Zonas de Confianza

Comienza con la intención en lugar de la sintaxis del proveedor.

ZonaContenido típicoPolítica predeterminada
ConfianzaPortátiles, teléfonos, estaciones de trabajo de administraciónPuede alcanzar servicios compartidos y gestión solo cuando sea necesario
ServidoresNAS, Home Assistant, hosts de laboratorio, resolutor DNSAcepta flujos entrantes limitados de clientes de confianza
IoTTVs, enchufes inteligentes, cámaras, altavocesSolo acceso a Internet más excepciones explícitas
InvitadosDispositivos de visitantesSolo Internet, sin alcance a la LAN
GestiónGateway, switches, APs, controladoresAccesible solo desde dispositivos de administración de confianza
VPNClientes remotosMismo o más restrictivo que los clientes de confianza

Antes de recomendar IDs de VLAN o subredes, confirma:

  1. El gateway admite enrutamiento entre VLANs y reglas de firewall.
  2. El switch admite el comportamiento de puertos etiquetados y sin etiquetar requerido.
  3. Los APs pueden mapear SSIDs a VLANs.
  4. El operador sabe por qué puerto está conectado durante el cambio.
  5. La red de gestión sigue siendo alcanzable después de cambios en trunks y SSIDs.

Preparación para Filtrado DNS

Pi-hole u otro resolutor local debe introducirse como una dependencia, no como un punto único de fallo.

  1. Asigna al resolutor una dirección reservada antes de usarla en las opciones de DHCP.
  2. Confirma que puede resolver DNS público y nombres locales home.arpa.
  3. Mantén el gateway o un segundo resolutor disponible como fallback temporal.
  4. Prueba un cliente o una VLAN antes de cambiar cada ámbito DHCP.
  5. Documenta qué redes pueden omitir el filtrado y por qué.
  6. Verifica que las reglas de bloqueo no afecten portales cautivos, VPNs de trabajo, actualizaciones de firmware o dispositivos médicos/de seguridad.

Evidencia de validación útil:

El cliente recibe la concesión DHCP esperada
El cliente recibe el resolutor DNS esperado
La consulta DNS pública se resuelve correctamente
La consulta local home.arpa se resuelve correctamente
El dominio de prueba bloqueado se bloquea solo donde se pretende
Las interfaces de administración del gateway y DNS no son accesibles desde redes de invitados o IoT

Preparación para Acceso Remoto

Para acceso estilo WireGuard, decide a qué se permite que acceda la VPN antes de generar claves o abrir puertos.

ModoCuándo usarloNotas de riesgo
Túnel dividido a una subredAdministración remota de NAS o hosts de laboratorioMantén la lista de rutas limitada
Túnel dividido a servicios de confianzaAcceder a aplicaciones seleccionadas por IP o DNSRequiere reglas de firewall precisas
Túnel completoRedes no confiables o viajesMás ancho de banda y responsabilidad de DNS
VPN superpuestaAcceso remoto más simple con controles de identidadAún necesita revisión de ACL

No recomiendes reenvío de puertos hasta que el operador confirme:

  • El punto final de VPN está parcheado y mantenido activamente.
  • El puerto reenviado va solo al servicio VPN, no a una interfaz de administración.
  • Se entiende DNS dinámico, comportamiento de IP pública y estado CGNAT del ISP.
  • Las claves de los peers se pueden revocar sin reconstruir toda la red.
  • Los registros o el estado de conexión pueden verificar quién se conectó y cuándo.

Secuencia de Cambios

Prefiere cambios pequeños y reversibles:

  1. Captura la topología actual, plan IP, configuración DHCP, configuración DNS y reglas de firewall.
  2. Reserva direcciones de infraestructura para gateway, DNS, controlador, APs, NAS y punto final VPN.
  3. Crea la nueva zona o VLAN sin mover dispositivos críticos.
  4. Mueve un cliente de prueba y valida DHCP, DNS, enrutamiento, internet y comportamiento de bloqueo.
  5. Agrega excepciones de firewall estrechas para los flujos necesarios.
  6. Mueve un grupo de dispositivos de bajo riesgo.
  7. Agrega acceso VPN con la ruta y política de firewall más estrechas que satisfagan el caso de uso.
  8. Documenta el estado final, las excepciones conocidas y los comandos o pasos de IU de reversión.

Lista de Verificación de Revisión

  • Cada red tiene una razón de existir y un límite de confianza claro.
  • Ninguna interfaz de gestión es accesible desde invitados, IoT o Internet público.
  • Un fallo de DNS no imposibilita la capacidad del operador para recuperarse localmente.
  • Los cambios en el ámbito DHCP se probaron en un cliente antes de una implementación amplia.
  • Los clientes VPN reciben solo las rutas y configuraciones DNS que necesitan.
  • Las reglas de firewall son denegación predeterminada entre zonas, con excepciones nombradas.
  • El operador aún puede llegar a las superficies de administración del gateway, switch, AP, DNS y VPN.
  • La reversión está documentada en el mismo vocabulario que la IU o CLI de la plataforma elegida.

Antipatrones

  • Segmentar redes antes de conocer qué puertos del switch y qué SSIDs transportan qué VLANs.
  • Mover la estación de trabajo de administración fuera de la única red de gestión alcanzable.
  • Apuntar todos los ámbitos DHCP a un Pi-hole antes de probar el DNS de respaldo.
  • Publicar NAS, DNS, router o gestión de hipervisor directamente en Internet.
  • Tratar el acceso VPN como equivalente al acceso completo a la LAN de confianza.
  • Agregar reglas de firewall de permiso total temporalmente y olvidar eliminarlas.
  • Copiar comandos de otro proveedor o versión de firmware sin verificar la sintaxis exacta de la plataforma.

Ver También

  • 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.

Skills relacionados