首页 > 网站技巧 > 服务器 > 云和虚拟化 > docker > docker配置国内源

docker配置国内源全过程

2025-03-27 15:31:45 作者：qq_33192454

这篇文章主要介绍了docker配置国内源全过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

docker配置国内源

在国内使用 Docker 时，由于默认的官方镜像源在访问速度上可能较慢，因此我们可以配置国内的镜像源来加快 Docker 镜像的下载速度。

配置国内 Docker 镜像源的步骤

1. 修改 Docker 的配置文件

Docker 使用 /etc/docker/daemon.json 文件来配置守护进程。如果这个文件不存在，你可以创建它。

步骤：

打开或创建 /etc/docker/daemon.json 文件：

sudo nano /etc/docker/daemon.json

添加或修改如下内容，使用国内镜像源：

{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com",
    "https://docker.mirrors.ustc.edu.cn",
    "https://registry.docker-cn.com"
  ]
}

以上是几大常见的国内 Docker 镜像源，分别是网易云、百度云、USTC（中国科学技术大学）和官方中国区镜像。

保存并退出文件编辑器。

2. 重启 Docker 服务：

配置完成后，重启 Docker 服务使配置生效：

sudo systemctl daemon-reload sudo systemctl restart docker

3. 验证镜像源配置：

可以通过以下命令来验证配置是否成功：

docker info

在输出信息中，应该能看到 Registry Mirrors 一项列出了你配置的镜像源。

常见国内镜像源地址

网易云: https://hub-mirror.c.163.com
百度云: https://mirror.baidubce.com
中国科技大学: https://docker.mirrors.ustc.edu.cn
阿里云: 可以通过阿里云容器镜像服务申请。

这样配置之后，你的 Docker 下载速度将会大大提高。如果有问题，欢迎进一步讨论。

Error response from daemon: Get "https://registry-1.docker.io/v2/": context deadline exceeded (Client.Timeout exceeded while awaiting headers) 配置完成后是这个效果

这个错误提示表明在配置完国内源后，Docker 仍然尝试连接到默认的 Docker Hub（https://registry-1.docker.io），并且超时了。可能的原因是配置文件未生效或者 Docker 并未完全按照国内镜像源进行请求。

尝试以下步骤进行排查和修复

1. 确保配置文件格式正确：

请再次确认 /etc/docker/daemon.json 文件的内容是否正确。确保 JSON 结构没有错误，例如多余的逗号或缺少的引号。示例内容如下：

{ "registry-mirrors": [ "https://hub-mirror.c.163.com", "https://mirror.baidubce.com", "https://docker.mirrors.ustc.edu.cn" ] }

2. 重启 Docker 守护进程：

修改完 daemon.json 后，请确保执行了正确的 Docker 重启命令：

sudo systemctl daemon-reload sudo systemctl restart docker

可以通过 docker info 再次确认是否成功加载了国内镜像源，看看 Registry Mirrors 是否显示了你配置的国内源。

3. 检查 Docker 代理配置：

如果你处于一个需要代理访问外网的环境，Docker 可能会因为代理设置不正确而无法访问镜像。请检查 Docker 的代理设置。

设置 Docker 使用系统代理：

在 /etc/systemd/system/docker.service.d/ 目录下创建 http-proxy.conf 文件（如果没有这个目录，先创建它）：

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf

添加代理配置（根据你的代理信息修改）：

[Service] Environment="HTTP_PROXY=http://your-proxy-server:port/" Environment="HTTPS_PROXY=https://your-proxy-server:port/"

保存后，重新加载并重启 Docker：

sudo systemctl daemon-reload sudo systemctl restart docker

4. 检查网络连接：

确认你的网络能够正常访问国内源，使用 curl 命令测试某个国内源的可访问性，例如：

curl -v https://hub-mirror.c.163.com

如果能获取到响应，说明网络连接没有问题。如果网络连接有问题，可能需要排查网络或 DNS 设置。

5. 清除 Docker 缓存

有时 Docker 会缓存错误的请求结果，可以尝试清除缓存：

sudo systemctl stop docker sudo rm -rf /var/lib/docker sudo systemctl start docker

这将清除 Docker 的所有缓存文件，然后重新启动 Docker，尝试拉取镜像。

如果问题依然存在，请告诉我你所处的具体网络环境（如是否有代理、网络限制等），我可以进一步帮助你排查。

Error response from daemon: Get "https://registry-1.docker.io/v2/": dial tcp 47.88.58.234:443: connect: connection refused 还是报错

从报错信息来看，Docker 仍然尝试访问 Docker Hub（registry-1.docker.io），并且连接被拒绝。可能的原因包括网络环境问题或 Docker 配置未正确生效。

更详细的排查步骤

1. 验证镜像源是否生效

