当前位置：首页 > news >正文

Docker for Windows 设置国内镜像源教程

news 2025/7/3 8:35:22

在使用 Docker 时，由于默认的 Docker Hub 镜像源位于国外，国内用户在拉取镜像时可能会遇到速度慢或连接不稳定的问题。为了加速镜像拉取，可以将 Docker 配置为使用国内镜像源。以下是适用于 Windows 系统的详细配置方法：

如果你使用的是 Docker Desktop for Windows，可以通过以下步骤快速配置国内镜像源：

打开 Docker Desktop 设置
在任务栏右下角找到 Docker 图标，右键单击并选择 Settings（设置）。
进入 Docker Engine 设置
在设置界面中，选择 Docker Engine 选项卡。
添加国内镜像源地址
在 Docker Engine 配置区中，找到 registry-mirrors 一栏，添加以下国内镜像源地址（可根据需要选择多个）：
```
{"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn","https://registry.docker-cn.com","http://hub-mirror.c.163.com","https://mirror.ccs.tencentyun.com"]
}
```
这些镜像源都是国内知名的 Docker 镜像加速服务。
保存并重启 Docker
点击 Apply & Restart（应用并重启），Docker 服务将自动重启并应用新的配置。

如果你更倾向于手动配置，可以通过修改 Docker 的 daemon.json 文件来设置国内镜像源：

找到配置文件路径
通常情况下，daemon.json 文件位于用户目录下的 .docker 文件夹中，例如 C:\Users\<用户名>\.docker。
创建或修改 daemon.json 文件
如果文件不存在，请新建一个名为 daemon.json 的文件，并添加以下内容：
```
{"registry-mirrors": ["https://docker.mirrors.ustc.edu.cn","https://registry.docker-cn.com","http://hub-mirror.c.163.com","https://mirror.ccs.tencentyun.com"]
}
```
这里的镜像源地址可以根据需要进行替换。
重启 Docker 服务
保存 daemon.json 文件后，通过 Docker Desktop 的菜单栏选择 Restart（重启），或者使用命令行工具重启 Docker 服务。

完成上述配置后，可以通过以下命令拉取一个测试镜像来验证配置是否生效：

docker pull ubuntu

如果拉取速度显著提升且没有出现连接超时等问题，则说明国内镜像源配置成功。

以下是一些常用的国内 Docker 镜像源，你可以根据自己的需求选择合适的镜像源：

确保 Docker 服务正在运行
在修改配置文件或通过界面设置时，确保 Docker 服务已经启动。
检查网络连接
如果配置完成后仍然无法加速镜像拉取，请检查网络连接是否正常，或尝试更换其他镜像源。
使用命令行指定镜像源
如果需要临时使用某个镜像源拉取镜像，可以在命令中直接指定，例如：
```
docker pull ubuntu --registry-mirror=https://registry.docker-cn.com
```
这种方式不会修改全局配置。