Communitygithub.com

homelab-network-readiness

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

Qu'est-ce que homelab-network-readiness ?

Ce skill fournit une checklist complète et un guide de planification pour les techniciens qui s'apprêtent à modifier des réseaux domestiques ou de petits laboratoires. Il couvre la segmentation VLAN, le filtrage DNS local (Pi-hole, etc.) et l'accès à distance via WireGuard, Tailscale, OpenVPN ou autres. L'utilisateur est guidé pas à pas pour inventorier son infrastructure (modem, routeur, switch, points d'accès), définir des zones de confiance (IoT, serveurs, invités, gestion), et déterminer les règles de pare-feu associées. Le skill insiste sur des règles de sécurité strictes : pas d'exposition d'interfaces d'administration sur Internet, pas de modifications sans procédure de restauration, et conservation d'un chemin de retour vers Internet en toute circonstance. Il comprend des tableaux de décision pour le VPN (split tunnel, full tunnel, overlay) et des séquences de changement progressives avec validation par client test. Les anti-patrons sont clairement listés : segmenter sans connaître les ports, exposer des interfaces d'administration, ou ajouter des règles temporaires oubliées. Ce skill est conçu pour éviter les verrouillages d'accès et garantir une migration planifiée et sécurisée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/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

Préparation du Réseau Domestique / Laboratoire

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 commandes copiées-collées de routeur, pare-feu ou VPN sauf si la plateforme cible, la topologie actuelle, le chemin de restauration, l'accès console et la fenêtre de maintenance sont tous connus.

Quand l'Utiliser

  • Préparer le découpage d'un réseau plat en VLAN de confiance, IoT, invité, serveur ou gestion.
  • Migrer les clients DHCP vers Pi-hole, AdGuard Home, Unbound ou un autre résolveur DNS local.
  • Ajouter un accès VPN WireGuard, Tailscale, ZeroTier, OpenVPN ou natif du routeur.
  • Vérifier si une modification du réseau domestique peut bloquer l'accès de l'opérateur à la passerelle, au switch, au point d'accès, au serveur DNS ou au 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 restauration.
  • 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.
  • Ne fournissez pas de commandes pare-feu, NAT, VLAN, DHCP ou VPN sans une plateforme confirmée et une procédure de restauration.
  • 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 fonctionnel de retour vers Internet avant de diriger 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 :

ZoneQuestions
Périphérie InternetQuel est le modem ou l'ONT ? Le routeur FAI est-il en mode bridge ou route-t-il toujours ?
PasserelleQuelles routes, pare-feu, gère le DHCP et termine les VPN ?
CommutationQuels ports du switch 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 entrent en conflit avec les sites VPN ?
DNS/DHCPQuel service distribue actuellement les baux et les adresses de résolveur ?
GestionComment l'opérateur atteindra-t-il la passerelle, le switch et le point d'accès après les modifications ?
RécupérationQu'est-ce qui peut être annulé localement si le DNS, le DHCP, les VLAN ou les routes VPN cassent ?

Plan de VLAN et de Zones de Confiance

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

ZoneContenu typiquePolitique par défaut
De confianceOrdinateurs portables, téléphones, postes d'administrationPeut atteindre les services partagés et la gestion uniquement si nécessaire
ServeursNAS, Home Assistant, hôtes de laboratoire, résolveur DNSAccepte des flux entrants restreints provenant de clients de confiance
IoTTéléviseurs, prises connectées, caméras, enceintesAccès Internet plus exceptions explicites uniquement
InvitéAppareils des visiteursInternet uniquement, aucune accessibilité au LAN
GestionPasserelle, switches, points d'accès, contrôleursAccessible uniquement depuis les appareils d'administration de confiance
VPNClients distantsAccès identique ou plus restreint que les clients de confiance

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

  1. La passerelle prend en charge le routage inter-VLAN et les règles de pare-feu.
  2. Le switch prend en charge le comportement des ports taggés et non taggés requis.
  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 de SSID.

Préparation du 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 une adresse réservée au résolveur avant de l'utiliser dans les options DHCP.
  2. Confirmez qu'il peut résoudre le DNS public et les noms locaux home.arpa.
  3. Gardez la passerelle ou un second 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 n'interrompent pas les portails captifs, les VPN professionnels, les mises à jour du firmware ou les appareils 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 de l'Accès à Distance

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.

ModeUtilisationNotes 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 des 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 de responsabilité DNS
VPN superposéAccès distant plus simple avec contrôles d'identitéNécessite toujours une revue 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 homologues peuvent être révoquées sans reconstruire tout le réseau.
  • Les journaux ou l'état de connexion peuvent vérifier qui s'est connecté et quand.

Séquence de Changement

Privilégiez les changements petits et réversibles :

  1. Sauvegardez la topologie actuelle, le plan IP, les paramètres DHCP, les paramètres DNS et les 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 le nouveau VLAN sans déplacer les appareils critiques.
  4. Déplacez un client test et validez le DHCP, le DNS, le routage, Internet et le comportement de blocage.
  5. Ajoutez des exceptions de pare-feu étroites pour les flux requis.
  6. Déplacez un groupe d'appareils à faible risque.
  7. Ajoutez l'accès VPN avec la route et la politique de pare-feu les plus restrictives qui satisfont le cas d'usage.
  8. Documentez l'état final, les exceptions connues et les commandes ou étapes d'interface de restauration.

Liste de Vérification Finale

  • 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.
  • Une panne DNS ne neutralise 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 par défaut en refus entre les zones, avec des exceptions nommées.
  • L'opérateur peut toujours atteindre les surfaces d'administration de la passerelle, du switch, du point d'accès, du DNS et du VPN.
  • La restauration est documentée dans le même vocabulaire que l'interface utilisateur ou le CLI de la plateforme choisie.

Anti-Patrons

  • Segmenter les réseaux avant de savoir quels ports de switch et quels 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 repli.
  • Publier l'administration du NAS, du DNS, du routeur ou de l'hyperviseur directement sur Internet.
  • Considérer l'accès VPN comme équivalent à un accès complet au LAN de confiance.
  • Ajouter des règles de pare-feu temporaires tout-autoriser 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/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 associés