Communitygithub.com

homelab-network-readiness

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

¿Qué es homelab-network-readiness?

Este skill proporciona una lista de verificación estructurada y pasos de revisión para planificar cambios en la red de un laboratorio doméstico o pequeña oficina que involucre VLANs, DNS local (como Pi-hole), reglas de firewall y acceso remoto VPN. Esencial para evitar bloqueos del operador y garantizar una implementación segura, enfatiza la validación, la reversión y la seguridad por zonas de confianza. Soporta plataformas como routers, switches, puntos de acceso y servidores DNS/DHCP, y se enfoca en la planificación previa a la configuración. El skill guía al usuario a través de la recopilación de inventario, la planificación de zonas, la preparación de filtrado DNS y acceso remoto, y una secuencia de cambios reversibles, destacando anti-patrones comunes para evitar problemas de conectividad y seguridad.

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

Preguntar en tu IA favorita

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

Documentación

Preparación de la Red del Laboratorio Doméstico (Homelab)

Use este skill antes de cambiar una red doméstica o de laboratorio pequeño que mezcle VLANs, Pi-hole u otro resolvedor de DNS local, reglas de firewall y acceso VPN remoto.

Este es un skill de planificación y revisión. No lo convierta en configuración de copiar y pegar para el router, firewall o VPN a menos que se conozcan la plataforma de destino, la topología actual, la ruta de reversión, el acceso a la consola y la ventana de mantenimiento.

Cuándo Usarlo

  • Preparándose para dividir una red plana en VLANs de confianza, IoT, invitados, servidores o gestión.
  • Moviendo clientes DHCP a Pi-hole, AdGuard Home, Unbound u otro resolvedor de DNS local.
  • Agregando acceso VPN con WireGuard, Tailscale, ZeroTier, OpenVPN o VPN nativa del router.
  • Revisando si un cambio en el laboratorio doméstico puede bloquear al operador del gateway, switch, punto de acceso, servidor DNS o servidor VPN.
  • Convirtiendo una idea informal de red doméstica en un plan de migración por etapas con evidencia de validación.

Reglas de Seguridad

  • Mantenga la primera respuesta de solo lectura: inventario, riesgos, plan por etapas, validación y reversión.
  • No exponga paneles de administración de gateway, resolvedores DNS, SSH, consolas NAS o interfaces de gestión de VPN directamente a internet público.
  • No proporcione comandos de firewall, NAT, VLAN, DHCP o VPN sin una plataforma confirmada y un procedimiento de reversión.
  • Exija acceso de consola fuera de banda o en la misma sala antes de cambiar VLANs de gestión, puertos troncales, políticas predeterminadas del firewall o configuraciones de DHCP/DNS.
  • Mantenga una ruta de trabajo de regreso a internet antes de dirigir toda la red a un nuevo resolvedor DNS o ruta VPN.
  • Trate las redes de IoT, invitados, cámaras y servidores de laboratorio como zonas de confianza diferentes hasta que el operador elija explícitamente lo contrario.

Inventario Requerido

Recolecte esto antes de dar pasos de implementación:

ÁreaPreguntas
Borde de internet¿Cuál es el módem o la ONT? ¿El router del ISP está en modo puente o sigue encaminando?
Gateway¿Qué rutas, firewalls, maneja DHCP y termina VPNs?
Conmutación¿Qué puertos del switch son enlaces de subida, puertos de acceso, troncales o no gestionados?
Wi-Fi¿Qué SSID se asignan a qué redes, y los puntos de acceso son cableados o en malla?
Direccionamiento¿Qué subredes existen hoy, y qué rangos entran en conflicto con sitios VPN?
DNS/DHCP¿Qué servicio otorga actualmente las concesiones y las direcciones del resolvedor?
Gestión¿Cómo llegará el operador al gateway, switch y punto de acceso 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

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

