8.1 KiB
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 |
|
private-infrastructure | 2026-10-27 |
|
|
|
|
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.momat priority1. - Forwarded headers trusted only from
10.0.0.1/32onhttpsandwireguard. - nginx sets
Host,X-Forwarded-Host,X-Forwarded-Port,X-Forwarded-Proto,X-Real-IPandX-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=httpspreserves 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. Connectioncleared for normal requests and registry/v2/;upgradeonly for WebSockets.- Config:
/etc/nginx/conf.d/upstreams.conf+ three domain files insites-available/;nginx.confmust includeconf.d/*.confandsites-enabled/*insidehttp. - Gitea
/v2/: unlimited body;900sproxy 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.
internaldoes not block egress through a container's other networks; unused-looking networks are not automatically safe to delete.