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

303 lines
14 KiB
Markdown

---
schema_version: 1
id: home-server.networking
type: reference
scope: [jupiter, mercury, airvpn, downloads, dns, ingress, wireguard, cloudflare]
sensitivity: private-infrastructure
last_reviewed: "2026-10-26"
sources:
- kind: owner-report
reference: "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
repository: jupiter-stacks
revision: working-tree
base_revision: 631e4fdfa4c7122e5eff38e11b070c17ff7a4a2a
paths:
- stacks/downloads/docker-compose.yml
- stacks/traefik/docker-compose.yml
- kind: owner-report
reference: "Network topology, Mercury nginx/iptables/fail2ban output, LAN DNS, 2026-10-06"
- kind: owner-report
reference: "Cloudflare ingress YAML and client SSH configurations, 2026-10-06"
- kind: owner-report
reference: "CGNAT rationale, Docker network and container inspection, 2026-10-06"
- kind: owner-report
reference: "Ultra.cc hostname, qBittorrent UI, SFTP rclone remote/systemd unit and Radarr/Sonarr bind mounts, 2026-10-06"
- kind: owner-report
reference: "Authentik fully deployed with all listed app integrations and Authelia retired, 2026-10-16"
- kind: repository
repository: jupiter-stacks
revision: 610e325ef6a98850511ce7a089b0b9a77bfecf15
paths:
- 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
repository: jupiter-stacks
revision: d09df456ad331b8beb9a40615114ea8aae2dced5
paths:
- stacks/authentik/docker-compose.yml
- stacks/authentik/blueprints/jupiter.yaml
related: [home-server.reference, home-server.host, home-server.mercury, home-server.downloads, home-server.seedbox, home-server.authentication, home-server.operations]
update_triggers: [dns-change, proxy-change, tunnel-change, firewall-change, certificate-change, seedbox-change]
unknowns:
- 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](downloads.md) 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](downloads.md#public-monitoring).
## HTTPS ingress / local downloads
```mermaid
---
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
```mermaid
---
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`.
```sshconfig
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](seedbox.md) page is historical; its service and mount are removed.
See [Storage](storage.md) for current placement and
[Local downloads](downloads.md) for the runbook and remaining checks.
## Mercury
[Mercury VPS](mercury.md): 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](authentication.md) 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.