Communitygithub.com

homelab-netzwerk-bereitschaft

Prüfliste zur Bereitschaft für VLAN-Segmentierung, lokale DNS-Filterung und WireGuard-ähnlichen Fernzugriff vor Änderungen an Router, Firewall, DHCP oder VPN-Konfiguration.

Was ist homelab-netzwerk-bereitschaft?

Dieses Skill hilft Homelab-Betreibern, Netzwerkänderungen systematisch zu planen und kritische Ausfallzeiten oder Lockouts zu vermeiden. Es stellt eine strukturierte Checkliste für VLAN-Segmentierung, lokale DNS-Filterung (z.B. Pi-hole) und WireGuard-ähnlichen Fernzugriff bereit. Der Skill unterstützt die Überprüfung von Sicherheitsregeln, Bestandsaufnahme, Trust-Zonen-Planung und Wiederherstellungsoptionen, bevor Router, Firewall, DHCP oder VPN-Einstellungen geändert werden. Er eignet sich für alle Plattformen (Router, Switches, DNS-Server, VPN-Lösungen) und betont kleine, reversible Änderungen mit Testnachweis. Entwickler und Administratoren können damit das Risiko von Netzwerkausfällen minimieren und einen sauberen Migrationsplan erstellen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Homelab-Netzwerkbereitschaft

Verwenden Sie diesen Skill, bevor Sie ein Heim- oder kleines Labor-Netzwerk ändern, das VLANs, Pi-hole oder einen anderen lokalen DNS-Resolver, Firewall-Regeln und Remote-VPN-Zugriff mischt.

Dies ist ein Planungs- und Überprüfungs-Skill. Machen Sie daraus keine Copy-Paste-Router-, Firewall- oder VPN-Konfiguration, es sei denn, die Zielplattform, die aktuelle Topologie, der Rollback-Pfad, der Konsolenzugriff und das Wartungsfenster sind alle bekannt.

Wann verwenden

  • Vorbereiten der Aufteilung eines flachen Netzwerks in vertrauenswürdige, IoT-, Gast-, Server- oder Verwaltungs-VLANs.
  • Verschieben von DHCP-Clients zu Pi-hole, AdGuard Home, Unbound oder einem anderen lokalen DNS-Resolver.
  • Hinzufügen von WireGuard, Tailscale, ZeroTier, OpenVPN oder Router-eigenem VPN-Zugriff.
  • Überprüfen, ob eine Homelab-Änderung den Betreiber vom Gateway, Switch, Access Point, DNS-Server oder VPN-Server aussperren kann.
  • Umwandeln einer informellen Heimnetzwerk-Idee in einen gestaffelten Migrationsplan mit Validierungsnachweisen.

Sicherheitsregeln

  • Halten Sie die erste Antwort schreibgeschützt: Inventar, Risiken, gestaffelter Plan, Validierung und Rollback.
  • Legen Sie Gateway-Admin-Panels, DNS-Resolver, SSH, NAS-Konsolen oder VPN-Verwaltungs-UIs nicht direkt dem öffentlichen Internet aus.
  • Geben Sie keine Firewall-, NAT-, VLAN-, DHCP- oder VPN-Befehle ohne bestätigte Plattform und eine Rollback-Prozedur.
  • Erfordern Sie Out-of-Band- oder Konsolenzugriff im selben Raum, bevor Sie Verwaltungs-VLANs, Trunk-Ports, Firewall-Standardrichtlinien oder DHCP/DNS-Einstellungen ändern.
  • Halten Sie einen funktionierenden Weg zurück ins Internet, bevor Sie das gesamte Netzwerk auf einen neuen DNS-Resolver oder VPN-Route umleiten.
  • Behandeln Sie IoT-, Gast-, Kamera- und Lab-Server-Netzwerke als unterschiedliche Vertrauenszonen, bis der Betreiber explizit etwas anderes wählt.

Erforderliches Inventar

Sammeln Sie dies, bevor Sie Implementierungsschritte geben:

