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

14 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
airvpn
downloads
dns
ingress
wireguard
cloudflare
private-infrastructure 2026-10-26
kind reference
owner-report AirVPN local downloads and direct home-ISP egress live; public qBittorrent UI and both authentication layers working; Ultra.cc/rclone mount retired; full failure/leak checks outstanding, 2026-10-26
kind repository revision base_revision paths
repository jupiter-stacks working-tree 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
stacks/downloads/docker-compose.yml
stacks/traefik/docker-compose.yml
kind reference
owner-report Network topology, Mercury nginx/iptables/fail2ban output, LAN DNS, 2026-10-06
kind reference
owner-report Cloudflare ingress YAML and client SSH configurations, 2026-10-06
kind reference
owner-report CGNAT rationale, Docker network and container inspection, 2026-10-06
kind reference
owner-report Ultra.cc hostname, qBittorrent UI, SFTP rclone remote/systemd unit and Radarr/Sonarr bind mounts, 2026-10-06
kind reference
owner-report Authentik fully deployed with all listed app integrations and Authelia retired, 2026-10-16
kind repository revision paths
repository jupiter-stacks 610e325ef6a98850511ce7a089b0b9a77bfecf15
stacks/traefik/docker-compose.yml
stacks/cloudflared/docker-compose.yml
stacks/gitea/docker-compose.yml
stacks/jellyfin/docker-compose.yml
stacks/audiobookshelf/docker-compose.yml
kind repository revision paths
repository jupiter-stacks d09df456ad331b8beb9a40615114ea8aae2dced5
stacks/authentik/docker-compose.yml
stacks/authentik/blueprints/jupiter.yaml
home-server.reference
home-server.host
home-server.mercury
home-server.downloads
home-server.seedbox
home-server.authentication
home-server.operations
dns-change
proxy-change
tunnel-change
firewall-change
certificate-change
seedbox-change
public-dns-record-types-and-cloudflare-proxy-status
cloudflare-access-applications-and-login-policies
wireguard-allowedips-and-keepalive
jupiter-firewall-policy
traefik-forwarded-header-trust-configuration
complete-airvpn-failure-dns-and-ipv6-isolation-results

Networking

AirVPN downloads

VPN-isolated local downloads are live by owner report on 2026-10-26. Gluetun connects directly to AirVPN through the home ISP, separate from the existing Mercury tunnel. Ultra.cc and the rclone/FUSE mount are retired. This cuts subscription costs and removes the remote-storage/import dependency. Full failure, DNS and IPv6 isolation checks are still outstanding.

Public monitoring at qbittorrent.umbra.mom is working: Mercury's wildcard HTTPS ingress reaches Traefik, which joins downloads and applies Authentik per-user/MFA protection before proxying to gluetun:8080. The outpost callback hostname is registered separately. This does not route torrent egress through Mercury; see the public-monitoring deployment steps.

HTTPS ingress / local downloads

---
config:
  themeCSS: |
    .node rect { rx: 8px; ry: 8px; stroke-width: 1.5px; }
    .cluster rect { fill: var(--infra-zone) !important; stroke: var(--infra-border) !important; stroke-dasharray: 5 5; rx: 12px; ry: 12px; }
    .label, .nodeLabel, .cluster-label { color: var(--infra-text) !important; }
    .edgeLabel, .edgeLabel p { background-color: var(--infra-zone) !important; color: var(--infra-text) !important; }
    .flowchart-link { stroke: var(--infra-line) !important; }
    marker path { fill: var(--infra-line) !important; stroke: var(--infra-line) !important; }
    .infraClient rect { fill: var(--infra-client-fill) !important; stroke: var(--infra-client-stroke) !important; }
    .infraEdge rect { fill: var(--infra-edge-fill) !important; stroke: var(--infra-edge-stroke) !important; }
    .infraService rect { fill: var(--infra-service-fill) !important; stroke: var(--infra-service-stroke) !important; }
  flowchart:
    curve: basis
    nodeSpacing: 35
    rankSpacing: 55
