Communitygithub.com

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

VLANセグメンテーション、ローカルDNSフィルタリング、WireGuardスタイルのリモートアクセスについて、ルーター、ファイアウォール、DHCP、VPN設定を変更する前の準備チェックリストを提供するスキルです。

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

このスキルは、ホームラボネットワークにおいて、ルーター、ファイアウォール、DHCP、DNS、VPNの設定を変更する前に、必要な準備と評価を支援します。主な目的は、VLANセグメンテーション、Pi-holeなどのローカルDNSフィルタリング、そしてWireGuardやTailscaleなどのリモートアクセスVPNを安全に導入するための計画とリスク評価です。変更作業を始める前に、現在のネットワーク構成の棚卸し、リスクの特定、段階的な移行計画の策定、ロールバック手順の文書化を求めます。このスキルは、ネットワーク変更によるロックアウトやサービス中断を防ぐための安全ルールを重視しており、特にIoT、ゲスト、管理ネットワークなどの異なるトラストゾーンを明確に区別し、各ゾーンのデフォルトポリシーを定義します。Claude Code、Codex、CursorなどのAIエージェントがネットワーク構成を提案する前に、このスキルを使用することで、実装の前提条件が満たされていることを確認し、安全で検証可能な変更手順を提供できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/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. ゲートウェイまたは2番目のリゾルバーを一時的なフォールバックとして利用できるようにしておいてください。
  4. すべてのDHCPスコープを変更する前に、1台のクライアントまたは1つのVLANでテストしてください。
  5. フィルタリングをバイパスするネットワークとその理由を文書化してください。
  6. ブロックルールがキャプティブポータル、仕事用VPN、ファームウェアアップデート、医療/セキュリティデバイスを壊さないことを確認してください。

有用な検証証拠:

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

リモートアクセスの準備

WireGuardスタイルのアクセスの場合、キーを生成したりポートを開放したりする前に、VPNが何にアクセスできるかを決定してください。

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

オペレーターが以下を確認するまで、ポートフォワーディングを推奨しないでください:

  • VPNエンドポイントがパッチ適用され、積極的に維持管理されていること。
  • 転送されたポートが管理UIではなくVPNサービスのみに送られること。
  • Dynamic 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/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.

関連スキル