Communitygithub.com

homelab-네트워크-설정

게이트웨이, 스위치, 액세스 포인트, IP 범위, DHCP 예약, DNS, 케이블링 및 초보자가 흔히 저지르는 실수를 다루는 실용적인 홈 및 홈랩 네트워크 계획입니다. 홈 또는 홈랩 네트워크를 계획하거나 수정할 때 사용하세요.

homelab-네트워크-설정란 무엇인가요?

이 스킬은 홈 네트워크 또는 소규모 랩 네트워크를 설계하고 문제를 해결하는 데 도움을 줍니다. 게이트웨이, 스위치, 액세스 포인트의 역할 분리, IP 범위 설계, DHCP 및 DNS 구성, 케이블링과 Wi-Fi 최적화 등 실용적인 지침을 제공합니다. 또한 VLAN, Pi-hole, NAS, VPN 등 향후 확장을 고려한 네트워크 설계 원칙을 설명하며, 이중 NAT, IP 충돌, 잘못된 DHCP 설정 등 흔한 오류를 피하는 방법을 알려줍니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트에서 사용할 수 있으며, 명확한 예제와 안티 패턴을 포함하여 누구나 따라할 수 있는 체계적인 접근 방식을 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/ECC/tree/main/skills/homelab-network-setup

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

홈랩 네트워크 설정

이 스킬은 전체 재구축 없이도 확장 가능한 홈 또는 소규모 랩 네트워크를 설계하는 데 사용합니다.

사용 시기

  • 새 홈 네트워크를 계획하거나 ISP 라우터만 있는 설정을 재설계할 때.
  • 게이트웨이, 스위치, 액세스 포인트 역할을 선택할 때.
  • IP 범위, DHCP 범위, 고정 예약, DNS를 설계할 때.
  • 향후 VLAN, Pi-hole, NAS, 랩 서버, VPN 액세스를 준비할 때.
  • 이중 NAT, 불안정한 Wi-Fi, 서버 주소 변경 등 문제가 있는 새 네트워크를 해결할 때.

작동 방식

장치 역할을 분리하는 것으로 시작합니다:

인터넷
  |
모뎀 또는 ONT
  |
게이트웨이 또는 라우터      NAT, 방화벽, DHCP, DNS, VLAN 간 라우팅
  |
관리형 스위치              유선 클라이언트, AP 업링크, 선택적 VLAN 트렁크
  |
액세스 포인트              Wi-Fi 전용; 이상적으로는 유선 백홀
서버 및 NAS               안정적인 주소, DNS 이름, 모니터링
클라이언트 및 IoT           DHCP 풀, VLAN 사용 시 추후 격리

기능 체크리스트뿐만 아니라 운영자 환경에 맞는 게이트웨이를 선택하세요:

옵션최적 용도참고
ISP 라우터기본 인터넷 전용제어 권한 제한적, VLAN 지원 부족
UniFi 게이트웨이관리형 홈 네트워크UI 좋음, 생태계 종속
OPNsense 또는 pfSense유연한 홈랩강력한 VLAN, 방화벽, VPN, DNS 제어
MikroTik고급 네트워크 사용자강력하지만 잘못 설정하기 쉬움
Linux 라우터실험 및 커스터마이징기본 게이트웨이로 사용하기 전에 롤백 문서화 필수

IP 계획

VPN 사용을 예상한다면 가장 흔한 기본값인 192.168.1.0/24를 피하세요. 호텔, 사무실, ISP 라우터와 자주 충돌합니다.

소규모 홈랩 계획 예시:

192.168.10.0/24  신뢰하는 클라이언트
192.168.20.0/24  IoT 및 미디어 장치
192.168.30.0/24  서버 및 NAS
192.168.40.0/24  게스트 Wi-Fi
192.168.99.0/24  네트워크 관리

게이트웨이 관례: .1
인프라 예약: .2 ~ .49
동적 DHCP 풀: .50 ~ .240
예비 영역: .241 ~ .254

로컬 이름에는 home.arpa를 사용하세요. 이는 홈 네트워크용으로 예약되어 있으며, home.lan 같은 임시 이름에서 발생하는 누출/충돌 문제를 피할 수 있습니다.

nas.home.arpa
pihole.home.arpa
gateway.home.arpa
switch-01.home.arpa

DHCP 및 DNS

  • SSH로 접속하거나, 북마크하거나, 모니터링하거나, 서비스로 노출하는 모든 장비에 DHCP 예약을 사용하세요.
  • 로컬 DNS 확인자를 의도적으로 배포하기 전까지는 게이트웨이를 DNS로 지정하세요.
  • Pi-hole 또는 다른 DNS 필터를 사용하는 경우, 먼저 해당 장치에 예약을 설정한 다음 DHCP DNS 옵션이 해당 주소를 가리키도록 하세요.
  • 서브넷별로 소규모 정적/예약 범위를 유지하여 교체 시 동적 임대와 충돌하지 않도록 하세요.

케이블링 및 Wi-Fi

  • 이더넷을 연결할 수 있다면 메시보다 유선 AP 백홀을 선호하세요.
  • 예산이 허락한다면 AP와 카메라용 PoE 스위치를 사용하세요.
  • 각 케이블 양쪽 끝에 라벨을 붙이고 간단한 포트 맵을 유지하세요.
  • 정전이 잦은 경우 게이트웨이, 스위치, DNS 서버, NAS를 UPS 전원에 연결하세요.

예제

초보자 업그레이드

목표: ISP 라우터를 유지하면서 소규모 랩 안정화.

  1. NAS, Pi, SSH 호스트 등에 DHCP 예약을 설정하세요.
  2. 로컬 이름을 home.arpa로 변경하세요.
  3. 보조 라우터나 AP에서 중복 DHCP 서버를 비활성화하세요.
  4. 무선 백홀 대신 메인 AP를 유선으로 연결하세요.

VLAN 지원 계획

목표: 즉시 활성화하지 않고 향후 분할을 준비합니다.

  1. 신뢰, IoT, 서버, 게스트, 관리용으로 중복되지 않는 /24 범위를 선택하세요.
  2. 각 서브넷에서 .1을 게이트웨이, .2-.49를 인프라용으로 예약하세요.
  3. VLAN 및 VLAN 간 방화벽 규칙을 지원하는 게이트웨이와 스위치를 구매하세요.
  4. 어떤 SSID와 스위치 포트가 각 네트워크에 매핑될지 문서화하세요.

안티 패턴

  • 이유나 문서 없이 이중 NAT 사용.
  • VPN 액세스가 계획되어 있을 때 192.168.1.0/24 사용.
  • NAS, Pi-hole, Home Assistant 또는 기타 서비스 호스트에 동적 주소 사용.
  • DHCP 서버가 여전히 활성화된 상태에서 소비자용 라우터를 AP로 재사용.
  • 카메라, 스마트 플러그, 노트북, 서버가 모두 동일한 트러스트 경계를 공유하는 플랫 네트워크.

참고

  • 스킬: network-interface-health
  • 스킬: network-config-validation

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.

관련 스킬