首页/云/Docker 容器速查/x509 / TLS handshake 镜像拉取报错
容器排障52 条

x509 / TLS handshake 镜像拉取报错

拉镜像报证书或握手错误:企业镜像源证书链不受信、中间设备拦截 HTTPS、私有仓库自签证书域名不匹配;先验证证书再决定收敛方式。

Docker 容器速查云更新于 2026-10-12
诊断openssl s_client 看证书链与域名
内网可控daemon insecure-registries 仅限内网
对外修证书链,别降级

示例

示例
openssl s_client -connect registry.example.com:443 -servername registry.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
docker pull registry.example.com/ns/app:1.0
自签证书的规范做法是把 CA 放到 /etc/docker/certs.d/<registry>/ca.crt 后重启 docker。

易错点

  • insecure-registries 只是跳过校验,公网链路用它会引入可被替换的镜像风险
  • 公司 TLS 审计设备重签名证书时,装对审计 CA 比关校验更正确

数据来源与参考

  • Docker 官方文档:Verify repository client with certificates(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