Communitygithub.com

ホームラボネットワーク準備チェックリスト

ルーター、ファイアウォール、DHCP、VPNの設定変更前に、ホームラボのVLANセグメンテーション、ローカルDNSフィルタリング、WireGuardスタイルのリモートアクセスの準備状況を確認するためのチェックリストです。

ホームラボネットワーク準備チェックリスト とは?

このスキルは、VLAN分割、Pi-holeなどのローカルDNSリゾルバの導入、WireGuardなどのリモートアクセスVPN設定を計画しているホームラボユーザー向けの準備チェックリストです。ネットワーク変更によるロックアウトリスクを軽減し、安全な段階的移行計画を立てるためのガイドラインを提供します。対応プラットフォームとしては、主要なルーター、スイッチ、アクセスポイント、DNSサービス(Pi-hole、AdGuard Home、Unbound)を想定しています。本スキルではまず、現在のトポロジ、DHCP設定、DNS設定、ファイアウォールルールをスナップショットし、リスク評価、段階的計画、検証、ロールバック手順を読み取り専用で提供することを推奨しています。VLANとトラストゾーンの計画、DNSフィルタリングの準備、リモートアクセスの準備、変更シーケンス、レビューチェックリスト、アンチパターンを網羅しており、特に管理インターフェースの公開禁止や、失敗時の復旧経路確保などの安全規則を重視しています。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ホームラボネットワーク準備チェックリスト は何をしますか?

このスキルは、VLAN、Pi-holeまたは他のローカルDNSリゾルバ、ファイアウォールルール、リモートVPNアクセスが混在する家庭または小規模ラボネットワークを変更する前に使用します。

これは計画およびレビュースキルです。ターゲットプラットフォーム、現在のトポロジ、ロールバックパス、コンソールアクセス、メンテナンスウィンドウがすべて確認されていない限り、ルーター、ファイアウォール、またはVPN設定のコピー&ペーストにしないでください。

使用するタイミング

  • フラットネットワークを信頼済み、IoT、ゲスト、サーバー、管理VLANに分割する準備をする場合。
  • DHCPクライアントをPi-hole、AdGuard Home、Unbound、または他のローカルDNSリゾルバに移行する場合。
  • WireGuard、Tailscale、ZeroTier、OpenVPN、またはルーターネイティブVPNアクセスを追加する場合。
  • ホームラボの変更により、オペレーターがゲートウェイ、スイッチ、アクセスポイント、DNSサーバー、VPNサーバーにアクセスできなくなる可能性があるかどうかを確認する場合。
  • 非公式のホームネットワークアイデアを、検証エビデンス付きの段階的移行計画に変換する場合。

安全規則

  • 最初の回答は読み取り専用(インベントリ、リスク、段階的計画、検証、ロールバック)にすること。
  • ゲートウェイ管理パネル、DNSリゾルバ、SSH、NASコンソール、VPN管理UIをパブリックインターネットに直接公開しないこと。
  • 確認済みのプラットフォームとロールバック手順がない限り、ファイアウォール、NAT、VLAN、DHCP、VPNのコマンドを提供しないこと。
  • 管理VLAN、トランクポート、ファイアウォールデフォルトポリシー、DHCP/DNS設定を変更する前に、帯域外または同室のコンソールアクセスを必須とすること。
  • ネットワーク全体を新しいDNSリゾルバやVPNルートに向ける前に、インターネットに戻る動作可能な経路を維持すること。
  • オペレーターが明示的に別の選択をしない限り、IoT、ゲスト、カメラ、ラボサーバーネットワークを異なるトラストゾーンとして扱うこと。

必要なインベントリ

実装手順を提供する前に、以下を収集します。

エリア質問
インターネットエッジモデムまたはONTは何ですか?ISPルーターはブリッジモードですか、それともルーティングしていますか?
ゲートウェイどの機器がルーティング、ファイアウォール、DHCP処理、VPN終端を行いますか?
スイッチングどのスイッチポートがアップリンク、アクセスポート、トランク、またはアンマネージドですか?
Wi-FiどのSSIDがどのネットワークにマッピングされており、APは有線接続ですかメッシュですか?
アドレッシング現在どのサブネットが存在し、どの範囲がVPNサイトと競合しますか?
DNS/DHCP現在どのサービスがリースとリゾルバアドレスを配布していますか?
管理変更後、オペレーターはどのようにゲートウェイ、スイッチ、APにアクセスしますか?
復旧DNS、DHCP、VLAN、VPNルートが壊れた場合、ローカルで何を元に戻せますか?

VLANとトラストゾーンの計画

ベンダー固有の構文ではなく、意図から始めます。

ゾーン一般的な内容デフォルトポリシー
信頼済みラップトップ、スマートフォン、管理用ワークステーション必要な場合にのみ共有サービスと管理にアクセス可能
サーバーNAS、Home Assistant、ラボホスト、DNSリゾルバ信頼済みクライアントからの狭いインバウンドフローを受け入れる
IoTテレビ、スマートプラグ、カメラ、スピーカーインターネットアクセス+明示的な例外のみ
ゲスト訪問者デバイスインターネットのみ、LAN到達不可
管理ゲートウェイ、スイッチ、AP、コントローラー信頼済み管理デバイスからのみ到達可能
VPNリモートクライアント信頼済みクライアントと同等かそれより狭いアクセス

