Manjaro系统下Docker拉取镜像出现x509证书不匹配报错
Manjaro 环境下 Docker 拉取镜像触发 x509 域名不匹配错误排查指南
基础问题定位
- 运行场景:Manjaro 系统,对应内核版本
Linux 5.11.10-1-MANJARO - 触发操作:执行
docker pull hello-world拉取官方测试镜像 - 报错核心:Docker 守护进程访问
https://registry-1.docker.io/v2/时校验SSL证书失败,返回的证书仅匹配bitty-buddy.coxauto-dzcp1-user-control-plane.com域名,与请求目标域名不匹配 - 已验证无效操作:先后将
daemon.json内的DNS参数设置为["8.8.8.8", "8.8.4.4"]、["1.1.1.1", "1.0.0.1"],问题无任何改善
分层排查与修复步骤
1. 确认DNS劫持导致的解析偏移
证书与域名不匹配的最常见诱因,是目标域名被解析到了非Docker官方的服务器节点,自然返回对应节点的域名证书。
- 首先验证解析结果一致性:
- 执行命令获取公共DNS的官方解析值:
dig registry-1.docker.io @8.8.8.8 - 执行命令查看本地系统实际解析结果:
getent hosts registry-1.docker.io
- 执行命令获取公共DNS的官方解析值:
- 关键误区说明:
daemon.json中配置的DNS参数,仅作用于Docker启动的业务容器网络,完全不影响Docker守护进程自身对外的域名解析逻辑,这也是此前修改该配置无效的核心原因 - 修复操作:
- 如果两组解析结果存在明显IP段偏差,直接编辑系统
/etc/hosts文件,追加公共DNS返回的Docker官方registry IP映射,例如写入146.75.116.32 registry-1.docker.io,保存后重新测试拉取操作
- 如果两组解析结果存在明显IP段偏差,直接编辑系统
2. 排查代理配置异常拦截请求
- 检查系统shell层的代理配置:执行
env | grep -i proxy,如果存在非预期的代理地址,所有HTTPS请求会被转发至代理节点,触发证书替换 - 检查Docker守护进程自身的代理配置:执行
systemctl show docker | grep Environment,确认守护进程没有被注入和系统shell不一致的代理参数,这部分配置完全独立于shell环境变量 - 修复操作:
- 移除错误的代理配置;如果确需使用代理,需要确认代理服务未开启HTTPS证书重写功能,避免返回非目标域名的证书
3. 验证透明证书劫持场景
- 直接通过系统自带的curl工具发起请求:
curl -v https://registry-1.docker.io/v2/,查看返回的证书链主体 - 如果证书主体为报错提示的非Docker域名,说明本地网络出口存在透明HTTPS审计设备,这类设备会主动替换所有站点的SSL证书
- 修复操作:
- 将审计设备对应的根证书导入系统的信任证书存储,执行
update-ca-trust刷新系统信任列表 - 在Docker的证书信任目录
/etc/docker/certs.d/下同步配置该根证书,避免Docker守护进程单独触发证书校验失败
- 将审计设备对应的根证书导入系统的信任证书存储,执行
4. 清理异常的镜像源残留配置
- 打开
/etc/docker/daemon.json文件,检查是否存在指向非官方第三方源的registry-mirrors配置 - 如果第三方镜像源存在服务故障或配置错误,会返回自身域名对应的SSL证书,触发域名不匹配报错
- 修复操作:临时移除所有自定义镜像源配置,执行
systemctl restart docker重启守护进程后重新测试拉取
内容的提问来源于stack exchange,提问作者Andrea Góngora
相关产品推荐
相关产品推荐

