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

Fermée Adaptée aux débutants
  • Quelque chose ne va pas ?
#26,511 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@aevesdocker y travaille déjà.

Depuis le 2/11/2026.

  • #26515 par @aevesdocker — ouverte

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
75/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
docker, kubernetes
Domaine
documentation

Piste de recherche

Le payload fournit l'entrée complète de FAQ à ajouter : le symptôme, la cause (NO_PROXY ne contient pas kubernetes.docker.internal), les étapes de vérification sous PowerShell et la correction au niveau utilisateur. Trouve la page FAQ générale de Docker Desktop dans le dépôt, vers laquelle pointe le lien Location, et ajoute une section qui suit son format existant. Vérifie que la référence interne SEG-1860 n'est pas recopiée dans le texte public. C'est terminé lorsque la section s'affiche correctement et que ses commandes correspondent au payload.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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
Langage dominant
Markdown
Étoiles
4.7k
Forks
8.5k
Merge moyen
2 j 22 h
PR mergées (30 j)
159

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de docker/docs

Toutes les issues de docker/docs

Issues similaires

Plus d'issues Documentation

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.