kubectl port-forward¶
Leitet einen lokalen Port an einen Pod oder Service im Cluster weiter, ohne ihn öffentlich zu machen.

Syntax¶
kubectl port-forward TYP/NAME [LOKAL:]ZIEL [-n NAMESPACE]
Optionen¶
| Option | Beschreibung |
|---|---|
svc/NAME, deploy/NAME, POD |
Ziel im Cluster |
8080:80 |
Lokaler Port 8080 auf Port 80 des Ziels |
:80 |
Einen freien lokalen Port automatisch wählen |
--address 0.0.0.0 |
Auch Verbindungen von anderen Rechnern annehmen (Standard: nur localhost) |
-n NAMESPACE |
Namespace |
Beispiele¶
Einen Service lokal erreichbar machen:
kubectl port-forward -n status svc/web 8080:80
Forwarding from 127.0.0.1:8080 -> 80
Forwarding from [::1]:8080 -> 80
Handling connection for 8080
Die Weiterleitung läuft, bis du sie mit Ctrl+C beendest. Solange erreicht curl http://localhost:8080 nginx im Cluster.
Aus einem zweiten Terminal testen:
curl -s http://localhost:8080 | grep title
<title>Welcome to nginx!</title>
Ein automatisch gewählter lokaler Port:
kubectl port-forward -n status deploy/web :80
Forwarding from 127.0.0.1:38615 -> 80
Forwarding from [::1]:38615 -> 80
Wann brauche ich das?¶
- Um eine Anwendung zu testen, bevor sie einen Ingress bekommt
- Um eine Datenbank oder eine Admin-Oberfläche im Cluster zu erreichen, ohne sie freizugeben
- Um bei der Fehlersuche einen Pod direkt mit anderen zu vergleichen
Über einen SSH-Tunnel
Vom eigenen Rechner aus: ssh -L 8080:localhost:8080 nox@tuxdex-srv, und auf dem
Server kubectl port-forward starten. Dann funktioniert http://localhost:8080 lokal.
Verwandte Befehle¶
kubectl exec · kubectl get · ssh · curl