Files
notes/docs/home-server/networking.md
T
2026-10-27 12:21:10 +00:00

8.1 KiB

schema_version, id, type, scope, sensitivity, last_reviewed, sources, related, update_triggers, unknowns
schema_version id type scope sensitivity last_reviewed sources related update_triggers unknowns
1 home-server.networking reference
jupiter
mercury
dns
ingress
wireguard
cloudflare
private-infrastructure 2026-10-27
kind reference
owner-report DNS/Cloudflare/network snapshots 2026-10-06; ingress cutover verified 2026-10-27
kind reference
live-inspection Traefik/nginx configuration, source rejection, keepalive, WebSockets and tunnel MTU checked 2026-10-27; Immich not running
kind repository revision paths
repository jupiter-stacks 12fb1b96e01fc062fdce4c216f11eb5d7ce716ed
stacks/traefik/docker-compose.yml
stacks/cloudflared/docker-compose.yml
mercury/nginx/conf.d/upstreams.conf
mercury/nginx/umbra.mom
mercury/nginx/john.gatward.dev
mercury/nginx/samstoreymusic.com
home-server.mercury
home-server.downloads
home-server.authentication
home-server.deployment
dns-change
proxy-change
tunnel-change
firewall-change
certificate-change
public-dns-record-types-and-cloudflare-proxy-status
cloudflare-access-policies
wireguard-allowedips-and-keepalive
jupiter-firewall-policy

Networking

Application ingress

---
config:
  themeCSS: |
    text,.nodeLabel,.cluster-label { fill:var(--infra-text);color:var(--infra-text); }
    .edgeLabel,.edgeLabel p { background:var(--infra-zone);color:var(--infra-text); }
    .flowchart-link { stroke:var(--infra-line); }
    marker path { fill:var(--infra-line);stroke:var(--infra-line); }
    .cluster rect { fill:var(--infra-zone);stroke:var(--infra-border);stroke-dasharray:5 5;rx:12px;ry:12px; }
    .cluster span,.cluster text { color:var(--infra-text)!important;fill:var(--infra-text)!important; }
    .infraClient rect { fill:var(--infra-client-fill);stroke:var(--infra-client-stroke);rx:8px;ry:8px; }
    .infraEdge rect { fill:var(--infra-edge-fill);stroke:var(--infra-edge-stroke);rx:8px;ry:8px; }
    .infraService rect { fill:var(--infra-service-fill);stroke:var(--infra-service-stroke);rx:8px;ry:8px; }
---
flowchart TB
  accTitle: Public and LAN application ingress
  accDescr: Public HTTPS terminates at Mercury; HTTP crosses encrypted WireGuard to Jupiter. LAN HTTPS bypasses Mercury.
  Public["Public clients"]:::infraClient
  LAN["LAN clients"]:::infraClient
  subgraph Mercury["MERCURY / PUBLIC EDGE"]
    Edge["nginx<br/>185.230.217.66<br/>WG 10.0.0.1"]:::infraEdge
    Kuma["Uptime Kuma<br/>127.0.0.1:3001"]:::infraService
  end
  subgraph Jupiter["JUPITER / HOME"]
    Proxy["Traefik<br/>LAN 192.168.1.56<br/>WG 10.0.0.2"]:::infraEdge
    Apps["Application containers"]:::infraService
  end
  Public -->|"HTTPS :443"| Edge
  Edge -->|"HTTP :8081 / encrypted WireGuard"| Proxy
  LAN -->|"HTTPS :443"| Proxy
  Proxy -->|"HTTP / Docker networks"| Apps
  Edge -->|"uptime.umbra.mom / HTTP"| Kuma
  • Cutover verified by owner 2026-10-27; browser/OIDC URLs remain HTTPS.
  • CGNAT requires Mercury's public IPv4; no residential public ingress.
  • Admin hostnames are still public: the tunnel listener is not private admin access.
  • Torrent egress uses a separate path: AirVPN.

Listener and trust boundaries

Traefik entrypoint Behaviour
http, TCP 80 Redirect to HTTPS; not Mercury's upstream
https, TCP 443 TLS + letsencrypt defaults; LAN access and transport rollback
wireguard, 10.0.0.2:8081 HTTP; mercury-only@docker admits TCP source 10.0.0.1/32 only
  • Public routers: entrypoints=https,wireguard; no router-level TLS settings.
  • Local-only routers: HTTPS only, explicit TLS. Separate HTTPS/WireGuard fallbacks redirect unmatched non-apex hosts to https://umbra.mom at priority 1.
  • Forwarded headers trusted only from 10.0.0.1/32 on https and wireguard.
  • nginx sets Host, X-Forwarded-Host, X-Forwarded-Port, X-Forwarded-Proto, X-Real-IP and X-Forwarded-For; client IP is $remote_addr, not an appended untrusted chain.
  • Admission uses connection source, not X-Forwarded-For; forged headers do not bypass the allowlist.
  • Security-header middleware: sslProxyHeaders.X-Forwarded-Proto=https preserves HSTS on the HTTP hop.
  • Docker provider: opt-in labels, network traefik; file provider: /data/traefik/dynamic; custom certificates: /data/traefik/certs.
  • ACME: Cloudflare DNS-01; /data/traefik/acme/acme.json; umbra.mom + *.umbra.mom.
  • Authentication is per application/router, not a universal gate: Authentication.

