FAQ: Docker Desktop Kubernetes stuck on "Starting" behind a corporate proxy

Geschlossen Anfängerfreundlich
  • Stimmt etwas nicht?
#26,511 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@aevesdocker arbeitet bereits daran.

Seit 02.11.2026.

  • #26515 von @aevesdocker — offen

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
75/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
docker, kubernetes
Bereich
documentation

Rechercherichtung

Der Nutzer liefert den vollständigen FAQ-Eintrag, der hinzugefügt werden soll: das Symptom, die Ursache (NO_PROXY enthält kubernetes.docker.internal nicht), die PowerShell-Schritte zur Überprüfung und die Korrektur auf Benutzerebene. Finde die allgemeine FAQ-Seite von Docker Desktop im Repo, auf die der Link Location verweist, und füge einen Abschnitt hinzu, der deren bestehendes Format übernimmt. Prüfe, dass die interne Referenz SEG-1860 nicht in den öffentlichen Text kopiert wird. Fertig, wenn der Abschnitt korrekt gerendert wird und seine Befehle mit dem Eintrag übereinstimmen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

status/triage
Is this a docs issue?
  • My issue is about the documentation content or website
Type of issue

Other

Description

Kubernetes stuck on "Starting" on a corporate laptop? A proxy is probably catching the local address kubernetes.docker.internal. Add it to NO_PROXY.

Symptom
• Docker Desktop shows Starting – waiting for node to be ready and never finishes.
• kubectl get nodes fails with Get "https://kubernetes.docker.internal:6443/...": Bad Gateway or "https://kubernetes.docker.internal:6443/...":Forbidden"
• The cluster itself is running (docker ps shows the control-plane containers up).

Cause
The laptop has HTTP_PROXY / HTTPS_PROXY set, and NO_PROXY doesn't list kubernetes.docker.internal. Docker's kubeconfig uses that name, so the request goes to the proxy, which answers 502 Bad Gateway. The IP 127.0.0.1 is never proxied, which is why it works directly.

Verify
In PowerShell (use curl.exe, not curl):

Get-ChildItem Env: | Where-Object Name -match 'proxy'
curl.exe -vk https://kubernetes.docker.internal:6443/version
curl.exe -vk --noproxy "*" https://kubernetes.docker.internal:6443/version

The plain curl.exe returns 502; with --noproxy "*" it returns 200 and the version JSON.

Fix
Set NO_PROXY at user level. This replaces the old value, so keep the existing entries. For example:

[Environment]::SetEnvironmentVariable('NO_PROXY','localhost,127.0.0.1,.example.com,kubernetes.docker.internal,.docker.internal','User')
Location

https://docs.docker.com/desktop/troubleshoot-and-support/faqs/general/

Suggestion

There are two different business customer experiencing that Kubernetes stuck on "Starting" behind a corporate proxy. A proxy is probably catching the local address kubernetes.docker.internal. Therefore, suggesting to document this publicly.

Internal reference

  1. Resolved in SEG-1860
  2. Same mechanism in a #desktop thread on: https://docker.slack.com/archives/C0W4XJVFW/p1737531452641359
Vorherrschende Sprache
Markdown
Sterne
4.7k
Forks
8.5k
Ø Merge
2 T. 13 Std.
Gemergte PRs (30 T.)
141

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus docker/docs

Alle Issues in docker/docs

Ähnliche Issues

Weitere Issues zu Documentation

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.