一、基本信息

二、故障现象

1. 进入1Panel应用商店，安装任意容器应用（含YesPlayMusic、nginx、数据库等），全部提示镜像拉取失败、连接超时、下载中断。

2. 检测原有镜像源：docker.1panel.live、dockerproxy.com、mirror.baidubce.com、docker.nju.edu.cn出现网页解析失败、无法连通。

3. 仅 DaoCloud 镜像源可正常解析，其余公共免费加速源大面积失效。

4. 服务器直连官方Docker Hub网络延迟高、丢包严重，无有效加速通道，导致全局镜像无法下载。

三、故障原因分析

3.1 公共镜像源大面积失效

目前市面上免费公共镜像源存在限流、关停、域名解析失败问题，本次检测中多数常用源无法访问，仅保留DaoCloud可用加速通道。

3.2 Docker默认源为国外服务器

Docker原生默认拉取地址为Docker Hub海外服务器，国内无特殊网络环境下，访问延迟极高、握手超时，直接造成全部镜像下载失败。

3.3 1Panel原有镜像源配置杂乱

面板内镜像加速源列表冗余、包含大量失效源，Docker在自动切换源时反复重试无效节点，造成卡死、拉取失败。

3.4 无有效兜底加速源

原有配置未保留长期稳定商用免费源，一旦通用公共源崩掉，服务器没有备用下载通道，出现全局所有镜像拉取失败。

四、解决方案

本次故障为全局镜像源失效，无需单独处理某一个应用，只需重置Docker镜像加速源，保留可用稳定源，以下提供两种修改方式。

方法一：1Panel可视化面板修改（新手推荐）

1. 登录1Panel后台，左侧菜单栏点击 容器 → 配置。

2. 找到镜像加速设置，清空全部旧失效镜像源。

3. 仅保留当前可正常连通、解析成功的稳定源，填写如下：
        https://docker.m.daocloud.io

4. 点击确认，输入 立即重启，重启Docker服务。

5. 重启完成后，返回应用商店，任意镜像均可正常拉取下载。

方法二：服务器终端命令修改（适用于面板修改无效）

1. 连接服务器终端，编辑Docker配置文件：
        nano /etc/docker/daemon.json 

2. 清空原有内容，写入单一稳定可用镜像源，避免无效源干扰：
        {
  "registry-mirrors": [
    "https://docker.m.daocloud.io"
  ]
}

3. 保存退出：Ctrl+O 保存，Ctrl+X 退出编辑器。

4. 刷新配置并重启Docker：

  systemctl daemon-reload

systemctl restart docker

5. 重启完毕后，1Panel内所有镜像恢复正常拉取。

五、优化总结与注意事项

1. 不要一次性添加大量失效源：镜像源过多会导致Docker轮询重试，反而降低下载速度、引发超时。

2. 保留长期稳定源：优先留存DaoCloud这类大厂免费镜像源，避免使用小众个人公益源（极易关停、解析失败）。

3. 区分故障类型：单一应用拉取失败为镜像本身问题；所有镜像失败必为全局Docker源故障，无需重装应用，修改加速源即可。

4. 修改后必须重启Docker：镜像源配置不重启不会生效，切勿修改后直接测试下载。

5. 服务器网络受限情况下，禁止频繁切换镜像源，建议固定1-2个稳定源长期使用。