Communitygithub.com

homelab-network-setup

Planification pratique de réseau domestique et de homelab pour les passerelles, les commutateurs, les points d'accès, les plages IP, les réservations DHCP, le DNS, le câblage et les erreurs courantes des débutants. À utiliser lors de la planification ou de la réparation d'un réseau domestique ou homelab — passerelle, commutateur, point d'accès, plages IP, DHCP, DNS ou câblage.

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

Ce skill guide la conception d'un réseau domestique ou de homelab évolutif, en évitant les architectures bloquantes. Il couvre la sélection de la passerelle, du commutateur géré et des points d'accès, la planification des plages IP et des sous-réseaux (y compris les conventions d'adressage comme `home.arpa`), la configuration du DHCP et du DNS avec réservations, ainsi que les bonnes pratiques de câblage (backhaul filaire, PoE, étiquetage). Il est compatible avec les configurations utilisant des routeurs FAI, UniFi, OPNsense, pfSense, MikroTik ou un routeur Linux. Le skill aide à éviter les anti-patrons courants tels que le double NAT, l'utilisation de `192.168.1.0/24` avec des VPN, les adresses dynamiques pour les services critiques, et les réseaux plats sans segmentation. Il fournit des exemples concrets pour une mise à niveau simple avec routeur FAI ou pour préparer un plan compatible VLAN. Les plateformes cibles incluent les assistants IA comme Claude Code, Cursor et Codex, et le skill applique une démarche structurée pour planifier, documenter et dépanner un réseau.

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

Demander à votre IA préférée

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

Documentation

Configuration de réseau Homelab

Utilisez ce skill pour concevoir un réseau domestique ou de petit laboratoire qui peut évoluer sans nécessiter une reconstruction complète.

Quand l'utiliser

  • Planifier un nouveau réseau domestique ou repenser une configuration uniquement basée sur le routeur FAI.
  • Choisir les rôles de la passerelle, du commutateur et du point d'accès.
  • Concevoir les plages IP, les étendues DHCP, les réservations statiques et le DNS.
  • Se préparer pour de futurs VLAN, Pi-hole, NAS, serveurs de laboratoire ou accès VPN.
  • Dépanner un nouveau réseau qui présente un double NAT, un Wi-Fi instable ou des adresses de serveur changeantes.

Comment ça marche

Commencez par séparer les rôles des appareils :

Internet
  |
Modem ou ONT
  |
Passerelle ou routeur      NAT, pare-feu, DHCP, DNS, routage inter-VLAN
  |
Commutateur géré           clients filaires, liaisons montantes des points d'accès, trunks VLAN optionnels
  |
Points d'accès             Wi-Fi uniquement ; idéalement avec backhaul filaire
Serveurs et NAS             adresses stables, noms DNS, surveillance
Clients et IoT              pools DHCP, isolés plus tard si des VLAN sont disponibles

Choisissez une passerelle qui correspond à l'opérateur, pas seulement à la liste de fonctionnalités :

OptionMeilleur pourNotes
Routeur FAIInternet de base uniquementContrôle limité et souvent mauvais support VLAN
Passerelle UniFiRéseau domestique géréBonne interface utilisateur, verrouillage écosystème
OPNsense ou pfSenseHomelab flexibleContrôle VLAN, pare-feu, VPN et DNS puissant
MikroTikUtilisateurs réseau avancésPuissant, mais facile à mal configurer
Routeur LinuxBricoleursDocumenter la restauration avant de l'utiliser comme passerelle principale

Plan IP

Évitez le défaut le plus courant, 192.168.1.0/24, lorsque vous prévoyez d'utiliser des VPN. Il entre souvent en conflit avec les hôtels, les bureaux et les routeurs FAI.

Exemple de petit plan homelab :

192.168.10.0/24  clients de confiance
192.168.20.0/24  appareils IoT et médias
192.168.30.0/24  serveurs et NAS
192.168.40.0/24  Wi-Fi invité
192.168.99.0/24  gestion du réseau

Convention de passerelle : .1
Réservations d'infrastructure : .2 à .49
Pool DHCP dynamique : .50 à .240
Espace libre : .241 à .254

Utilisez home.arpa pour les noms locaux. Ce domaine est réservé aux réseaux domestiques et évite les problèmes de fuite/conflit des noms ad hoc comme home.lan.

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

DHCP et DNS

  • Utilisez des réservations DHCP pour tout ce à quoi vous vous connectez en SSH, que vous mettez en favori, que vous surveillez ou que vous exposez en tant que service.
  • Distribuez la passerelle comme DNS jusqu'à ce qu'un résolveur local soit intentionnellement déployé.
  • Si vous utilisez Pi-hole ou un autre filtre DNS, réservez-lui d'abord une adresse, puis pointez les options DNS DHCP vers cette adresse.
  • Conservez une petite plage statique/réservée par sous-réseau afin que les remplacements n'entrent pas en conflit avec les baux dynamiques.

Câblage et Wi-Fi

  • Préférez un backhaul AP filaire plutôt qu'un maillage lorsque vous pouvez tirer un câble Ethernet.
  • Utilisez un commutateur PoE pour les points d'accès et les caméras si le budget le permet.
  • Étiquetez les deux extrémités de chaque câble et conservez un simple plan de ports.
  • Mettez la passerelle, le commutateur, le serveur DNS et le NAS sur une alimentation UPS si les pannes sont fréquentes.

Exemples

Mise à niveau débutant

Objectif : Conserver le routeur FAI mais stabiliser un petit laboratoire.

  1. Définissez des réservations DHCP pour le NAS, le Pi et tous les hôtes SSH.
  2. Déplacez les noms locaux vers home.arpa.
  3. Désactivez les serveurs DHCP en double sur les routeurs ou points d'accès secondaires.
  4. Câblez le point d'accès principal au lieu de compter sur le backhaul sans fil.

Plan prêt pour les VLAN

Objectif : Préparer une segmentation future sans l'activer immédiatement.

  1. Choisissez des plages /24 non chevauchantes pour les réseaux de confiance, IoT, serveurs, invité et gestion.
  2. Réservez .1 pour la passerelle et .2-.49 pour l'infrastructure sur chaque sous-réseau.
  3. Achetez une passerelle et un commutateur qui prennent en charge les VLAN et les règles de pare-feu inter-VLAN.
  4. Documentez quels SSID et ports de commutateur seront éventuellement mappés à chaque réseau.

Anti-patrons

  • Double NAT sans raison ni documentation.
  • Utilisation de 192.168.1.0/24 lorsque l'accès VPN est prévu.
  • Adresses dynamiques pour le NAS, Pi-hole, Home Assistant ou autres hôtes de services.
  • Routeurs grand public réutilisés comme points d'accès alors que leurs serveurs DHCP sont toujours activés.
  • Réseaux plats où caméras, prises connectées, ordinateurs portables et serveurs partagent tous la même frontière de confiance.

Voir aussi

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