Communitygithub.com

홈랩 네트워크 준비 상태 확인

라우터, 방화벽, DHCP 또는 VPN 구성을 변경하기 전에 홈랩 VLAN 분할, 로컬 DNS 필터링, WireGuard 방식 원격 접속에 대한 준비 체크리스트를 제공합니다.

홈랩 네트워크 준비 상태 확인란 무엇인가요?

이 스킬은 VLAN 분할, 로컬 DNS 필터링(Pi-hole 등), WireGuard 방식의 원격 접속 등 홈랩 네트워크 변경을 계획할 때 사전 검토 및 안전 점검을 수행하는 데 사용됩니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트에서 활용할 수 있으며, 변경 작업으로 인한 잠금 위험을 방지하고 체계적인 마이그레이션 계획을 수립하도록 돕습니다. 필요한 인벤토리 수집, 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 리졸버신뢰되는 클라이언트의 좁은 인바운드 흐름 허용
IoTTV, 스마트 플러그, 카메라, 스피커인터넷 액세스 및 명시적 예외만 허용
게스트방문자 기기인터넷 전용, 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 범위를 변경하기 전에 하나의 클라이언트 또는 하나의 VLAN에서 테스트합니다.
  5. 필터링을 우회할 수 있는 네트워크와 그 이유를 문서화합니다.
  6. 차단 규칙이 캡티브 포털, 회사 VPN, 펌웨어 업데이트 또는 의료/보안 장치를 손상시키지 않는지 확인합니다.

유용한 검증 증거:

클라이언트가 예상된 DHCP 임대를 받음
클라이언트가 예상된 DNS 리졸버를 수신함
공개 DNS 조회 성공
로컬 home.arpa 조회 성공
차단된 테스트 도메인이 의도된 곳에서만 차단됨
게이트웨이 및 DNS 관리 인터페이스가 게스트 또는 IoT 네트워크에서 도달 불가능

원격 접속 준비 상태

WireGuard 방식의 접속을 위해, 키를 생성하거나 포트를 열기 전에 VPN이 무엇에 도달할 수 있는지 결정하십시오.

모드사용 시기위험 참고 사항
하나의 서브넷으로 분할 터널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. 하나의 테스트 클라이언트를 이동하고 DHCP, DNS, 라우팅, 인터넷 및 차단 동작을 검증합니다.
  5. 필요한 흐름에 대해 좁은 방화벽 예외를 추가합니다.
  6. 하나의 저위험 장치 그룹을 이동합니다.
  7. 사용 사례를 충족하는 가장 좁은 경로 및 방화벽 정책으로 VPN 접속을 추가합니다.
  8. 최종 상태, 알려진 예외 및 롤백 명령 또는 UI 단계를 문서화합니다.

검토 체크리스트

  • 각 네트워크에는 존재 이유와 명확한 신뢰 경계가 있습니다.
  • 게스트, IoT 또는 공개 인터넷에서 관리 인터페이스에 도달할 수 없습니다.
  • DNS 오류로 인해 운영자가 로컬에서 복구할 수 없게 되지 않습니다.
  • DHCP 범위 변경은 광범위하게 배포하기 전에 하나의 클라이언트에서 테스트되었습니다.
  • 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.

관련 스킬