BereichFragen
Internet-AnschlussWas ist das Modem oder ONT? Ist der ISP-Router gebrückt oder routet er noch?
GatewayWelche Routen, Firewalls, DHCP und terminiert VPNs?
SwitchingWelche Switch-Ports sind Uplinks, Access-Ports, Trunks oder unmanaged?
Wi-FiWelche SSIDs sind welchen Netzwerken zugeordnet, und sind APs verkabelt oder Mesh?
AdressierungWelche Subnetze existieren heute und welche Bereiche kollidieren mit VPN-Standorten?
DNS/DHCPWelcher Dienst verteilt derzeit Leases und Resolver-Adressen?
VerwaltungWie erreicht der Betreiber Gateway, Switch und AP nach den Änderungen?
WiederherstellungWas kann lokal zurückgesetzt werden, wenn DNS, DHCP, VLANs oder VPN-Routen brechen?

VLAN- und Trust-Zonen-Plan

Beginnen Sie mit der Absicht, nicht mit der Hersteller-Syntax.

ZoneTypische InhalteStandardrichtlinie
VertrauenswürdigLaptops, Telefone, Admin-WorkstationsKann nur bei Bedarf auf gemeinsam genutzte Dienste und Verwaltung zugreifen
ServerNAS, Home Assistant, Lab-Hosts, DNS-ResolverAkzeptiert enge eingehende Flows von vertrauenswürdigen Clients
IoTFernseher, smarte Steckdosen, Kameras, LautsprecherNur Internetzugang plus explizite Ausnahmen
GastBesuchergeräteNur Internet, keine LAN-Erreichbarkeit
VerwaltungGateway, Switches, APs, ControllerNur von vertrauenswürdigen Admin-Geräten erreichbar
VPNRemote-ClientsGleicher oder engerer Zugriff als vertrauenswürdige Clients

Bevor Sie VLAN-IDs oder Subnetze empfehlen, bestätigen Sie:

  1. Das Gateway unterstützt Inter-VLAN-Routing und Firewall-Regeln.
  2. Der Switch unterstützt das erforderliche getaggte und ungetaggte Port-Verhalten.
  3. Die APs können SSIDs VLANs zuordnen.
  4. Der Betreiber weiß, über welchen Port er während der Änderung verbunden ist.
  5. Das Verwaltungsnetzwerk bleibt nach Trunk- und SSID-Änderungen erreichbar.

DNS-Filterungsbereitschaft

Pi-hole oder ein anderer lokaler Resolver sollte als Abhängigkeit eingeführt werden, nicht als Single Point of Failure.

  1. Geben Sie dem Resolver eine reservierte Adresse, bevor Sie ihn in DHCP-Optionen verwenden.
  2. Bestätigen Sie, dass er öffentliche DNS- und lokale home.arpa-Namen auflösen kann.
  3. Halten Sie das Gateway oder einen zweiten Resolver als temporären Fallback bereit.
  4. Testen Sie einen Client oder ein VLAN, bevor Sie jeden DHCP-Scope ändern.
  5. Dokumentieren Sie, welche Netzwerke die Filterung umgehen dürfen und warum.
  6. Überprüfen Sie, dass Blockierungsregeln keine Captive Portals, Arbeits-VPNs, Firmware-Updates oder medizinische/Sicherheitsgeräte stören.

Nützliche Validierungsnachweise:

Client erhält erwarteten DHCP-Lease
Client erhält erwarteten DNS-Resolver
Öffentliche DNS-Abfrage erfolgreich
Lokale home.arpa-Abfrage erfolgreich
Blockierte Testdomain wird nur dort blockiert, wo beabsichtigt
Gateway- und DNS-Admin-Oberflächen sind von Gast- oder IoT-Netzwerken nicht erreichbar

Fernzugriffsbereitschaft

Für WireGuard-ähnlichen Zugriff entscheiden Sie, was das VPN erreichen darf, bevor Sie Schlüssel generieren oder Ports öffnen.

