diff --git a/10-systems/traffic-routes/split-horizon-dns-pfsense.md b/10-systems/traffic-routes/split-horizon-dns-pfsense.md new file mode 100644 index 0000000..029e935 --- /dev/null +++ b/10-systems/traffic-routes/split-horizon-dns-pfsense.md @@ -0,0 +1,80 @@ +--- +owner: gmikcon +status: active +last_reviewed: 2026-11-08 +review_interval: 90d +confidence: high +source_of_truth: live-verified +--- + +# Split-Horizon DNS on pfSense (gnexus.space) + +Split-horizon DNS so that `*.gnexus.space` services resolve to the internal nginx proxy while at home, and work with WAN down (no internet, no external VPS, no OpenVPN tunnel). Implemented 2026-11-08 (navi Eris) with the owner. + +## Current state (verified 2026-11-08, navi Eris) + +### 1. pfSense UI Host Override — apex only + +- Path: Services → DNS Resolver → Host Overrides. +- Record: Host `''` (empty), Domain `gnexus.space`, IP `192.168.1.183`. +- Works: local query for `gnexus.space` → `192.168.1.183`. + +### 2. Unbound Custom Options — all subdomains (explicit list, no wildcard) + +- Path: Services → DNS Resolver → General Settings → Custom Options. +- The pfSense build rejects `*` in the Host Override Host field (validation: A-Z, 0-9, `_`, `-`), and `local-data` wildcard records (`*.gnexus.space`) **load but do not match subdomains** on this Unbound build — verified live: query for literal `*.gnexus.space` answered `.183`, but `navi.gnexus.space` was still forwarded upstream. Explicit per-domain records are the reliable mechanism. + +Content of Custom Options as deployed (18 lines): + +``` +server: +local-data: "auth.gnexus.space. IN A 192.168.1.183" +local-data: "bugtrail.gnexus.space. IN A 192.168.1.183" +local-data: "cloud.gnexus.space. IN A 192.168.1.183" +local-data: "creds.gnexus.space. IN A 192.168.1.183" +local-data: "files.gnexus.space. IN A 192.168.1.183" +local-data: "fuckjira.gnexus.space. IN A 192.168.1.183" +local-data: "git.gnexus.space. IN A 192.168.1.183" +local-data: "hpanel.gnexus.space. IN A 192.168.1.183" +local-data: "jellyfin.gnexus.space. IN A 192.168.1.183" +local-data: "navi.gnexus.space. IN A 192.168.1.183" +local-data: "minecraft.gnexus.space. IN A 192.168.1.183" +local-data: "synapse.gnexus.space. IN A 192.168.1.183" +local-data: "tasks.gnexus.space. IN A 192.168.1.183" +local-data: "tgclientmcp.gnexus.space. IN A 192.168.1.183" +local-data: "transcribe-demo.gnexus.space. IN A 192.168.1.183" +local-data: "transmission.gnexus.space. IN A 192.168.1.183" +local-data: "vmk-marginator.gnexus.space. IN A 192.168.1.183" +``` + +The apex (`gnexus.space`) is intentionally not in this block — it is covered by the UI Host Override above. + +## Why .183 + +- Internal nginx proxy VM `ovpn_reserv` has been on netplan-static `192.168.1.183` since the 2026-10-16/17 blackout (was `.226` via DHCP; `.226` no longer responds). All overrides target `.183`. + +## Verification (2026-11-08, from navi host 192.168.1.168) + +- DNS: 17/17 domains local → `192.168.1.183`; public `@1.1.1.1` → `51.83.131.93` unchanged (zone untouched). +- HTTP via local resolution: 16/17 return 200/302; `transcribe-demo.gnexus.space` returns 502 — upstream `192.168.1.75:5173` is down, pre-existing, unrelated to overrides. +- Minecraft TCP 25565 opens through `.183` (nginx stream). + +## Maintenance procedure — adding a new public domain + +When a new `*.gnexus.space` subdomain goes live on the internal nginx: + +1. Add one line to pfSense DNS Resolver → General Settings → Custom Options: + `local-data: ". IN A 192.168.1.183"` +2. Apply Changes. +3. Verify: `dig +short @192.168.1.1 ` → `192.168.1.183`; public `@1.1.1.1` → `51.83.131.93`. + +## Known follow-ups + +- `transcribe-demo.gnexus.space`: upstream `192.168.1.75:5173` down → 502 locally; public DNS record still points to dead `194.61.53.43` (old s-host). Owner decision needed: revive or decommission. +- WAN-down test (pull the WAN) not yet performed — to run during the next natural outage or on request. + +## Related docs + +- `10-systems/servers/internal-proxy-vps.md` — internal proxy VM, `.183` netplan static. +- `10-systems/servers/external-vps.md` — public entrypoint 51.83.131.93. +- `10-systems/traffic-routes/public-gnexus-space-to-internal-nginx.md` — public route and domain→upstream map.