CentOS 7 Docker 连接 Docker Hub 失败解决方案

 更新时间:2026年04月24日 08:57:43   作者:实习生001  
本文记录CentOS7系统中Docker无法连接Docker Hub的完整排查过程,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

摘要:本文记录 CentOS 7 系统中 Docker 无法连接 Docker Hub 的完整排查过程,最终通过配置 DaoCloud 镜像加速器解决问题。

一、问题现象

在 CentOS 7 系统上使用 Docker 搜索镜像时,出现连接被拒绝错误:

[root@localhost ~]# docker search nginx
Error response from daemon: Get "https://index.docker.io/v1/search?q=nginx&n=25": 
dial tcp 157.240.9.36:443: connect: connection refused

二、环境信息

  • 操作系统:CentOS 7 (64位)
  • Docker 版本:(请读者自行查看 docker --version)
  • 网络环境:中国境内

三、排查过程

3.1 基础网络诊断

首先验证网络连通性:

# 测试外网连通性 - 正常
[root@localhost ~]# curl -I https://www.baidu.com
HTTP/1.1 200 OK

# 测试 Docker Hub 连接 - 失败
[root@localhost ~]# curl -4 -I https://index.docker.io/v1/
curl: (7) Failed connect to index.docker.io:443; 拒绝连接
# DNS 解析正常
[root@localhost ~]# nslookup index.docker.io
Name:   index.docker.io
Address: 199.59.150.49

初步判断:DNS 解析正常,外网连接正常,但 Docker Hub 特定连接被拒绝。

3.2 检查防火墙

检查 firewalld 和 iptables 规则:

# firewalld 状态
[root@localhost ~]# systemctl status firewalld
● firewalld.service - firewalld - dynamic firewall daemon
   Active: active (running) ...
# 查看防火墙规则
[root@localhost ~]# firewall-cmd --list-all
public (active)
  services: dhcpv6-client ssh
  ports: 

结论:iptables 没有阻止 443 端口出站规则,防火墙不是根本原因。

3.3 配置镜像加速器(第一次尝试)

尝试配置常见的国内镜像源:

cat > /etc/docker/daemon.json << 'EOF'
{
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF
systemctl restart docker

验证配置:

[root@localhost ~]# docker info | grep -A 5 "Registry Mirrors"
 Registry Mirrors:
  https://hub-mirror.c.163.com/
  https://docker.mirrors.ustc.edu.cn/

结果:配置已生效,但 docker search nginx 仍然连接被拒绝。

网易云和中科大镜像源目前已停止服务或限制访问。

四、最终解决方案

4.1 使用 DaoCloud 镜像加速器

更换为 DaoCloud 镜像:

cat > /etc/docker/daemon.json << 'EOF'
{
  "registry-mirrors": ["https://docker.m.daocloud.io"]
}
EOF
systemctl restart docker

4.2 验证结果

[root@localhost ~]# docker search nginx
NAME                                     DESCRIPTION                                      STARS     OFFICIAL
nginx                                    Official build of Nginx.                         21186     [OK]
nginx/nginx-ingress                      NGINX and  NGINX Plus Ingress Controllers fo…   114       
nginx/nginx-prometheus-exporter          NGINX Prometheus Exporter for NGINX and NGIN…   50        
nginx/unit                               This repository is retired, use the Docker o…   66        
nginx/nginx-ingress-operator             NGINX Ingress Operator for NGINX and NGINX P…   3         
nginx/nginx-quic-qns                     NGINX QUIC interop                               1         
nginx/nginxaas-loadbalancer-kubernetes                                                    1         
nginx/unit-preview                       Unit preview features                            0         
bitnami/nginx                            Bitnami Secure Image for nginx                   202       
bitnamicharts/nginx                      Bitnami Helm chart for NGINX Open Source         3         
ubuntu/nginx                             Nginx, a high-performance reverse proxy & we…   138       
kasmweb/nginx                            An Nginx image based off nginx:alpine and in…   8         
rancher/nginx                                                                             3         
linuxserver/nginx                        An Nginx container, brought to you by LinuxS…   236       
dtagdevsec/nginx                         T-Pot Nginx                                      0  

成功! Docker 可以正常搜索和拉取镜像了。

五、总结

排查步骤结果
网络连通性✅ 正常
DNS 解析✅ 正常
防火墙✅ 未阻止
网易云/中科大镜像❌ 已失效
DaoCloud 镜像✅ 可用

最终配置

文件 /etc/docker/daemon.json:

{
  "registry-mirrors": ["https://docker.m.daocloud.io"]
}

常用镜像源汇总(截至 2025-2026)

镜像源地址状态
DaoCloudhttps://docker.m.daocloud.io✅ 可用
阿里云https://<your-id>.mirror.aliyuncs.com✅ 需注册
网易云https://hub-mirror.c.163.com❌ 失效
中科大https://docker.mirrors.ustc.edu.cn❌ 失效

六、后续使用

# 拉取镜像
docker pull nginx
# 运行容器
docker run -d -p 80:80 --name my-nginx nginx
# 查看运行状态
docker ps

提示:如果 DaoCloud 镜像后续也失效,建议登录 阿里云容器镜像服务 获取个人专属加速地址,稳定性更高。

到此这篇关于CentOS 7 Docker 连接 Docker Hub 失败解决方案的文章就介绍到这了,更多相关Docker Hub 连接失败内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Linux服务器安装Docker,启动失败问题的解决

    Linux服务器安装Docker,启动失败问题的解决

    这篇文章主要介绍了Linux服务器安装Docker,启动失败问题的解决方案,具有很好的参考价值,希望对大家有所帮助。
    2023-04-04
  • Docker 40个实用的自动化管理脚本

    Docker 40个实用的自动化管理脚本

    如果你最近在学习或者使用现代软件开发技术,Docker和Kubernetes这两个词一定频频出现在你的视线中,这篇文章主要介绍了Docker 40个实用的自动化管理脚本的相关资料,需要的朋友可以参考下
    2025-12-12
  • 使用dockerfile打包centos实践

    使用dockerfile打包centos实践

    文章介绍了Docker操作CentOS镜像的常用命令,包括拉取、运行容器(交互/后台模式)、安装软件、复制文件、编写Dockerfile构建镜像及使用commit保存容器为新镜像的流程
    2025-10-10
  • DockerHub 镜像仓库的使用详解

    DockerHub 镜像仓库的使用详解

    这篇文章主要介绍了DockerHub 镜像仓库的使用详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-09-09
  • docker 拉取镜像失败 read: connection reset by peer

    docker 拉取镜像失败 read: connection reset&nbs

    本文主要介绍了docker 拉取镜像失败 read: connection reset by peer,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-12-12
  • Docker ps命令详解

    Docker ps命令详解

    Docker ps是用于查看Docker服务器中容器状态(运行/暂停/停止),及批量获取容器基本信息最常用的指令,ps命令具有很多可用的参数,本文给大家介绍Docker ps命令,感兴趣的朋友一起看看吧
    2023-11-11
  • Docker镜像压缩与优化操作

    Docker镜像压缩与优化操作

    这篇文章主要介绍了Docker镜像压缩与优化操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-11-11
  • 如何删除docker-register镜像及none无效镜像详解

    如何删除docker-register镜像及none无效镜像详解

    这篇文章主要给大家介绍了关于如何删除docker-register镜像及none无效镜像的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2017-09-09
  • Docker搭建Harbor公开仓库的方法示例

    Docker搭建Harbor公开仓库的方法示例

    这篇文章主要介绍了Docker搭建Harbor公开仓库的方法示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-06-06
  • docker容器环境安装及镜像基础操作

    docker容器环境安装及镜像基础操作

    容器是一种轻量级虚拟化技术,能够快速构建业务环境并便于业务迁移,解决兼容性问题,这篇文章主要介绍了docker容器环境安装及镜像基础操作,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-09-09

最新评论