ModusVerwendungRisikohinweise
Split-Tunnel zu einem SubnetzRemote-Admin für NAS oder Lab-HostsRoute-Liste eng halten
Split-Tunnel zu vertrauenswürdigen DienstenZugriff auf ausgewählte Apps per IP oder DNSErfordert präzise Firewall-Regeln
Full-TunnelNicht vertrauenswürdige Netzwerke oder ReisenMehr Bandbreite und DNS-Verantwortung
Overlay-VPNEinfacherer Fernzugriff mit IdentitätskontrollenErfordert dennoch ACL-Überprüfung

Empfehlen Sie keine Portweiterleitung, bis der Betreiber bestätigt:

  • Der VPN-Endpunkt ist gepatcht und wird aktiv gewartet.
  • Der weitergeleitete Port geht nur zum VPN-Dienst, nicht zu einer Admin-UI.
  • Dynamic DNS, öffentliches IP-Verhalten und ISP-CGNAT-Status sind verstanden.
  • Peer-Schlüssel können widerrufen werden, ohne das gesamte Netzwerk neu aufzubauen.
  • Protokolle oder Verbindungsstatus können überprüfen, wer wann verbunden war.

Änderungsreihenfolge

Bevorzugen Sie kleine, reversible Änderungen:

  1. Erstellen Sie einen Snapshot der aktuellen Topologie, IP-Plan, DHCP-Einstellungen, DNS-Einstellungen und Firewall-Regeln.
  2. Reservieren Sie Infrastrukturadressen für Gateway, DNS, Controller, APs, NAS und VPN-Endpunkt.
  3. Erstellen Sie die neue Zone oder das neue VLAN, ohne kritische Geräte zu verschieben.
  4. Verschieben Sie einen Test-Client und validieren Sie DHCP, DNS, Routing, Internet und Blockier- verhalten.
  5. Fügen Sie enge Firewall-Ausnahmen für erforderliche Flows hinzu.
  6. Verschieben Sie eine risikoarme Gerätegruppe.
  7. Fügen Sie VPN-Zugriff mit der engsten Route und Firewall-Richtlinie hinzu, die den Anwendungsfall erfüllt.
  8. Dokumentieren Sie den Endzustand, bekannte Ausnahmen und Rollback-Befehle oder UI-Schritte.

Überprüfungs-Checkliste

  • Jedes Netzwerk hat einen Existenzgrund und eine klare Vertrauensgrenze.
  • Keine Verwaltungsoberfläche ist von Gast-, IoT- oder dem öffentlichen Internet erreichbar.
  • DNS-Ausfall legt die Fähigkeit des Betreibers zur lokalen Wiederherstellung nicht lahm.
  • DHCP-Scope-Änderungen wurden an einem Client vor dem breiten Rollout getestet.
  • VPN-Clients erhalten nur die Routen und DNS-Einstellungen, die sie benötigen.
  • Firewall-Regeln sind Standard-Deny zwischen Zonen, mit benannten Ausnahmen.
  • Der Betreiber kann weiterhin Gateway, Switch, AP, DNS- und VPN-Admin-Oberflächen erreichen.
  • Rollback ist in derselben Terminologie dokumentiert wie die gewählte Plattform-UI oder CLI.

Anti-Patterns

  • Segmentieren von Netzwerken, bevor bekannt ist, welche Switch-Ports und SSIDs welche VLANs tragen.
  • Verschieben der Admin-Workstation aus dem einzigen erreichbaren Verwaltungsnetzwerk.
  • Alle DHCP-Scopes auf einen Pi-hole zeigen, bevor der Fallback-DNS getestet wurde.
  • NAS-, DNS-, Router- oder Hypervisor-Verwaltung direkt ins Internet veröffentlichen.
  • VPN-Zugriff als gleichwertig mit vollem vertrauenswürdigen LAN-Zugriff behandeln.
  • Temporäre Allow-All-Firewall-Regeln hinzufügen und vergessen, sie zu entfernen.
  • Befehle von einem anderen Hersteller oder einer anderen Firmware-Version kopieren, ohne die genaue Plattform-Syntax zu überprüfen.

Siehe auch

  • Skill: homelab-netzwerk-einrichtung
  • Skill: netzwerk-konfiguration-validierung
  • Skill: netzwerk-schnittstelle-gesundheit

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.

Verwandte Skills