Communitygithub.com

Préparation du réseau Homelab

Liste de vérification pour la segmentation VLAN, le filtrage DNS local et l'accès distant de type WireGuard avant de modifier la configuration du routeur, du pare-feu, du DHCP ou du VPN.

Qu'est-ce que Préparation du réseau Homelab ?

Ce skill est un outil de planification et de révision destiné aux opérateurs de réseaux domestiques ou de petits laboratoires qui souhaitent effectuer des changements complexes, tels que la segmentation en VLAN, l'introduction d'un résolveur DNS local (Pi-hole, AdGuard Home, etc.) ou la mise en place d'un accès distant via WireGuard. Il ne fournit pas de commandes prêtes à copier-coller, mais guide l'utilisateur à travers un processus structuré en plusieurs étapes : inventaire des équipements, analyse des risques, plan de migration, validation et rollback. Le skill met l'accent sur la sécurité, en interdisant l'exposition directe des interfaces d'administration sur Internet et en exigeant un accès console hors bande avant de modifier les VLAN de gestion. Il est utile sur toutes les plateformes (CLI, API, interfaces web) et s'applique à n'importe quel matériel réseau, à condition que l'opérateur connaisse sa topologie actuelle et dispose d'un chemin de retour vers Internet. L'approche par zones de confiance permet de traiter les réseaux IoT, invités et serveurs comme des entités distinctes, avec des politiques de pare-feu restrictives par défaut.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Préparation du réseau Homelab ?

Utilisez ce skill avant de modifier un réseau domestique ou de petit laboratoire qui mélange VLAN, Pi-hole ou un autre résolveur DNS local, des règles de pare-feu et un accès VPN distant.

Il s'agit d'un skill de planification et de révision. Ne le transformez pas en configuration copier-coller de routeur, pare-feu ou VPN, sauf si la plateforme cible, la topologie actuelle, le chemin de retour, l'accès console et la fenêtre de maintenance sont tous connus.

Quand l'utiliser

  • Préparer la division d'un réseau plat en VLAN de confiance, IoT, invité, serveur ou gestion.
  • Déplacer les clients DHCP vers Pi-hole, AdGuard Home, Unbound ou un autre résolveur DNS local.
  • Ajouter un accès VPN via WireGuard, Tailscale, ZeroTier, OpenVPN ou le VPN natif du routeur.
  • Vérifier si un changement du réseau domestique peut verrouiller l'opérateur hors de la passerelle, du commutateur, du point d'accès, du serveur DNS ou du serveur VPN.
  • Transformer une idée informelle de réseau domestique en un plan de migration par étapes avec preuves de validation.

Règles de sécurité

  • Conservez la première réponse en lecture seule : inventaire, risques, plan par étapes, validation et rollback.
  • N'exposez pas les panneaux d'administration de la passerelle, les résolveurs DNS, SSH, les consoles NAS ou les interfaces de gestion VPN directement sur Internet public.
  • Ne fournissez pas de commandes de pare-feu, NAT, VLAN, DHCP ou VPN sans une plateforme confirmée et une procédure de rollback.
  • Exigez un accès console hors bande ou dans la même pièce avant de modifier les VLAN de gestion, les ports trunk, les politiques par défaut du pare-feu ou les paramètres DHCP/DNS.
  • Gardez un chemin de retour fonctionnel vers Internet avant de pointer tout le réseau vers un nouveau résolveur DNS ou une route VPN.
  • Traitez les réseaux IoT, invités, caméras et serveurs de laboratoire comme des zones de confiance différentes jusqu'à ce que l'opérateur choisisse explicitement le contraire.

Inventaire requis

Collectez ceci avant de donner des étapes de mise en œuvre :

DomaineQuestions
Périphérie InternetQuel est le modem ou ONT ? Le routeur FAI est-il en mode bridge ou route-t-il toujours ?
PasserelleQuels sont les routes, pare-feu, DHCP et terminaisons VPN ?
CommutationQuels ports du commutateur sont des uplinks, ports d'accès, trunks ou non gérés ?
Wi-FiQuels SSID correspondent à quels réseaux, et les points d'accès sont-ils câblés ou maillés ?
AdressageQuels sous-réseaux existent aujourd'hui, et quelles plages sont en conflit avec les sites VPN ?
DNS/DHCPQuel service distribue actuellement les baux et les adresses des résolveurs ?
GestionComment l'opérateur atteindra-t-il la passerelle, le commutateur et le point d'accès après les changements ?
RécupérationQue peut-on restaurer localement si DNS, DHCP, VLAN ou les routes VPN se cassent ?

Plan VLAN et zones de confiance

Commencez par l'intention plutôt que par la syntaxe du fournisseur.

ZoneContenu typiquePolitique par défaut
ConfianceOrdinateurs portables, téléphones, postes d'administrationPeut accéder aux services partagés et à la gestion uniquement si nécessaire
ServeursNAS, Home Assistant, hôtes de laboratoire, résolveur DNSAccepte des flux entrants limités en provenance des clients de confiance
IoTTV, prises intelligentes, caméras, enceintesAccès Internet plus exceptions explicites uniquement
InvitéAppareils des visiteursInternet uniquement, aucune accessibilité LAN
GestionPasserelle, commutateurs, points d'accès, contrôleursAccessible uniquement depuis les appareils d'administration de confiance
VPNClients distantsAccès identique ou plus restreint que celui des clients de confiance

