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

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#26,511 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@aevesdocker đang làm issue này rồi.

Từ ngày 2/11/2026.

  • #26515 của @aevesdocker — đang mở

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
75/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
docker, kubernetes
Lĩnh vực
documentation

Hướng nghiên cứu

Payload cung cấp toàn bộ mục FAQ cần thêm: triệu chứng, nguyên nhân (NO_PROXY thiếu kubernetes.docker.internal), các bước kiểm tra bằng PowerShell và cách khắc phục ở cấp người dùng. Hãy tìm trang FAQ chung của Docker Desktop trong repo, nơi liên kết Location trỏ tới, rồi thêm một mục theo đúng định dạng hiện có. Kiểm tra rằng tham chiếu nội bộ SEG-1860 không được chép vào nội dung công khai. Hoàn thành khi mục hiển thị đúng và các lệnh khớp với payload.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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
Ngôn ngữ chính
Markdown
Star
4.7k
Fork
8.5k
Merge trung bình
2 ngày 9 giờ
Pull request đã merge (30 ngày)
126

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của docker/docs

Tất cả issue của docker/docs

Issue tương tự

Thêm issue về Documentation

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.