VLANs and Routing
Canonical per-site VLAN prefixes, gateway ownership, local-only networks, DHCP scopes, and special transit or sink VLANs.
VLAN IDs align across sites, but their active use is site-specific. OPNsense owns routed gateways; Corosync and storage planes stay local with no gateway. Site A also uses VLAN 999 as a native sink and omits the Site B-only VLAN 253 transit.
Canonical VLAN Plan
| VLAN | Purpose | Site A prefix and state | Site B prefix and state |
|---|---|---|---|
| 10 | Network Mgmt / IPMI | 10.10.10.0/24; OPNsense 10.10.10.1 | 10.20.10.0/24; OPNsense 10.20.10.1 |
| 20 | Proxmox Management | 10.10.20.0/24; OPNsense 10.10.20.1 | 10.20.20.0/24; OPNsense 10.20.20.1 |
| 25 | Corosync heartbeat | 10.10.25.0/24; no gateway | 10.20.25.0/24; no gateway |
| 30 | VM Services | 10.10.30.0/24; OPNsense 10.10.30.1 | 10.20.30.0/24; OPNsense 10.20.30.1 |
| 40 | Kubernetes Nodes | 10.10.40.0/22; OPNsense 10.10.40.1 | 10.20.40.0/22; OPNsense 10.20.40.1 |
| 50 | K8s LB / VIPs | 10.10.50.0/24; OPNsense 10.10.50.1 | 10.20.50.0/24; OPNsense 10.20.50.1 |
| 60 | Storage / Ceph public | 10.10.60.0/24; no gateway | 10.20.60.0/24; no gateway |
| 65 | Ceph cluster | 10.10.65.0/24; reserved and not carried | 10.20.65.0/24; no gateway |
| 70 | DMZ | 10.10.70.0/24; OPNsense 10.10.70.1 | 10.20.70.0/24; OPNsense 10.20.70.1 |
| 80 | Monitoring | 10.10.80.0/24; OPNsense 10.10.80.1 | 10.20.80.0/24; OPNsense 10.20.80.1 |
| 90 | Backup / Replication | 10.10.90.0/24; OPNsense 10.10.90.1 | 10.20.90.0/24; OPNsense 10.20.90.1 |
| 100 | Lab / Trusted Client | 10.10.100.0/22; OPNsense 10.10.100.1 | 10.20.100.0/22; OPNsense 10.20.100.1 |
| 110 | IoT | 10.10.110.0/24; OPNsense 10.10.110.1 | 10.20.110.0/24; OPNsense 10.20.110.1 |
| 120 | Guest WiFi | 10.10.120.0/24; OPNsense 10.10.120.1 | 10.20.120.0/24; OPNsense 10.20.120.1 |
| 253 | UniFi WAN transit | Absent; 10.10.253.0/24 reserved | 10.20.253.0/24; OPNsense .1, USG Pro WAN .2 |
| 999 | Native sink / quarantine | No subnet, gateway, DHCP, or clients | Not used |
Site A Has One Layer 3 Owner
OPNsense owns every routed Site A .1. The three UniFi switches remain Layer 2
only. VLANs 25 and 60 have no gateway; VLAN 65 is not carried; VLAN 999 has no
IP configuration.
Routing Classes
| Class | VLANs | Behavior |
|---|---|---|
| Routed zones | 10, 20, 30, 40, 50, 70, 80, 90, 100, 110, 120 | OPNsense provides the local gateway and applies stateful policy |
| Local-only data planes | 25, 60 | Direct attachment only; no default gateway or inter-site route |
| Site B local-only Ceph plane | 65 | Direct Ceph cluster attachment; never route to VLAN 60 |
| Reserved Site A Ceph plane | 65 | Prefix reserved, but the VLAN is not carried |
| Site B legacy transit | 253 | OPNsense-to-USG Pro WAN handoff only |
| Site A native sink | 999 | Untagged trunk traffic reaches a non-routed dead end |
VLAN 4040 is a retired Site A Layer 3 transit proposal and must not be configured. The Site A port profiles that determine tagged carriage are on the Site A Port Map; Site B carriage is on the Site B Port Map.
Site A DHCP Scopes
OPNsense serves DHCP only where dynamic Site A clients exist. Infrastructure uses static addresses or documented reservations.
| VLAN | Scope | DNS during target-LAN commissioning | DNS after Technitium cutover |
|---|---|---|---|
| 100 | 10.10.100.50-10.10.103.199 | Local OPNsense interface | 10.10.30.10, 10.10.30.11 |
| 110 | 10.10.110.50-10.10.110.199 | Local OPNsense interface | 10.10.30.10, 10.10.30.11 |
| 120 | 10.10.120.50-10.10.120.199 | Local OPNsense interface | 10.10.30.10, 10.10.30.11 |
Site B Remains Parked
The active Site A campaign does not revise Site B VLAN or DHCP behavior. Exact Site B implementation work waits for a separate, owner-approved campaign.
Related References
- Routing and Firewall Policy: required permits and mandatory denies by zone
- Address Space and Lifecycle: site summaries, bootstrap ranges, and reserved space
- Address Allocation Rules: role bands and stable host octets
- DHCP and IPAM Operations: scope ownership, reservations, and conflict prevention
- OPNsense: routed-interface, NAT, and firewall implementation
- Interactive VLAN Matrix: visual comparison of segment purpose and site use
Networking
Orientation to the homelab network model, traffic boundaries, address and policy references, validation runbooks, and packet-flow troubleshooting.
Routing and Firewall Policy Matrix
Exact Site A zone outcomes, narrow required permits, mandatory denies, service objects, and the evidence required before a firewall rule is accepted.