Communitygithub.com

홈랩 네트워크 설정

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

홈랩 네트워크 설정란 무엇인가요?

이 스킬은 전체 재구축 없이 확장 가능한 홈 또는 소규모 연구실 네트워크를 설계하는 데 도움을 줍니다. ISP 라우터, UniFi, OPNsense, pfSense, MikroTik, Linux 라우터 등 다양한 게이트웨이 옵션을 다루며, 각 옵션의 적합한 사용 사례를 설명합니다. IP 계획, DHCP 예약, DNS 설정, 케이블링 및 Wi-Fi 배치에 대한 실용적인 지침을 제공하며, 초보자가 흔히 저지르는 실수와 안티패턴을 피하는 방법을 알려줍니다. 이 스킬은 Claude Code, Cursor 등 AI 에이전트와 함께 사용할 수 있으며, 사용자가 네트워크 요구사항을 설명하면 적절한 IP 계획과 장비 선택을 추천해줍니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/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로 제공하세요.
  • 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/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.

관련 스킬