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

Chiusa Adatta ai principianti
  • Qualcosa non va?
#26,511 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@aevesdocker ci sta già lavorando.

Dal 2/11/2026.

  • #26515 di @aevesdocker — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
75/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
docker, kubernetes
Ambito
documentation

Direzione di ricerca

Il payload fornisce la voce completa della FAQ da aggiungere: il sintomo, la causa (NO_PROXY non include kubernetes.docker.internal), i passaggi di verifica in PowerShell e la correzione a livello utente. Trova nel repository la pagina FAQ generale di Docker Desktop, a cui punta il link Location, e aggiungi una sezione che segua il formato esistente. Verifica che il riferimento interno SEG-1860 non venga copiato nel testo pubblico. È completato quando la sezione viene visualizzata correttamente e i suoi comandi corrispondono al payload.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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
Lingua principale
Markdown
Stelle
4.7k
Fork
8.5k
Merge medio
2g 13h
PR unite (30g)
141

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di docker/docs

Tutte le issue di docker/docs

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.