---
flowchart TB
  Internet["<b>Public clients</b>"]

  subgraph VPS["MERCURY / PUBLIC EDGE"]
    Nginx["<b>nginx</b><br/>185.230.217.66<br/>WireGuard 10.0.0.1"]
    Uptime["<b>Uptime service</b><br/>127.0.0.1:3001"]
    Nginx -->|"uptime.umbra.mom / HTTP"| Uptime
  end

  subgraph Home["JUPITER / HOME SERVER"]
    LAN["<b>LAN clients</b><br/>Jellyfin / Bookshelf local DNS"]
    Traefik["<b>Traefik</b><br/>192.168.1.56<br/>WireGuard 10.0.0.2"]
    Apps["<b>Application containers</b><br/>Docker network: traefik"]
    Arr["<b>Radarr / Sonarr</b><br/>Download control / media imports"]
    Qbit["<b>qBittorrent</b><br/>Shared Gluetun namespace"]
    Gluetun["<b>Gluetun</b><br/>WireGuard / firewall<br/>downloads Docker network"]
    Downloads["<b>Local torrents / libraries</b><br/>/data/jellyfin<br/>Hardlink imports"]
    Router["<b>Home router / ISP</b><br/>Encrypted VPN underlay"]
    LAN -->|"HTTPS :443"| Traefik
    Traefik -->|"Application routing"| Apps
    Traefik -->|"Media management UIs"| Arr
    Traefik -->|"Authentik + qBittorrent login / :8080"| Gluetun
    Gluetun -->|"Web UI / API"| Qbit
    Arr -->|"downloads network / gluetun:8080"| Gluetun
    Arr -->|"Local hardlink imports"| Downloads
    Qbit -->|"Writes downloads"| Downloads
    Qbit -->|"VPN-only torrent traffic"| Gluetun
    Gluetun -->|"Encrypted AirVPN WireGuard"| Router
  end

  AirVPN["<b>AirVPN</b><br/>Public VPN exit / reserved peer port"]
  Peers["<b>Torrent peers</b>"]
  Internet -->|"HTTPS :443"| Nginx
  Nginx -->|"HTTPS :443 over WireGuard"| Traefik
  Router -->|"Home ISP / not Mercury"| AirVPN
  AirVPN <-->|"Torrent traffic"| Peers

  class Internet,LAN,Peers infraClient
  class Nginx,Traefik,Router,AirVPN infraEdge
  class Apps,Uptime,Arr,Gluetun,Qbit,Downloads infraService

Cloudflare Tunnel

---
config:
  themeCSS: |
    .node rect { rx: 8px; ry: 8px; stroke-width: 1.5px; }
    .cluster rect { fill: var(--infra-zone) !important; stroke: var(--infra-border) !important; stroke-dasharray: 5 5; rx: 12px; ry: 12px; }
    .label, .nodeLabel, .cluster-label { color: var(--infra-text) !important; }
    .edgeLabel, .edgeLabel p { background-color: var(--infra-zone) !important; color: var(--infra-text) !important; }
    .flowchart-link { stroke: var(--infra-line) !important; }
    marker path { fill: var(--infra-line) !important; stroke: var(--infra-line) !important; }
    .infraClient rect { fill: var(--infra-client-fill) !important; stroke: var(--infra-client-stroke) !important; }
    .infraCloud rect { fill: var(--infra-cloud-fill) !important; stroke: var(--infra-cloud-stroke) !important; }
    .infraEdge rect { fill: var(--infra-edge-fill) !important; stroke: var(--infra-edge-stroke) !important; }
    .infraService rect { fill: var(--infra-service-fill) !important; stroke: var(--infra-service-stroke) !important; }
  flowchart:
    curve: basis
    nodeSpacing: 35
    rankSpacing: 45
---
flowchart TB
  Shell["<b>SSH client</b><br/>Host jupiter / user jay"]
  Git["<b>Git over SSH</b><br/>Host git.umbra.mom / user git"]
  Cloud["<b>Cloudflare Tunnel edge</b><br/>Access policy unconfirmed"]

  subgraph Home["JUPITER / HOME SERVER"]
    Connector["<b>cloudflared</b><br/>Locally configured ingress"]
    SSH["<b>Host sshd</b><br/>192.168.1.56:22"]
    Gitea["<b>Gitea SSH</b><br/>192.168.1.56:2222"]
    Connector -->|"ssh.umbra.mom / SSH :22"| SSH
    Connector -->|"git.umbra.mom / SSH :2222"| Gitea
  end

  Shell -->|"cloudflared access ssh / ssh.umbra.mom"| Cloud
  Git -->|"cloudflared access ssh / git.umbra.mom"| Cloud
  Cloud <-->|"Tunnel traffic / initiated outbound by Jupiter"| Connector

  class Shell,Git infraClient
  class Cloud infraCloud
  class Connector infraEdge
  class SSH,Gitea infraService

Client cloudflared transports SSH through Cloudflare; Jupiter's connector opens the outbound tunnel. Origins still perform SSH authentication. No Mercury, WireGuard, or Traefik hop on this path; no home-router port forwarding.

Ingress hostname Origin Client SSH user
ssh.umbra.mom ssh://192.168.1.56:22 jay
git.umbra.mom ssh://192.168.1.56:2222 git
Unmatched http_status:404 N/A

Both client configurations use IdentityFile ~/.ssh/id_ed25519.

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

Local tunnel configuration is separate from Cloudflare Access applications. Access login/provider/allow rules remain unconfirmed; ProxyCommand alone does not establish enforcement.

