Docker Windows配置国内镜像源过程

 更新时间:2026年04月08日 09:28:19   作者:大大小小聪明  
本文介绍了在Windows下配置Docker使用国内镜像源的方法,包括通过Docker Desktop图形界面和直接修改配置文件两种方式,配置完成后可提升镜像下载速度,解决网络限制问题,同时提供了常见问题解决和最佳实践建议

在 Windows 下配置 Docker 使用国内镜像源可显著提升镜像下载速度,解决因网络限制导致的拉取缓慢或失败问题。

以下是两种常用配置方法(任选其一即可):

方法一:通过 Docker Desktop 图形界面配置

步骤:

打开设置

  • 右键点击任务栏 Docker 图标 → 选择 “Settings”

修改 Docker Engine 配置

  • 左侧菜单选择 “Docker Engine”
  • 在右侧 JSON 配置区添加或修改 registry-mirrors 字段,填入国内镜像源地址(示例如下):
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",    // 腾讯云
    "https://registry.docker-cn.com",       // Docker 中国官方
    "http://hub-mirror.c.163.com",          // 网易云
    "https://docker.mirrors.ustc.edu.cn"    // 中科大
  ]
}

提示

  • 推荐同时配置多个镜像源作为备份。
  • 若使用阿里云,需先申请专属加速地址(替换为 https://<你的ID>.mirror.aliyuncs.com)。

保存并重启

  • 点击 “Apply & Restart” 使配置生效。

方法二:直接修改配置文件daemon.json

步骤:

定位配置文件

  • 打开文件资源管理器,访问路径:
  • C:\Users\<你的用户名>\.docker\daemon.json
  • (若文件不存在,请手动创建)。

编辑文件内容

  • 添加以下配置(可自定义镜像源组合):
{
  "registry-mirrors": [
    "https://mirror.ccs.tencentyun.com",
    "https://registry.docker-cn.com",
    "http://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}

重启 Docker 服务

  • 任务栏右键 Docker 图标 → “Quit Docker Desktop”
  • 重新启动 Docker Desktop。

验证配置是否生效

执行以下命令检查镜像源状态:

docker info

在输出中查找 “Registry Mirrors” 部分,若显示已配置的镜像源地址,即表示成功。

速度测试

docker pull nginx:latest  # 观察下载速度是否提升

常见问题解决

配置后无法拉取镜像

  • 检查 JSON 格式是否正确(无多余逗号,引号为英文符号)。
  • 尝试更换其他镜像源(部分源可能临时不可用)。
  • 清理缓存:docker system prune -a

重启 Docker Desktop 失败

  • 删除 daemon.json 文件后重新配置。
  • 重启操作系统或重装 Docker Desktop。

最佳实践建议

  • 多镜像源备份:同时配置 3~4 个镜像源(如腾讯云、中科大、网易云),避免单点故障。
  • 定期测试速度:用 time docker pull nginx 对比不同源,保留最快选项。
  • 阿里云加速器:企业用户建议申请专属阿里云地址,稳定性更高。

通过上述配置,镜像下载速度通常可提升 3~5 倍。若需更详细的镜像源列表或故障排查,可参考 Docker 官方文档 或国内云服务商指南。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 将Docker数据迁移到新磁盘的操作指南

    将Docker数据迁移到新磁盘的操作指南

    在容器化应用的部署中,Docker 通常将数据存储在默认的 /var/lib/docker 目录,然而,随着容器数量的增加和镜像的累积,该目录可能会迅速占满系统磁盘空间,从而影响系统的正常运行,所以本文给大家介绍了如何将Docker数据迁移到新磁盘的操作指南,需要的朋友可以参考下
    2025-04-04
  • docker中如何启动已存在容器

    docker中如何启动已存在容器

    这篇文章主要介绍了docker中如何启动已存在容器问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-05-05
  • Docker中部署flink集群的两种方式

    Docker中部署flink集群的两种方式

    这篇文章主要介绍了Docker中部署flink集群的两种方式,本文将通过 2 种方式在 docker 中部署 flink standalone 集群,集群中共有 4 个节点,分别是 1 个 jobManager 节点和 3 个 taskManager 节点,需要的朋友可以参考下
    2024-02-02
  • 使用docker -v 和 Publish over SSH插件实现war包自动部署到docker的操作步骤

    使用docker -v 和 Publish over SSH插件实现war包自动部署到docker的操作步骤

    这篇文章主要介绍了利用docker -v 和 Publish over SSH插件实现war包自动部署到docker的操作步骤,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2018-01-01
  • Docker容器的使用方法简单示例

    Docker容器的使用方法简单示例

    这篇文章主要介绍了Docker容器的使用方法简单示例,包括拉取镜像、运行镜像、测试容器内的应用、检查主机端口及停止容器的操作方法,本文给大家介绍的非常详细,需要的朋友可以参考下
    2021-07-07
  • Docker 部署Datart BI工具完整指南(PostgreSQL 持久化存储)

    Docker 部署Datart BI工具完整指南(PostgreSQL 持久化存储)

    本文档详细介绍如何使用Docker部署Datart数据可视化平台,并使用PostgreSQL作为元数据库实现数据持久化存储,本文给大家介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
    2026-03-03
  • 使用Docker部署MySQL的实现步骤

    使用Docker部署MySQL的实现步骤

    本文主要介绍了Docker部署MySQL的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • docker 部署 时序数据库TDengine的思路详解

    docker 部署 时序数据库TDengine的思路详解

    TDengineGUI是一个基于electron构建的,针对时序数据库TDengine的图形化管理工具,这篇文章主要介绍了docker 部署 时序数据库TDengine的思路详解,需要的朋友可以参考下
    2025-04-04
  • docker mysql5.7如何设置不区分大小写

    docker mysql5.7如何设置不区分大小写

    本文主要介绍了docker mysql5.7如何设置不区分大小写,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-07-07
  • docker网络,docker-compose network问题

    docker网络,docker-compose network问题

    这篇文章主要介绍了docker网络,docker-compose network问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-01-01

最新评论