You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Mac环境下Docker构建失败,无法拉取Python镜像

Docker构建失败:无法解析registry-1.docker.io(Mac环境)

你的构建报错核心是Docker无法解析Docker Hub的域名registry-1.docker.io,虽然未修改代码,但网络配置或Docker缓存问题可能引发该情况,可尝试以下解决步骤:

报错信息

[internal] load metadata for docker.io/library/python:3.6.5:

failed to solve: rpc error: code = Unknown desc = failed to solve with frontend dockerfile.v0: failed to create LLB definition: failed to do request: Head "https://registry-1.docker.io/v2/library/python/manifests/3.6.5": dialing registry-1.docker.io:443 with direct connection: resolving host registry-1.docker.io: lookup registry-1.docker.io: no such host

解决步骤

  • 切换Docker DNS服务器
    打开Docker Desktop偏好设置,进入Resources -> Network,将DNS服务器改为8.8.8.8或1.1.1.1,应用设置后重启Docker。

  • 重置Docker网络配置
    在Docker Desktop菜单中选择Troubleshoot -> Reset to factory defaults,重置完成后重启Docker,再尝试构建。

  • 刷新Mac系统DNS缓存
    打开终端,依次执行以下命令:

    sudo dscacheutil -flushcache
    sudo killall -HUP mDNSResponder
    
  • 测试域名解析
    终端执行nslookup registry-1.docker.io,如果返回正常IP,说明解析问题已解决;如果仍失败,检查Mac系统Wi-Fi/以太网的DNS设置,手动添加公共DNS服务器。

  • 检查代理设置
    确认Docker Desktop的Preferences -> Proxies中未启用代理;同时检查Mac系统的代理设置,确保没有拦截Docker的网络请求。

内容的提问来源于stack exchange,提问作者M.N

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.26 22:07:06