homelab-vlan-segmentation
Segmenta redes domésticas em VLANs para diferentes tipos de tráfego usando equipamentos comuns.
O que ela faz
Este guia ensina como separar sua rede doméstica em 'VLANs', que são como redes virtuais separadas dentro da mesma rede física. Isso ajuda a aumentar a segurança, isolando dispositivos como câmeras inteligentes e redes de convidados para que não possam acessar seus computadores ou servidores.
Quando usar
- ✓Ao configurar uma rede doméstica pela primeira vez.
- ✓Para isolar dispositivos de 'Internet das Coisas' (IoT).
- ✓Para criar uma rede Wi-Fi separada para visitantes.
Exemplo do que pedir para a IA
“Como posso separar minha rede doméstica para que dispositivos de IoT não acessem meus computadores?”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ele explica como criar diferentes redes virtuais (VLANs) e configurar regras de firewall para controlar qual dispositivo pode falar com qual. Isso é feito em equipamentos de rede como UniFi, pfSense/OPNsense ou MikroTik.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add affaan-m/ECC --skill homelab-vlan-segmentationOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/affaan-m/ECC/main/skills/homelab-vlan-segmentation/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Segmentação de VLANs em Homelab
Como dividir uma rede doméstica em VLANs isoladas para que dispositivos IoT, convidados e seus PCs principais não possam se comunicar entre si. A atualização de segurança mais impactante para uma rede doméstica.
Todas as regras de firewall mostradas aqui adicionam isolamento entre os segmentos — elas não removem proteções existentes. Aplique as alterações em uma janela de manutenção e verifique a conectividade entre os segmentos após cada etapa antes de prosseguir.
Quando Usar
- Configurando VLANs em uma rede doméstica pela primeira vez
- Isolando dispositivos IoT (lâmpadas inteligentes, câmeras, TVs) de dispositivos confiáveis
- Criando uma rede Wi-Fi para convidados que não pode acessar dispositivos domésticos
- Explicando como as VLANs funcionam para alguém que não está familiarizado com o conceito
- Configurando portas trunk, portas de acesso e mapeamento de SSID para VLAN
- Solucionando problemas de roteamento inter-VLAN ou regras de firewall no pfSense/OPNsense/UniFi
Como Funciona
Without VLANs — flat network:
All devices on 192.168.1.0/24
Smart TV (potential malware) → can reach your NAS, PCs, everything
With VLANs:
VLAN 10 — Trusted 192.168.10.0/24 (PCs, phones, laptops)
VLAN 20 — IoT 192.168.20.0/24 (smart TV, bulbs, cameras)
VLAN 30 — Servers 192.168.30.0/24 (NAS, Pi, VMs)
VLAN 40 — Guest 192.168.40.0/24 (visitor Wi-Fi)
VLAN 99 — Management 192.168.99.0/24 (switch/AP web UIs)
Smart TV → blocked from reaching 192.168.10.0/24 and 192.168.30.0/24
Guests → internet only, cannot see any home devices
Modelo de Design de VLAN
VLAN Name Subnet Gateway Purpose
10 trusted 192.168.10.0/24 192.168.10.1 PCs, phones, laptops
20 iot 192.168.20.0/24 192.168.20.1 Smart home devices
30 servers 192.168.30.0/24 192.168.30.1 NAS, Pi, self-hosted
40 guest 192.168.40.0/24 192.168.40.1 Visitor Wi-Fi
99 management 192.168.99.0/24 192.168.99.1 Network gear web UIs
Exemplos
Homelab típico com AP UniFi e switch gerenciável:
Scenario: 3-bedroom house, UniFi Dream Machine + UniFi 8-port switch + 2 APs
VLAN 10 — Trusted 192.168.10.0/24 MacBook, iPhones, iPad
VLAN 20 — IoT 192.168.20.0/24 Nest thermostat, Philips Hue, Ring doorbell, smart TVs
VLAN 30 — Servers 192.168.30.0/24 Synology NAS (192.168.30.10), Pi-hole (192.168.30.2)
VLAN 40 — Guest 192.168.40.0/24 Visitor Wi-Fi — internet only
SSID → VLAN mapping:
"Home" → VLAN 10 (WPA2, strong password, trusted devices only)
"IoT" → VLAN 20 (WPA2, separate password, printed on router for setup)
"Guest" → VLAN 40 (WPA2, simple password you can share freely)
Switch port behavior:
Port 1 → trunk to router (tagged VLANs 10,20,30,40,99)
Port 2 → trunk to APs (tagged VLANs 10,20,40; AP handles per-SSID tagging)
Port 3 → access VLAN 30 (NAS — untagged, no VLAN awareness needed)
Port 4 → access VLAN 30 (Pi-hole — untagged)
Port 5–8 → access VLAN 10 (wired workstations)
Firewall rules applied (all rules add isolation, none remove existing protections):
IoT → Trusted: BLOCK
IoT → Servers: BLOCK except 192.168.30.2:53 (Pi-hole DNS allowed)
IoT → Internet: ALLOW
Guest → Local networks: BLOCK
Guest → Internet: ALLOW
Trusted → everywhere: ALLOW
Configuração UniFi
Criar Redes no UniFi Controller
Settings → Networks → Create New Network
For each VLAN:
Name: IoT
Purpose: Corporate (gives DHCP + routing)
VLAN ID: 20
Network: 192.168.20.0/24
Gateway IP: 192.168.20.1
DHCP: Enable
DHCP Range: 192.168.20.100 – 192.168.20.254
Mapear SSIDs para VLANs (UniFi)
Settings → WiFi → Create New WiFi
Name: IoT-Network
Password: <separate password>
Network: IoT ← select your VLAN here
# All devices connecting to this SSID land in VLAN 20
Name: Guest
Password: <guest password>
Network: Guest
Guest Policy: Enable ← isolates guests from each other too
Regras de Firewall UniFi (Regras de Tráfego)
Settings → Traffic & Security → Traffic Rules
# Block IoT from reaching Trusted VLAN
Action: Block
Category: Local Network
Source: IoT (192.168.20.0/24)
Destination: Trusted (192.168.10.0/24)
# Allow IoT to reach internet only
Action: Allow
Source: IoT
Destination: Internet
# Block Guest from all local networks
Action: Block
Source: Guest
Destination: Local Networks
Configuração pfSense / OPNsense
Criar VLANs
Interfaces → Assignments → VLANs → Add
Parent Interface: em1 (sua NIC LAN)
VLAN Tag: 20
…
Perguntas frequentes
O que é uma VLAN?
Uma VLAN (Virtual Local Area Network) é como criar várias redes menores e isoladas dentro de uma única rede física. Isso ajuda a organizar e proteger seus dispositivos.
Por que eu deveria usar VLANs?
VLANs aumentam a segurança, impedindo que dispositivos menos confiáveis (como câmeras inteligentes ou dispositivos de convidados) acessem seus computadores ou dados importantes.
Preciso de equipamentos especiais para usar VLANs?
Sim, você geralmente precisa de um roteador e switches que suportem VLANs, como os mencionados no guia (UniFi, pfSense/OPNsense, MikroTik).
Detalhes
Descrição original do autor
Segmenting home networks into VLANs for IoT, guest, trusted, and server traffic using UniFi, pfSense/OPNsense, and MikroTik — including switch trunk config, firewall rules, and wireless SSID mapping. Use when splitting a home network into IoT, guest, trusted, and server VLANs on UniFi, pfSense/OPNsense, or MikroTik.
repo: affaan-m/ECC
Popularidade
- Estrelas no GitHub
- 280 mil
- Posição no ranking
- #209
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
accessibility
Ajuda seu agente a criar interfaces que todos possam usar. Garante que sites e aplicativos funcionem bem para pessoas com deficiência, como cegos ou com mobilidade reduzida.
affaan-m/ECC
agent-architecture-audit
Faz seu agente verificar se tudo está funcionando corretamente. Ele encontra e conserta problemas em sistemas de IA, garantindo que funcionem como esperado.
affaan-m/ECC
agent-eval
Ajuda seu agente a comparar diferentes ferramentas de programação de IA. Ele mede qual é mais rápido, barato e confiável para realizar tarefas específicas.
affaan-m/ECC
agent-harness-construction
Faz seu agente entender melhor como realizar tarefas. Ele otimiza as ferramentas e instruções que o agente usa para aumentar suas chances de sucesso.
affaan-m/ECC
Skills parecidas
template-skill
Este é um modelo genérico para novas habilidades. Ele precisa de uma descrição específica para ser útil.
anthropics/skills
shipping-and-launch
Prepara seu código para ser lançado em produção com segurança. Ajuda a garantir que tudo esteja pronto, monitorado e com um plano de volta.
addyosmani/agent-skills
using-agent-skills
Faz seu agente descobrir e usar outras habilidades. É útil para decidir qual ferramenta ou fluxo de trabalho usar para uma tarefa específica.
addyosmani/agent-skills