nginx upstream

  • Shared jupiter_backend: 10.0.0.2:8081; HTTP/1.1; 16 cached idle connections per worker, not a concurrency limit.
  • Connection cleared for normal requests and registry /v2/; upgrade only for WebSockets.
  • Config: /etc/nginx/conf.d/upstreams.conf + three domain files in sites-available/; nginx.conf must include conf.d/*.conf and sites-enabled/* inside http.
  • Gitea /v2/: unlimited body; 900s proxy timeouts.
  • MTU 1420 on both WireGuard interfaces; full-size non-fragmenting probes passed, approximately 7-8 ms RTT. No sustained throughput/CPU benchmark.
  • Rollout and rollback: Deployment.

SSH / Cloudflare Tunnel

---
config:
  themeCSS: |
    text,.nodeLabel { fill:var(--infra-text);color:var(--infra-text); }
    .edgeLabel,.edgeLabel p { background:var(--infra-zone);color:var(--infra-text); }
    .flowchart-link { stroke:var(--infra-line); }
    marker path { fill:var(--infra-line);stroke:var(--infra-line); }
    .infraClient rect { fill:var(--infra-client-fill);stroke:var(--infra-client-stroke);rx:8px;ry:8px; }
    .infraCloud rect { fill:var(--infra-cloud-fill);stroke:var(--infra-cloud-stroke);rx:8px;ry:8px; }
    .infraEdge rect { fill:var(--infra-edge-fill);stroke:var(--infra-edge-stroke);rx:8px;ry:8px; }
    .infraService rect { fill:var(--infra-service-fill);stroke:var(--infra-service-stroke);rx:8px;ry:8px; }
---
flowchart LR
  accTitle: SSH through Cloudflare, separate from application ingress
  accDescr: The client uses cloudflared; Jupiter's outbound connector reaches host SSH or Gitea SSH without Mercury or Traefik.
  Client["SSH client<br/>cloudflared access ssh"]:::infraClient
  Edge["Cloudflare edge"]:::infraCloud
  Tunnel["Jupiter cloudflared<br/>outbound connector"]:::infraEdge
  Host["Host sshd<br/>192.168.1.56:22"]:::infraService
  Git["Gitea SSH<br/>192.168.1.56:2222"]:::infraService
  Client --> Edge <--> Tunnel
  Tunnel -->|"ssh.umbra.mom"| Host
  Tunnel -->|"git.umbra.mom"| Git
  • No Mercury, WireGuard, Traefik or home-router port forwarding on this path.
  • Connector config: /data/cloudflared/config.yaml -> /etc/cloudflared/config.yaml; unmatched ingress: http_status:404.
  • Cloudflare Access login/allow policies remain unconfirmed; SSH origins still authenticate users.
Host jupiter
    User jay
    IdentityFile ~/.ssh/id_ed25519
    ProxyCommand cloudflared access ssh --hostname ssh.umbra.mom

Host git.umbra.mom
    User git
    IdentityFile ~/.ssh/id_ed25519
    ProxyCommand cloudflared access ssh --hostname %h

DNS

Names Destination
Public application names Mercury 185.230.217.66
jellyfin.local.umbra.mom, bookshelf.local.umbra.mom Jupiter LAN 192.168.1.56; bypass Mercury
ssh.umbra.mom, git.umbra.mom Cloudflare Tunnel

Docker networks

2026-10-06 supplied snapshot; use service names, not container IPs.

Network Subnet Internal Role
traefik 172.18.0.0/16 No Application ingress
gitea_network 172.23.0.0/16 No Gitea, runner, builder, Havox
cloudflared_cloudflare 172.26.0.0/16 No Tunnel connector
gitea_data 192.168.96.0/20 Yes Gitea/PostgreSQL
paperless_data 192.168.112.0/20 Yes Paperless/PostgreSQL/Redis
dozzle_dozzle 172.27.0.0/16 Yes Dozzle/socket proxy
  • Newer networks: Downloads, Notes build, Authentik; not part of this snapshot.
  • internal does not block egress through a container's other networks; unused-looking networks are not automatically safe to delete.