首先，确认是否成功应用了国内镜像源配置。执行以下命令查看镜像源信息：

docker info

你应该在输出的 Registry Mirrors 部分看到你配置的国内镜像源。如果没有显示，说明配置没有生效，需要检查 /etc/docker/daemon.json 文件的配置内容。

2. 手动拉取镜像测试国内源

你可以尝试手动拉取镜像，并明确指定使用某个国内镜像源来进行测试：

docker pull --registry-mirror=https://hub-mirror.c.163.com/library/hello-world

如果可以成功拉取，说明国内源配置生效了。

3. 检查网络问题

从报错来看，Docker 客户端无法连接到 Docker Hub 服务器（IP：47.88.58.234）。这可能是由于网络环境问题导致无法访问 Docker Hub 或国内镜像源。

网络访问问题：你可以使用 ping 或 curl 测试 Docker Hub 和国内镜像源是否可以被访问。

测试 Docker Hub：

ping registry-1.docker.io

测试国内镜像源（例如网易）：

curl -v https://hub-mirror.c.163.com

如果你无法连接到这些地址，可能是网络被限制，或者需要通过代理访问。

DNS 问题：有时 DNS 配置不正确会导致无法解析 Docker 的服务器地址。你可以尝试更改 DNS 服务器，比如使用 Google 的 DNS (8.8.8.8) 或阿里云的 DNS (223.5.5.5)，步骤如下：

修改 /etc/resolv.conf 文件，添加或修改 DNS 服务器地址：

sudo nano /etc/resolv.conf

添加或修改为：

nameserver 8.8.8.8 nameserver 223.5.5.5

保存文件后重试 docker pull。

4. 检查防火墙设置

防火墙或安全组规则可能会阻止 Docker 连接到外部服务器。检查你的机器是否启用了防火墙，特别是对于端口 443（HTTPS）是否允许出站访问。

检查防火墙状态：

sudo ufw status

开放端口 443（如果防火墙阻止了）：

sudo ufw allow 443/tcp sudo ufw reload

5. 使用 VPN 或代理

如果你在中国大陆，可能存在网络限制，导致无法正常访问 Docker Hub，即使配置了国内源，仍可能出现超时或拒绝连接问题。你可以尝试使用 VPN 或代理来进行连接。

如前面提到的，如果需要设置代理访问 Docker，可以参考以下步骤配置代理：

创建代理配置文件：

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf

添加代理设置：

[Service] Environment="HTTP_PROXY=http://your-proxy-server:port/" Environment="HTTPS_PROXY=https://your-proxy-server:port/"

重新加载并重启 Docker：

sudo systemctl daemon-reload sudo systemctl restart docker

如果经过以上步骤依然无法解决，建议进一步排查网络问题或提供更多详细信息（例如是否通过代理访问，网络环境等），以便我可以更准确地帮助你。

registry.cn-beijing.aliyuncs.com 如何根据这个配置docker 源加速器

通过配置阿里云的镜像加速器解决Docker镜像下载速度慢问题

具体步骤如下：

1. 获取阿里云加速器地址

阿里云提供了国内加速器，可以在阿里云控制台中找到专属的加速器地址。以下是默认的加速器地址：

https://registry.cn-beijing.aliyuncs.com

2. 配置 Docker Daemon 使用阿里云加速器

步骤：

编辑或创建 /etc/docker/daemon.json 文件：

使用以下命令编辑文件：

sudo nano /etc/docker/daemon.json

在 daemon.json 文件中添加阿里云加速器地址：

如果文件为空，添加如下内容：

{ "registry-mirrors": [ "https://registry.cn-beijing.aliyuncs.com" ] }

如果文件中已有其他配置，比如已有镜像源地址，可以将阿里云的加速器地址添加到列表中：

{ "registry-mirrors": [ "https://registry.cn-beijing.aliyuncs.com", "https://hub-mirror.c.163.com", "https://mirror.baidubce.com" ] }

保存并退出。

3. 重启 Docker 服务

配置完成后，重新加载并重启 Docker：

sudo systemctl daemon-reload sudo systemctl restart docker

4. 验证配置

通过以下命令查看 Docker 的配置信息，确认是否成功应用了加速器配置：

docker info

在输出的信息中，应该可以看到 Registry Mirrors 一项，显示 https://registry.cn-beijing.aliyuncs.com，说明阿里云的加速器配置成功。

5. 测试拉取镜像

你可以通过拉取一个常用的镜像来验证加速效果，例如：

docker pull hello-world

这个过程中，Docker 会通过阿里云的镜像源加速拉取镜像。如果成功，说明阿里云加速器配置已生效。

如果你在阿里云有自己的私有仓库，也可以通过这种方式加速私有仓库镜像的拉取。

总结

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

docker配置国内源全过程