VLAN IDまたはサブネットを推奨する前に、以下を確認します。

  1. ゲートウェイがVLAN間ルーティングとファイアウォールルールをサポートしていること。
  2. スイッチが必要なタグ付きおよびタグなしポート動作をサポートしていること。
  3. APがSSIDをVLANにマッピングできること。
  4. オペレーターが変更中に自分がどのポートに接続しているかを把握していること。
  5. トランクとSSIDの変更後も管理ネットワークが到達可能であること。

DNSフィルタリングの準備

Pi-holeまたは他のローカルリゾルバは、単一障害点ではなく、依存関係として導入する必要があります。

  1. DHCPオプションで使用する前に、リゾルバに予約アドレスを割り当てます。
  2. パブリックDNSとローカルのhome.arpa名を解決できることを確認します。
  3. ゲートウェイまたはセカンダリリゾルバを一時的なフォールバックとして利用可能にしておきます。
  4. すべてのDHCPスコープを変更する前に、1つのクライアントまたは1つのVLANでテストします。
  5. どのネットワークがフィルタリングをバイパスする可能性があるか、その理由を文書化します。
  6. ブロックルールがキャプティブポータル、仕事用VPN、ファームウェアアップデート、医療/セキュリティデバイスを壊さないことを確認します。

役立つ検証エビデンス:

クライアントが期待されるDHCPリースを取得する
クライアントが期待されるDNSリゾルバを受信する
パブリックDNSルックアップが成功する
ローカルhome.arpaルックアップが成功する
ブロック済みテストドメインが意図された場所でのみブロックされる
ゲートウェイとDNS管理インターフェースがゲストまたはIoTネットワークから到達不可である

リモートアクセスの準備

WireGuardスタイルのアクセスの場合、キーを生成したりポートを開放したりする前に、VPNが到達できる範囲を決定します。

モード使用するタイミングリスクに関する注意事項
分割トンネル(1サブネットへ)NASまたはラボホストへのリモート管理ルートリストを狭く保つ
分割トンネル(信頼済みサービスへ)IPまたはDNSで選択したアプリにアクセス正確なファイアウォールルールが必要
フルトンネル信頼できないネットワークや出張時より多くの帯域幅とDNS責任が発生
オーバーレイVPNID管理による簡易リモートアクセスそれでもACLレビューが必要

オペレーターが以下を確認するまで、ポート転送を推奨しないでください。

  • VPNエンドポイントにパッチが適用され、積極的にメンテナンスされていること。
  • 転送されたポートが管理UIではなくVPNサービスのみに向かっていること。
  • ダイナミックDNS、パブリックIPの動作、ISPのCGNATステータスが理解されていること。
  • ネットワーク全体を再構築せずにピアキーを失効させられること。
  • ログまたは接続ステータスで誰がいつ接続したかを確認できること。

変更手順

小さく、元に戻せる変更を好みます。

  1. 現在のトポロジ、IP計画、DHCP設定、DNS設定、ファイアウォールルールのスナップショットを取得します。
  2. ゲートウェイ、DNS、コントローラー、AP、NAS、VPNエンドポイントのインフラストラクチャアドレスを予約します。
  3. 重要なデバイスを移動せずに、新しいゾーンまたはVLANを作成します。
  4. 1つのテストクライアントを移動し、DHCP、DNS、ルーティング、インターネット、ブロック動作を検証します。
  5. 必要なフローに対して狭いファイアウォール例外を追加します。
  6. 低リスクのデバイスグループを1つ移動します。
  7. ユースケースを満たす最も狭いルートとファイアウォールポリシーでVPNアクセスを追加します。
  8. 最終状態、既知の例外、ロールバックコマンドまたはUI手順を文書化します。

レビューチェックリスト

  • 各ネットワークに存在理由と明確なトラストバウンダリがあること。
  • 管理インターフェースがゲスト、IoT、またはパブリックインターネットから到達可能でないこと。
  • DNS障害によってオペレーターのローカル復旧能力が損なわれないこと。
  • DHCPスコープの変更は、広く展開する前に1つのクライアントでテストされたこと。
  • VPNクライアントが必要なルートとDNS設定のみを受け取ること。
  • ファイアウォールルールはゾーン間でデフォルト拒否であり、名前付き例外があること。
  • オペレーターがゲートウェイ、スイッチ、AP、DNS、VPNの管理面に引き続きアクセスできること。
  • ロールバックが選択されたプラットフォームのUIまたはCLIと同じ語彙で文書化されていること。

アンチパターン

  • どのスイッチポートとSSIDがどのVLANを伝送するかを把握する前にネットワークをセグメント化する。
  • 管理ワークステーションを唯一到達可能な管理ネットワークから移動する。
  • フォールバックDNSをテストせずにすべてのDHCPスコープをPi-holeに向ける。
  • NAS、DNS、ルーター、ハイパーバイザーの管理をインターネットに直接公開する。
  • VPNアクセスを完全な信頼済みLANアクセスと同等と見なす。
  • 一時的に全許可ファイアウォールルールを追加し、削除するのを忘れる。
  • 正確なプラットフォーム構文を確認せずに、別のベンダーやファームウェアバージョンのコマンドをコピーする。

関連情報

  • スキル: homelab-network-setup
  • スキル: network-config-validation
  • スキル: 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.

関連スキル