Communitygithub.com

homelab-network-readiness

Checkliste für die Bereitschaft des Heimnetzwerks bezüglich VLAN-Segmentierung, lokalem DNS-Filtering und Remote-Zugriff per WireGuard, bevor Router-, Firewall-, DHCP- oder VPN-Konfigurationen geändert werden.

Was ist homelab-network-readiness?

Dieses Skill unterstützt dich bei der Planung und Überprüfung von Änderungen an einem Heim- oder kleinen Labornetzwerk (Homelab), das VLANs, einen lokalen DNS-Resolver wie Pi-hole, Firewall-Regeln und Remote-VPN-Zugriff kombiniert. Es ist ein reines Planungs- und Überprüfungswerkzeug – es generiert keine direkten Konfigurationsbefehle für Router, Firewalls oder VPNs, es sei denn, die Zielplattform, die aktuelle Topologie, der Rollback-Pfad, der Konsolenzugriff und das Wartungsfenster sind vollständig bekannt. Der Skill hilft dir, eine Bestandsaufnahme deiner Netzwerkinfrastruktur zu machen, Risiken zu identifizieren, einen schrittweisen Migrationsplan zu erstellen und sicherzustellen, dass du nach jeder Änderung noch Zugriff auf die Verwaltungsoberflächen hast. Er unterstützt gängige Plattformen wie Router, Switches, Access Points und DNS-Resolver und betont die Bedeutung von rollback-fähigen Änderungen und Sicherheitszonen. Zu den Anti-Patterns gehören das Segmentieren von Netzwerken ohne Kenntnis der Port-Zuordnungen oder das direkte Freigeben von Verwaltungsoberflächen ins Internet.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/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 Network Readiness

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

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

  • Vorbereitung zur Aufteilung eines flachen Netzwerks in vertrauenswürdige, IoT-, Gast-, Server- oder Verwaltungs-VLANs.
  • Umstellung von DHCP-Clients auf Pi-hole, AdGuard Home, Unbound oder einen anderen lokalen DNS-Resolver.
  • Hinzufügen von WireGuard, Tailscale, ZeroTier, OpenVPN oder routereigenem VPN-Zugriff.
  • Überprüfung, ob eine Homelab-Änderung den Betreiber vom Gateway, Switch, Access Point, DNS-Server oder VPN-Server aussperren kann.
  • Umwandlung einer informellen Heimnetzwerk-Idee in einen abgestuften Migrationsplan mit Validierungsnachweisen.

Sicherheitsregeln

  • Behalten Sie die erste Antwort als read-only bei: Inventar, Risiken, abgestufter Plan, Validierung und Rollback.
  • Setzen 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 ein Rollback-Verfahren.
  • Fordern Sie Out-of-Band- oder Konsolenzugriff im selben Raum, bevor Sie Verwaltungs-VLANs, Trunk-Ports, Firewall-Standardrichtlinien oder DHCP-/DNS-Einstellungen ändern.
  • Behalten Sie einen funktionierenden Weg zurück ins Internet, bevor Sie das gesamte Netzwerk auf einen neuen DNS-Resolver oder eine VPN-Route umstellen.
  • Behandeln Sie IoT-, Gast-, Kamera- und Lab-Server-Netzwerke als unterschiedliche Vertrauenszonen, bis der Betreiber ausdrücklich anders entscheidet.

Erforderliches Inventar

Sammeln Sie dies, bevor Sie Implementierungsschritte geben:

BereichFragen
Internet-AnschlussWas ist das Modem oder ONT? Ist der ISP-Router gebridged oder routet er noch?
GatewayWelche Routen, Firewalls, verwaltet DHCP und terminiert VPNs?
SwitchingWelche Switch-Ports sind Uplinks, Access-Ports, Trunks oder unmanaged?
WLANWelche SSIDs sind welchen Netzwerken zugeordnet, und sind die APs verkabelt oder Mesh?
AdressierungWelche Subnetze existieren heute, und welche Bereiche überschneiden sich mit VPN-Standorten?
DNS/DHCPWelcher Dienst vergibt aktuell Leases und Resolver-Adressen?
VerwaltungWie erreicht der Betreiber nach den Änderungen Gateway, Switch und AP?
WiederherstellungWas kann lokal rückgängig gemacht werden, wenn DNS, DHCP, VLANs oder VPN-Routen brechen?

VLAN- und Vertrauenszonen-Plan

Beginnen Sie mit der Absicht, nicht mit der Herstellersyntax.

ZoneTypische InhalteStandardrichtlinie
VertrauenswürdigLaptops, Telefone, Admin-WorkstationsKann nur bei Bedarf auf gemeinsame Dienste und Verwaltung zugreifen
ServerNAS, Home Assistant, Lab-Hosts, DNS-ResolverAkzeptiert enge eingehende Flows von vertrauenswürdigen Clients
IoTFernseher, Smart Plugs, 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-Filtering-Bereitschaft

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 das Filtering umgehen dürfen und warum.
  6. Überprüfen Sie, dass Blockierregeln keine Captive Portals, Firmware-Updates, Arbeits-VPNs oder medizinische/Sicherheitsgeräte beeinträchtigen.

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

Remotezugriffs-Bereitschaft

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

ModusVerwendung, wennRisikohinweise
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 Remotezugriff mit IdentitätskontrollenErfordert dennoch ACL-Überprüfung

Empfehlen Sie kein Portforwarding, 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 bekannt.
  • Peerschlüssel können widerrufen werden, ohne das gesamte Netzwerk neu aufzubauen.
  • Logs oder Verbindungsstatus können verifizieren, wer wann verbunden war.

Änderungsreihenfolge

Bevorzugen Sie kleine, reversible Änderungen:

  1. Erstellen Sie einen Snapshot der aktuellen Topologie, des IP-Plans, der DHCP-Einstellungen, der DNS-Einstellungen und der 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 Testclient und validieren Sie DHCP, DNS, Routing, Internet und Blockierverhalten.
  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 nimmt dem Betreiber nicht die Fähigkeit, lokal wiederherzustellen.
  • DHCP-Scope-Änderungen wurden vor der breiten Ausrollung an einem Client getestet.
  • VPN-Clients erhalten nur die Routen und DNS-Einstellungen, die sie benötigen.
  • Firewall-Regeln sind zwischen Zonen standardmäßig verweigernd, mit benannten Ausnahmen.
  • Der Betreiber kann weiterhin Gateway, Switch, AP, DNS- und VPN-Admin-Oberflächen erreichen.
  • Rollback ist im selben Vokabular wie die gewählte Plattform-UI oder CLI dokumentiert.

Anti-Patterns

  • Netzwerke segmentieren, bevor bekannt ist, welche Switch-Ports und SSIDs welche VLANs tragen.
  • Die Admin-Workstation vom einzigen erreichbaren Verwaltungsnetzwerk entfernen.
  • 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 zum vollständigen 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 Plattformsyntax zu überprüfen.

Siehe auch

  • 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.

Verwandte Skills