Avant de recommander des ID VLAN ou des sous-réseaux, confirmez :

  1. La passerelle prend en charge le routage inter-VLAN et les règles de pare-feu.
  2. Le commutateur prend en charge le comportement requis pour les ports tagués et non tagués.
  3. Les points d'accès peuvent mapper les SSID aux VLAN.
  4. L'opérateur sait par quel port il est connecté pendant le changement.
  5. Le réseau de gestion reste accessible après les modifications de trunk et SSID.

Préparation au filtrage DNS

Pi-hole ou un autre résolveur local doit être introduit comme une dépendance, pas comme un point de défaillance unique.

  1. Donnez au résolveur une adresse réservée avant de l'utiliser dans les options DHCP.
  2. Confirmez qu'il peut résoudre les DNS publics et les noms locaux home.arpa.
  3. Gardez la passerelle ou un deuxième résolveur disponible comme solution de repli temporaire.
  4. Testez un client ou un VLAN avant de modifier chaque étendue DHCP.
  5. Documentez quels réseaux peuvent contourner le filtrage et pourquoi.
  6. Vérifiez que les règles de blocage ne cassent pas les portails captifs, les VPN professionnels, les mises à jour du firmware ou les dispositifs médicaux/de sécurité.

Preuves de validation utiles :

Le client reçoit le bail DHCP attendu
Le client reçoit le résolveur DNS attendu
La résolution DNS publique réussit
La résolution locale home.arpa réussit
Le domaine de test bloqué est bloqué uniquement là où prévu
Les interfaces d'administration de la passerelle et du DNS ne sont pas accessibles depuis les réseaux invité ou IoT

Préparation à l'accès distant

Pour un accès de type WireGuard, décidez ce que le VPN est autorisé à atteindre avant de générer des clés ou d'ouvrir des ports.

ModeQuand l'utiliserNotes de risque
Split tunnel vers un sous-réseauAdministration à distance pour NAS ou hôtes de laboratoireGardez la liste des routes étroite
Split tunnel vers les services de confianceAccès à des applications sélectionnées par IP ou DNSNécessite des règles de pare-feu précises
Tunnel completRéseaux non fiables ou voyagesPlus de bande passante et responsabilité DNS
VPN superposéAccès distant plus simple avec contrôles d'identitéNécessite toujours une révision des ACL

Ne recommandez pas la redirection de port tant que l'opérateur n'a pas confirmé :

  • Le point de terminaison VPN est patché et activement maintenu.
  • Le port redirigé va uniquement au service VPN, pas à une interface d'administration.
  • Le DNS dynamique, le comportement de l'IP publique et le statut CGNAT du FAI sont compris.
  • Les clés des pairs peuvent être révoquées sans reconstruire tout le réseau.
  • Les logs ou l'état de la connexion peuvent vérifier qui s'est connecté et quand.

Séquence de changement

Privilégiez les changements petits et réversibles :

  1. Prenez un instantané de la topologie actuelle, du plan IP, des paramètres DHCP, des paramètres DNS et des règles de pare-feu.
  2. Réservez les adresses d'infrastructure pour la passerelle, le DNS, le contrôleur, les points d'accès, le NAS et le point de terminaison VPN.
  3. Créez la nouvelle zone ou VLAN sans déplacer les périphériques critiques.
  4. Déplacez un client de test et validez le DHCP, DNS, routage, Internet et le comportement de blocage.
  5. Ajoutez des exceptions de pare-feu étroites pour les flux requis.
  6. Déplacez un groupe de périphériques à faible risque.
  7. Ajoutez l'accès VPN avec la politique de route et de pare-feu la plus étroite satisfaisant le cas d'utilisation.
  8. Documentez l'état final, les exceptions connues et les commandes ou étapes UI de rollback.

Liste de vérification

  • Chaque réseau a une raison d'exister et une limite de confiance claire.
  • Aucune interface de gestion n'est accessible depuis les réseaux invité, IoT ou Internet public.
  • Une panne DNS ne supprime pas la capacité de l'opérateur à récupérer localement.
  • Les modifications d'étendue DHCP ont été testées sur un client avant un déploiement large.
  • Les clients VPN reçoivent uniquement les routes et paramètres DNS dont ils ont besoin.
  • Les règles de pare-feu sont en refus par défaut entre les zones, avec des exceptions nommées.
  • L'opérateur peut toujours atteindre les surfaces d'administration de la passerelle, du commutateur, du point d'accès, du DNS et du VPN.
  • Le rollback est documenté dans le même vocabulaire que l'interface utilisateur ou la CLI de la plateforme choisie.

Anti-patrons

  • Segmenter les réseaux avant de savoir quels ports de commutateur et SSID transportent quels VLAN.
  • Déplacer le poste d'administration hors du seul réseau de gestion accessible.
  • Pointer toutes les étendues DHCP vers un Pi-hole avant de tester le DNS de secours.
  • Publier la gestion NAS, DNS, routeur ou hyperviseur directement sur Internet.
  • Traiter l'accès VPN comme équivalent à un accès complet au LAN de confiance.
  • Ajouter des règles de pare-feu tout-autoriser temporairement et oublier de les supprimer.
  • Copier des commandes d'un autre fournisseur ou version de firmware sans vérifier la syntaxe exacte de la plateforme.

Voir aussi

  • 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 associés