Network Topology - Because Nobody Wants to Debug This Mess Later

Networks are complex enough—let’s not make future troubleshooting harder. Proper documentation now saves headaches later.

Note: All IPs are either RFC 5737/4849 test addresses or RFC 1918 private ranges. Don’t expect them to work on the public internet.


Cloud Providers & Colocation

Track where your infrastructure lives. It’ll save you time when things break.

1
2
3
# Quick provider lookup
whois 203.0.113.54
whois $(dig +short roll.urown.net)
ProviderNickname
Amazon Web Servicesaws
Google Cloudgcp
Microsoft Azureazure
Vultrvultr
Scalewayscale
Netcupnetcup
Oracle Cloudoracle
Hetzner Cloudhetzner

Locations

Physical presence by city/data center.

LocationCode
Los AngelesLAX
ChicagoCHI
ParisPAR
TokyoTYO
SydneySYD
MadridMAD
ZurichZRH
JohannesburgJNB
São PauloGRU

Public IPs & Subnets

Assigned by upstreams. IPv6 is available in some regions.

ProviderLocationIPv4 SubnetIPv6 Subnet
vultrNYC203.0.113.101/322001:db8:abcd:1::/64
scaleAMS198.51.100.42/322001:db8:abcd:2::/64
netcupMUC192.0.2.77/322001:db8:abcd:3::/64
oracleMADdynamic2001:db8:abcd:4::/48
azureSYDdynamicdynamic
gcpTYOdynamicn/a

Internal Network Ranges

RFC 1918 ranges for internal use.

1
2
3
# Generate random subnets
echo 172.$((RANDOM%16+16)).0.0/24
echo home 172.27.$((RANDOM%255+16)).0/24
SiteCityIPv4 SubnetMaskCIDRNotes
homeFrankfurt172.27.88.0255.255.255.0172.27.88.0/24Home LAN
officeFrankfurt172.27.126.0255.255.255.0172.27.126.0/24Office LAN
mamaBerlin172.27.74.0255.255.255.0172.27.74.0/24Mom’s network
guestFrankfurt172.27.99.0255.255.255.0172.27.99.0/24Guest VLAN
labFrankfurt172.27.150.0255.255.255.0172.27.150.0/24Lab VLAN

RFC 1918 Private Address Space

Reference for internal-only addressing.

Network AddressNetmaskCIDR
10.0.0.0255.0.0.010/8
172.16.0.0255.240.0.0172.16/12
192.168.0.0255.255.0.0192.168/16

IPv6 ULA (Unique Local Addresses)

For internal IPv6, use ULA ranges.

SiteCityULA SuffixULA IPv6 Subnet
homeFrankfurt13a6fdc1:d89e:b128:13a6::/64
officeFrankfurt2615fdc1:d89e:b128:2615::/64
mamaBerlin41c5fdc1:d89e:b128:41c5::/64

VPN Overlay Network

Overlay connects all sites. Use distinct subnets.

1
2
# Generate VPN subnet in 10.100.x.x/24
echo 10.100.$((RANDOM%200+20)).0/24
NetworkScopeIPv4 SubnetIPv6 Subnet
coreGlobal172.27.0.0/16fdc1:d89e:b128::/48
homeFRA172.27.88.0/24fdc1:d89e:b128:13a6::/64
officeFRA172.27.126.0/24fdc1:d89e:b128:2615::/64
mamaBER172.27.74.0/24fdc1:d89e:b128:41c5::/64
overlayVPN10.100.42.0/24fdc1:d89e:b128:6a04::/64

Domain Registration

Own your domain.

DomainRegistrar
example.netActualHousecat

DNS Zones by Location

Organize DNS by site for clarity.

SubdomainLocationIPv4 SubnetIPv6 Subnet
.Global172.27.0.0/16fdc1:d89e:b128::/48
homeFRA172.27.88.0/24fdc1:d89e:b128:13a6::/64
officeFRA172.27.126.0/24fdc1:d89e:b128:2615::/64
mamaBER172.27.74.0/24fdc1:d89e:b128:41c5::/64

VPN DNS Zone

Overlay DNS: mesh.example.net

FQDNIPv4 AddressIPv6 Address
apollo.mesh.example.net10.100.55.10fdc1:d89e:b128:7b01::1010
cassini.mesh.example.net10.100.55.20fdc1:d89e:b128:7b01::2020
galileo.mesh.example.net10.100.55.30fdc1:d89e:b128:7b01::3030
voyager.mesh.example.net10.100.55.40fdc1:d89e:b128:7b01::4040

Server Naming

Use neutral names for flexibility. (Halo references.)

HostLocationProviderRole
chiefSFOhetznerServer
cortanaLONrackServer
arbiterPHOrollerServer
keysFRAhomeRouter
johnsonFRAhomeNAS
guiltysparkFRAhomeWi-Fi AP
halseyFRAhomeServer
mirandaFRAofficeRouter
tartarusFRAofficeNAS
truthBERmamaRouter

DNS Configuration

Ensure all hosts are reachable. Dynamic DNS is used for home connections.

Root Domain: example.net

FQDNIPv4 AddressIPv6 Address
apollo.example.net203.0.113.54N/A
cassini.example.net198.51.100.72001:db8:48d1::1
galileo.example.net192.0.2.142001:db8:2d07:5b57::0
voyager.example.netdynamic2001:db8:3414:6b1d::1
pioneer.example.netdynamic2001:db8:3414:6b1d::10
kepler.example.netdynamicdynamic

Home Lab: home.example.net

FQDNIPv4 AddressIPv6 Address
chief.home.example.net172.27.88.1fdc1:d89e:b128:13a6::1
cortana.home.example.net172.27.88.10fdc1:d89e:b128:13a6::10
arbiter.home.example.net172.27.88.3fdc1:d89e:b128:13a6::3

Office: office.example.net

FQDNIPv4 AddressIPv6 Address
keys.office.example.net172.27.126.1fdc1:d89e:b128:2615::1
johnson.office.example.net172.27.126.10fdc1:d89e:b128:2615::10

Mom’s Place: mama.example.net

FQDNIPv4 AddressIPv6 Address
guiltyspark.mama.example.net172.27.74.1fdc1:d89e:b128:41c5::1