Ingress source: host /data/cloudflared/config.yaml, mounted at /etc/cloudflared/config.yaml.

DNS / routes

DNS / route Destination
Public service ingress Mercury 185.230.217.66
jellyfin.local.umbra.mom Jupiter 192.168.1.56
bookshelf.local.umbra.mom Jupiter 192.168.1.56
ssh.umbra.mom, git.umbra.mom Cloudflare Tunnel
uptime.umbra.mom Mercury nginx -> http://127.0.0.1:3001
qbittorrent.umbra.mom Mercury -> Traefik -> Authentik -> Gluetun/qBittorrent 8080; native login retained
gluetun:8080 Internal authenticated qBittorrent API on the downloads Docker network

Download connectivity

qBittorrent now runs on Jupiter in Gluetun's network namespace. The enabled Gluetun firewall and qBittorrent's wg0 binding are configured for VPN-only torrent egress. AirVPN's reserved peer port is allowed through the VPN firewall, not published on Jupiter or forwarded on the home router. Working downloads alone do not demonstrate inbound peer reachability or failure isolation.

Sonarr/Radarr and optional Prowlarr direct downloads use gluetun:8080 with native qBittorrent credentials, not the public Authentik-protected URL. Their ordinary internet routes and Prowlarr/FlareSolverr indexer traffic remain outside AirVPN. The Web UI also has a loopback-only 127.0.0.1:8080 publication for private SSH forwarding.

Imports now use local storage and hardlinks, not SFTP/FUSE. The former Seedbox page is historical; its service and mount are removed. See Storage for current placement and Local downloads for the runbook and remaining checks.

Mercury

Mercury VPS: native nginx; WireGuard server 10.0.0.1/24; Jupiter client 10.0.0.2/24. Hosting, TLS, firewall and fail2ban details are maintained on that page.

Home ISP uses CGNAT. Mercury supplies a static public IPv4 and forwards over WireGuard; owner preference is to avoid public ingress via the residential IP.

Observed Docker networks

Snapshot from supplied inspection, not fixed-address configuration. Container IPs may change; use Docker service names.

Network IPv4 subnet Internal Observed role
traefik 172.18.0.0/16 No Reverse proxy and application ingress
gitea_network 172.23.0.0/16 No Gitea, runner, notes builder, Havox sync
cloudflared_cloudflare 172.26.0.0/16 No Tunnel connector
gitea_data 192.168.96.0/20 Yes Gitea and PostgreSQL
paperless_data 192.168.112.0/20 Yes Paperless, PostgreSQL, Redis
dozzle_dozzle 172.27.0.0/16 Yes Dozzle and socket proxy

Cloudflared's observed 172.26.0.2 matches the supplied proxied SSH login source. An internal network alone does not isolate a multi-network container from egress through its other networks. Empty network entries do not establish whether they are obsolete or safe to remove.

The newer downloads bridge is defined with IPv6 disabled and is not internal. Gluetun, Traefik, Sonarr, Radarr and Prowlarr attach to it; qBittorrent shares Gluetun's namespace rather than joining independently. Its subnet was not recorded. This supplements, rather than re-inspects, the older table.

Jupiter: repository configuration

  • Traefik publishes TCP 80,443; HTTP redirects to HTTPS.
  • Docker provider: opt-in traefik.enable=true; external network traefik.
  • File provider: /data/traefik/dynamic.
  • ACME: Let's Encrypt; Cloudflare DNS-01; /data/traefik/acme/acme.json; apex + *.umbra.mom certificate requested.
  • HTTPS fallback: priority 1; unmatched non-apex hosts redirect to https://umbra.mom.
  • cloudflared: /data/cloudflared -> /etc/cloudflared; stack-local bridge cloudflare; no published ports.

Authentication routing

Authentik serves auth.umbra.mom through Traefik to authentik-server:9000; the server joins the external traefik network. The ingress diagrams show transport, not a universal authentication gate. Native OIDC integrations are listed on the authentication page; Backrest, Notes, Prowlarr, Radarr, Sonarr and qBittorrent use Traefik middleware authentik@docker and the embedded outpost. Dozzle (logs.umbra.mom) now uses OIDC, not forward-auth.

On the six proxy-protected hostnames, a priority-1000 /outpost.goauthentik.io/ route goes straight to Authentik without forward-auth to handle callbacks. Other application requests use their normal routers. The middleware trusts forwarded headers; this is not evidence that the wider Mercury/Traefik forwarded-header trust chain is configured.

Authentik also publishes 127.0.0.1:9000 for private host access. Repository-defined networks (not part of the older observed-network snapshot): authentik-data is internal and connects PostgreSQL, server and worker; the worker also joins authentik-egress. The server's additional traefik attachment means the internal data network is not complete egress isolation.