c0030 - Port-Übersicht aller Apps
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/c-netzwerk-dns/c0030-port-uebersicht.md
Port-Übersicht aller Apps
Diese Seite listet für jede laufende App: den internen Kubernetes-Service
(ClusterIP:Port), wie sie im LAN erreichbar ist (Traefik-Ingress) und ob/wie
sie zusätzlich extern über den Cloudflare Tunnel erreichbar ist. Die Werte
stammen aus den values.yaml-Dateien unter argocd/apps/; bei Abweichungen
zählt der Live-Stand (kubectl get svc -A / kubectl get ingress -A, je
Cluster, siehe a0010).
Die zwei Wege rein
LAN: Client → dnsmasq (192.168.178.94) → IP des Clusters, in dem die App läuft
TECH 192.168.178.94 · PROD 192.168.178.99 · ENTW 192.168.178.100
→ Traefik des Clusters :80/443 (k3s-ServiceLB, Host-Ports)
→ Host-Header "xyz.tier.homeserver" → passender Service
Internet: Client → xyz-tier.pke-lab.de → Cloudflare Edge
→ cloudflared des Clusters (outbound-only, kein offener Router-Port)
→ Traefik (Wildcard-Regel *.pke-lab.de)
→ Host-Header "xyz-tier.pke-lab.de" → passender Service
tier ist tech (Infrastruktur/Admin), prod (echter Nutzerkreis) oder dev (ENTW). Das Tier
sagt nichts über den Cluster: welche IP ein Name bekommt, entscheidet das DNS
(*.homeserver → TECH, *.dev.homeserver → ENTW, Einzelhosts aus dnsmasq_prod_vm_hosts → PROD).
Details und die vollständige Zuordnung: capulus-core/c-netzwerk-dns/c0040-domain-tiers.md.
Intern per Punkt (xyz.tier.homeserver), extern per Bindestrich
(xyz-tier.pke-lab.de) — Grund: Cloudflares kostenloses Zertifikat deckt
nur eine Label-Ebene ab, siehe
capulus-core/c-netzwerk-dns/c0040-domain-tiers.md → Warum Punkt intern, Bindestrich extern.
Wichtig: cloudflared braucht keinen Port-Forward am Router. Der Tunnel
baut die Verbindung von innen nach außen auf (siehe
capulus-core/e-externe-erreichbarkeit/e0000-cloudflare-tunnel.md). TECH und PROD haben je
ein eigenes cloudflared mit eigenem Tunnel; jedes kennt nur eine Wildcard-Regel (*.pke-lab.de)
und leitet alles an den Traefik seines Clusters weiter. Welche Hostnamen tatsächlich extern
erreichbar sind, entscheidet ausschließlich, welche Apps zusätzlich zu
ihrem *.homeserver-Host auch einen *-pke-lab.de-Host in der eigenen
ingress.hosts-Liste tragen (siehe capulus-core/c-netzwerk-dns/c0040-domain-tiers.md).
Nicht jede App mit LAN-Ingress ist automatisch auch extern erreichbar.
Web-Apps (Traefik-Ingress, LAN via *.tier.homeserver)
| App | Tier | Cluster | Namespace | Interner Service:Port | LAN (*.tier.homeserver) |
Extern (*-tier.pke-lab.de) |
|---|---|---|---|---|---|---|
| Immich | prod | PROD | immich | immich-server:80 | immich.prod.homeserver | immich-prod.pke-lab.de |
| Nextcloud | prod | PROD | nextcloud | nextcloud:80 | nextcloud.prod.homeserver | nextcloud-prod.pke-lab.de |
| Paperless-ngx | prod | PROD | paperless-ngx | paperless-ngx:80 | paperless.prod.homeserver | — (nur LAN/Tailnet) |
| Wiki.js | prod | PROD | wikijs | wikijs:80 | wiki.prod.homeserver | wiki-prod.pke-lab.de |
| Xibo CMS | prod | PROD | xibosignage | xibosignage-cms:80 | xibo.prod.homeserver | xibo-prod.pke-lab.de |
| example-whoami | prod | PROD | example-whoami | example-whoami:80 | whoami.prod.homeserver | — |
| Vaultwarden | tech (Ausnahme) | TECH | vaultwarden | vaultwarden:80 | vault.tech.homeserver | vault-tech.pke-lab.de |
| Zammad | tech (Ausnahme) | TECH | zammad | zammad-nginx:8080 | zammad.tech.homeserver | support-tech.pke-lab.de |
| ticket-gate | tech | TECH | ticket-gate | ticket-gate:80 | ticket-gate.tech.homeserver | ticket-gate-tech.pke-lab.de |
| n8n | prod | TECH | n8n | n8n:80 | n8n.prod.homeserver | nur instagram-bilder-prod.pke-lab.de/webhook/instagram-bild (Bild-Abruf durch Meta, 300l0); sonst aus Cloudflare Tunnel entfernt, Security |
| MediaMTX (Playback) | prod | TECH | mediamtx | mediamtx:8888 (HLS) | stream.prod.homeserver | stream-prod.pke-lab.de |
| Uptime Kuma | prod | TECH | uptime-kuma | uptime-kuma:80 | uptime-kuma.prod.homeserver, uptime-kuma-native.prod.homeserver | status-prod.pke-lab.de |
| Alamos-Apager | prod | TECH | alamos-apager | alamos-apager:8080 | alamos-apager.prod.homeserver | — |
| Alamos-Relay | prod | TECH | alamos-relay | alamos-relay:8080 | alamos-relay.prod.homeserver | alamos-relay-prod.pke-lab.de |
| ISC-News-Bot | tech | TECH | isc-news-bot | isc-news-bot:8080 | — (nur cluster-intern, n8n ruft auf) | — |
| Alert-Caller (Telefon-Alarm) | tech | TECH | alert-caller | alert-caller:9310 (Host-Netzwerk auf homeserver, RTP UDP 10000-10100 ausgehend) |
— (nur cluster-intern, Alertmanager ruft auf) | — |
| Homeserver-Dashboard-API | prod | TECH | carplay-api | carplay-api:80 | carplay-api.prod.homeserver | — |
| pacman | prod | TECH | pacman | pacman:80 | pacman.prod.homeserver | pacman-prod.pke-lab.de |
| lldap (Web-UI) | tech | TECH | lldap | lldap:17170 (LDAP: 3890) | lldap.tech.homeserver | — |
| ntfy | tech | TECH | ntfy | ntfy:80 | ntfy.tech.homeserver | ntfy-tech.pke-lab.de |
| Grafana | tech | TECH | monitoring | monitoring-grafana:80 | grafana.tech.homeserver | grafana-tech.pke-lab.de |
| Semaphore | tech | TECH | semaphore | semaphore:3000 | semaphore.tech.homeserver, semaphore-api.tech.homeserver | — |
| Pi-hole (Web-UI) | tech | TECH | pihole | pihole:80 | pihole.tech.homeserver | — |
| Argo Workflows | tech | TECH | argo-workflows | argo-workflows-server:2746 | argo-workflows.tech.homeserver | — |
| Headlamp | tech | TECH | headlamp | headlamp:80 | headlamp.tech.homeserver | — |
| ArgoCD (Web-UI) | tech | TECH | argocd | argocd-server:80 | argocd.tech.homeserver | — |
| kubeseal-webgui | tech | TECH | kubeseal-webgui | kubeseal-webgui:8080 | kubeseal-webgui.tech.homeserver | — |
| VictoriaMetrics/-Logs (Schreib-Endpunkte) | tech | TECH | monitoring / logging | siehe Charts | vm-write.tech.homeserver, logs-write.tech.homeserver | — |
| demo-app / example-whoami (ENTW) | dev | ENTW | demo-app / example-whoami | — | demo.dev.homeserver / whoami.dev.homeserver | — |
Die Spalte Cluster zeigt, wo die App läuft. Externe Hosts tragen tatsächlich nur die Apps mit einem
Eintrag in der letzten Spalte — alle anderen (auch alle mit „—") sind ausschließlich über LAN/Tailscale
erreichbar, egal was die Wildcard-Regel von cloudflared theoretisch matchen würde (siehe
capulus-core/c-netzwerk-dns/c0040-domain-tiers.md).
Alle *.homeserver- und alle *.pke-lab.de-Hosts laufen über den Traefik des jeweiligen Clusters
(auf :80/:443 der Cluster-IP) — kein individueller Port pro App nötig,
Traefik routet in beiden Fällen per Host-Header. cloudflared selbst
terminiert keinen Traffic an einem App-Service direkt, sondern reicht
alles an Traefik weiter (argocd/apps/tech/cloudflared/values.yaml bzw.
argocd/apps/prod/cloudflared/values.yaml → ingress.rules, eine Wildcard-Regel statt einer Regel pro App).
Sonderfälle mit eigenen Ports
| Was | Port(s) | Erreichbar über | Bemerkung |
|---|---|---|---|
| Pi-hole DNS | 53/UDP+TCP | NodePort homeserver:30053 |
Nur LAN/Tailnet, siehe capulus-core/c-netzwerk-dns/c0000-dns-architecture.md |
| MediaMTX Publish (RTMP) | 1935 | NodePort homeserver:31935 |
Für OBS/ffmpeg-Encoder, bewusst NICHT über Cloudflare (siehe capulus-core/3-apps-workloads/30040-mediamtx.md) |
| MediaMTX Publish (RTSP) | 8554 | NodePort homeserver:31554 |
s.o., nur LAN/Tailnet |
| MediaMTX WebRTC | 8889 | Nur ClusterIP intern | Kein eigener Ingress-Host, wird intern vom HLS-Player-Frontend genutzt |
| MediaMTX API | 9997 | Nur ClusterIP intern | Kein externer Zugriff |
| ArgoCD-Hub (UI, CLI, CI) | 443 | Traefik-Ingress argocd.tech.homeserver |
HTTPS mit internem Zertifikat. Der Service ist ClusterIP, es gibt keinen NodePort mehr (Incident 013). CLI mit --grpc-web. |
| ArgoCD ENTW (UI, CLI, CI) | 443 | Traefik-Ingress argocd.dev.homeserver auf entw-vm |
HTTPS, Zertifikat aus der Homeserver-Root-CA (jährlich neu ausgestellt), Service ClusterIP, siehe b0050 |
| Tailscale (SSH/Admin) | — | Tailnet-IP des Nodes | Siehe capulus-core/c-netzwerk-dns/c0010-tailscale.md |
| WireGuard Backup-VPN | UDP, wireguard_backup_port (Default 51888) |
Router-Portforward → Homeserver-LAN-IP | Notfall-Fallback falls Tailscale ausfällt, genau 1 Peer, kein LAN-Routing. Siehe capulus-core/c-netzwerk-dns/c0011-wireguard-backup.md |
NodePorts und LoadBalancer laufen an UFW vorbei. Der Verkehr wird in PREROUTING auf den Pod umgeschrieben und läuft dann durch die
FORWARD-Kette, wo KUBE-ROUTER-FORWARD und KUBE-FORWARD ihn vor UFW annehmen. Die UFW-Regeln für 80, 443 und den früheren ArgoCD-NodePort 30080 hatten über Wochen 0 Treffer
(belegt am 2026-10-17). Beschränkt wird ein NodePort deshalb nur dadurch, dass die Node-IP nur aus dem LAN und über die Tailscale-Subnet-Route erreichbar
ist, und durch die NetworkPolicies im Ziel-Namespace. Ein neuer NodePort braucht keine UFW-Regel, sie würde auch nichts bewirken. UFW wirkt nur auf Dienste, die
direkt auf dem Host lauschen (SSH, DNS, CUPS, SANE, k3s-API, Exporter).
Interne Dienste ohne Ingress (nicht von außen erreichbar)
Diese laufen rein als ClusterIP und werden nur von anderen Pods im Cluster
angesprochen (Datenbanken, Caches, interne Bridges, Batch-Jobs):
| App/Komponente | Namespace | Port |
|---|---|---|
| ntfy-bridge | ntfy-bridge | 8080 |
| Immich Postgres | immich | 5432 |
| Immich Redis | immich | 6379 |
| Immich Machine Learning | immich | 3003 |
| Nextcloud Postgres | nextcloud | 5432 |
| Nextcloud Redis | nextcloud | 6379 |
| Zammad Postgres | zammad | 5432 |
| Zammad Redis | zammad | 6379 |
| Zammad Memcached | zammad | 11211 |
| Zammad Websocket | zammad | 6042 |
| Wiki.js Postgres | wikijs | 5432 |
| Garage S3-API | garage | 3900 |
| Sealed Secrets Controller | sealed-secrets | 8080 |
| VictoriaMetrics (vmsingle/vmagent/vmalert/vmalertmanager) | monitoring | 8428/8429/8080/9093 |
| Xibo CMS MySQL | xibosignage | 3306 |
| Xibo CMS XMR (Message-Relay) | xibosignage | 9505 |
| Xibo CMS Memcached | xibosignage | 11211 |
| Xibo CMS QuickChart | xibosignage | 3400 |
Reine Batch-Jobs ohne Service/Port: github-release-watcher (CronJob, TECH,
alle 2h) und wiki-docs-sync (CronJob, PROD, alle 15min) — laufen komplett
outbound, haben keinen offenen Port.
cloudflared selbst hat ebenfalls keinen offenen Port — reiner
Tunnel-Client, baut die Verbindung ausschließlich nach außen auf.
Wo ändere ich was, falls umgeroutet werden muss?
| Ich will ändern... | Datei |
|---|---|
LAN-Hostname (*.tier.homeserver) einer App |
argocd/apps/<tech\|prod>/<app>/values.yaml → ingress.hosts[].host |
Externe Erreichbarkeit (*-tier.pke-lab.de) für eine App hinzufügen/entfernen |
argocd/apps/<tech\|prod>/<app>/values.yaml → zusätzlichen (bzw. entfernten) Eintrag in ingress.hosts — nicht mehr in cloudflared/values.yaml, die Wildcard-Regeln dort decken bereits jedes Tier ab |
| Neuen Tunnel-Host eines PROD-Dienstes freigeben | DNS-Eintrag auf den PROD-Tunnel: cloudflared tunnel route dns homeserver-prod <host> (siehe e0010) |
| Internen Service-Port einer App | argocd/apps/<tech\|prod>/<app>/values.yaml → service.port/targetPort (Chart-abhängig) |
| NodePort (Pi-hole DNS, MediaMTX Publish) | argocd/apps/<tech\|prod>/<app>/values.yaml → service.nodePort/publishService.ports.*.nodePort — danach ggf. UFW-Regel auf neuen Port anpassen |
| ArgoCD-Zugriffsport | ArgoCD-Bootstrap (capulus-ansible/roles/argocd/) bzw. Helm-Values des ArgoCD-Charts selbst (nicht Teil der App-Wrapper-Charts) |
Nach jeder Änderung: committen + pushen, ArgoCD synct automatisch
(automated: {prune: true, selfHeal: true} ist für alle Apps aktiv).
Fehlersuche
ss -tlnp | grep -E ':(80|443|53|22|9101|9102)\b' # welche Ports lauschen auf dem Host
kubectl get svc -A | grep -E 'LoadBalancer|NodePort' # Cluster-Dienste mit Außenanbindung
curl -vk https://<app>.tech.homeserver/ -o /dev/null # Weg: Traefik
nc -vz <host> <port> # Port von einem anderen Gerät prüfen
| Symptom | Ursache | Lösung |
|---|---|---|
| Web-App nicht erreichbar, andere Apps gehen | Ingress oder Pod der App | Traefik-Konfiguration, kubectl -n <app> get pods,ingress |
| Alle Web-Apps nicht erreichbar | Traefik oder MetalLB-Adresse 192.168.178.200 |
MetalLB |
| Dienst mit eigenem Port (zum Beispiel MediaMTX, WoL-Agent, power-agent) nicht erreichbar | Firewall (UFW) oder Dienst läuft nicht | Abschnitt „Sonderfälle mit eigenen Ports“, Firewall-Rolle common |
| Interner Dienst ist von außen offen | NodePort oder Hostport ungewollt | Abschnitt „Interne Dienste ohne Ingress“, Network Policies |
| Dienst von außen (Internet) nicht erreichbar | Cloudflare Tunnel | Cloudflare Tunnel |
| Änderung am Routing wirkt nicht | falsche Stelle geändert | Abschnitt „Wo ändere ich was, falls umgeroutet werden muss?“ |
Allgemeine Fehlersuche: zentrale Fehlersuche.