ZonaContenido típicoPolítica predeterminada
Confianza (Trusted)Portá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, resolvedor DNSAcepta flujos de entrada estrechos desde clientes de confianza
IoTTVs, enchufes inteligentes, cámaras, altavocesAcceso a internet más excepciones explícitas solamente
Invitados (Guest)Dispositivos de visitantesSolo internet, sin accesibilidad a LAN
GestiónGateway, switches, puntos de acceso, controladoresAlcanzable solo desde dispositivos de administración de confianza
VPNClientes remotosAcceso igual o más restringido que los clientes de confianza

Antes de recomendar IDs de VLAN o subredes, confirme:

  1. El gateway soporta encaminamiento entre VLANs y reglas de firewall.
  2. El switch soporta el comportamiento de puerto etiquetado y no etiquetado requerido.
  3. Los puntos de acceso pueden asignar SSID a VLANs.
  4. El operador sabe a qué puerto está conectado durante el cambio.
  5. La red de gestión permanece alcanzable después de los cambios en troncales y SSID.

Preparación del Filtrado DNS

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

  1. Asigne al resolvedor una dirección reservada antes de usarlo en las opciones de DHCP.
  2. Confirme que puede resolver DNS público y nombres locales home.arpa.
  3. Mantenga el gateway o un segundo resolvedor disponible como respaldo temporal.
  4. Pruebe un cliente o una VLAN antes de cambiar cada ámbito DHCP.
  5. Documente qué redes pueden omitir el filtrado y por qué.
  6. Verifique que las reglas de bloqueo no afecten a 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 resolvedor DNS esperado
La consulta DNS pública se realiza con éxito
La consulta local home.arpa se realiza con éxito
El dominio de prueba bloqueado se bloquea solo donde se pretende
Las interfaces de administración del gateway y DNS no son alcanzables desde redes de invitados o IoT

Preparación del Acceso Remoto

Para el acceso estilo WireGuard, decida a qué se le permite llegar a 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 laboratorioMantenga la lista de rutas estrecha
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 superpuesta (Overlay)Acceso remoto más simple con controles de identidadAún necesita revisión de ACL

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

  • El endpoint VPN está parcheado y mantenido activamente.
  • El puerto reenviado va solo al servicio VPN, no a una interfaz de administración.
  • Se entienden el DNS dinámico, el comportamiento de IP pública y el estado CGNAT del ISP.
  • Las claves de los pares 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

Prefiera cambios pequeños y reversibles:

  1. Tome una instantánea de la topología actual, el plan de IP, la configuración de DHCP, la configuración de DNS y las reglas de firewall.
  2. Reserve direcciones de infraestructura para gateway, DNS, controlador, puntos de acceso, NAS y endpoint VPN.
  3. Cree la nueva zona o VLAN sin mover dispositivos críticos.
  4. Mueva un cliente de prueba y valide DHCP, DNS, encaminamiento, internet y el comportamiento de bloqueo.
  5. Agregue excepciones de firewall estrechas para los flujos requeridos.
  6. Mueva un grupo de dispositivos de bajo riesgo.
  7. Agregue acceso VPN con la ruta y la política de firewall más estrechas que satisfagan el caso de uso.
  8. Documente el estado final, las excepciones conocidas y los comandos o pasos de interfaz de usuario 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 alcanzable desde invitados, IoT o internet público.
  • Una falla de DNS no inhabilita la capacidad del operador para recuperarse localmente.
  • Los cambios de ámbito DHCP se probaron en un cliente antes de la 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 alcanzar las superficies de administración del gateway, switch, punto de acceso, DNS y VPN.
  • La reversión está documentada en el mismo vocabulario que la interfaz de usuario o CLI de la plataforma elegida.

Anti-Patrones

  • Segmentar redes antes de saber qué puertos del switch y SSID llevan 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 sin probar el DNS de respaldo.
  • Publicar la gestión de NAS, DNS, router o hipervisor directamente a internet.
  • Tratar el acceso VPN como equivalente al acceso completo a la LAN de confianza.
  • Agregar reglas de firewall de permitir todo temporalmente y olvidarse de eliminarlas.
  • Copiar comandos de otro proveedor o versión de firmware sin verificar la sintaxis exacta de la plataforma.

Véase 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/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.

Skills relacionados