---
title: Docker Hub 连接失败排障
type: experience
permalink: main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/docker-hub-连接失败排障
stable_id: 61e30ee3-0e26-4d64-b00e-f77bc3a3fd60
scope: project
project_id: 6f47523e-e22e-4cdd-bd18-76e5e474ee0c
memory_type: experience
status: active
revision: 1
restored_from_commit: 6a6a895eafcca6052e81a14fca103a42635dd1c2
created_at: '2026-09-23T14:58:36.607100+00:00'
updated_at: '2026-09-23T14:58:36.607150+00:00'
tags:
- docker
- proxy
- troubleshooting
---

## 问题

docker build 拉取 ubuntu:24.04 时报错：failed to fetch oauth token，dial tcp auth.docker.io:443 超时或连接重置。

## 原因

- Docker Desktop 代理模式为 System，手动配置的代理地址不生效。
- OPENWRT_BUILD_PROXY 只传给 docker run，不影响 docker build 拉取基础镜像。
- registry-mirrors 配置的第三方加速地址不可用时也会导致失败。

## 解决方案

1. Docker Desktop → Settings → Resources → Proxies → 选择 Manual proxy configuration
2. HTTP 和 HTTPS Proxy 都填 http://127.0.0.1:7897
3. Apply & Restart
4. 先验证 docker pull ubuntu:24.04 成功
5. 然后重新构建

## 注意事项

- settings-store.json 中 ProxyHTTPMode 必须为 manual 才能使用 OverrideProxyHTTP
- 如果保持 System 模式，必须在代理软件中开启“设置为系统代理”
- 容器内下载需另外设置 OPENWRT_BUILD_PROXY（回环地址会被转换为 host.docker.internal）