You need to enable JavaScript to run this app. Manjaro系统下Docker拉取镜像出现x509证书不匹配报错
优惠活动
大模型
产品
解决方案
定价
更多

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
  • 关键误区说明:daemon.json 中配置的DNS参数,仅作用于Docker启动的业务容器网络,完全不影响Docker守护进程自身对外的域名解析逻辑,这也是此前修改该配置无效的核心原因
  • 修复操作:
    • 如果两组解析结果存在明显IP段偏差,直接编辑系统 /etc/hosts 文件,追加公共DNS返回的Docker官方registry IP映射,例如写入 146.75.116.32 registry-1.docker.io,保存后重新测试拉取操作

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 00:45:03