Docker构建时curl下载Git安装包失败，本地执行正常的排查求助

一、排查Docker构建环境的网络差异 #

• 检查Docker daemon代理设置：本地cmd/PowerShell用的是系统代理，但Docker daemon可能未同步配置。打开Docker设置，进入「Resources」→「Proxies」，确认是否开启「Use system proxy」，或手动配置与系统一致的代理地址。
• 测试容器内网络连通性：在Dockerfile中临时添加RUN curl -I https://github.com，执行构建后查看是否能正常获取响应头，判断容器到GitHub的网络链路是否通畅。
• 核对防火墙规则：本地机器防火墙可能限制了Docker容器的出站HTTPS流量（端口443）。对比成功构建的机器，检查本地防火墙是否允许dockerd.exe等Docker相关进程访问外部网络。

二、调整curl命令参数 #

• 增加超时与重试机制：给curl添加超时和重试参数，规避临时网络波动，修改后的命令如下：

  curl -SL --connect-timeout 30 --retry 5 --output git-install.exe https://github.com/git-for-windows/git/releases/download/v2.41.0.windows.3/Git-2.41.0.3-64-bit.exe
  

• 强制使用HTTP/1.1：部分环境下HTTP/2存在兼容性问题，添加--http1.1参数禁用HTTP/2：

  curl -SL --http1.1 --output git-install.exe https://github.com/git-for-windows/git/releases/download/v2.41.0.windows.3/Git-2.41.0.3-64-bit.exe
  

三、替换下载方式或源 #

• 改用PowerShell命令下载：Windows容器自带的curl可能存在版本或兼容性问题，替换为PowerShell的Invoke-WebRequest：

  RUN powershell -Command "Invoke-WebRequest -Uri 'https://github.com/git-for-windows/git/releases/download/v2.41.0.windows.3/Git-2.41.0.3-64-bit.exe' -OutFile 'git-install.exe'"
  

• 切换国内镜像源：若为跨境网络链路问题，替换为Git for Windows的国内镜像站对应版本下载URL。

四、检查基础镜像与Docker版本差异 #

• 核对基础镜像一致性：确认本地使用的基础镜像（如mcr.microsoft.com/windows/servercore:ltsc2022）与另外两台成功构建的机器完全一致，不同版本的基础镜像可能自带的curl版本或网络配置不同。
• 更新Docker环境：将本地Docker Desktop/Engine更新至最新稳定版，同时拉取最新的Windows Servercore基础镜像，修复旧版本可能存在的bug。

五、本地预下载后复制进容器 #

若以上方法均无效，可先在本地下载好Git安装包，通过COPY命令替代curl下载：

1. 将Git-2.41.0.3-64-bit.exe放入Dockerfile同目录
2. 修改Dockerfile内容：

   COPY Git-2.41.0.3-64-bit.exe git-install.exe
   RUN start /w git-install.exe /VERYSILENT /NORESTART /NOCANCEL /SP- /CLOSEAPPLICATIONS /RESTARTAPPLICATIONS /COMPONENTS="icons,ext\reg\shellhere,assoc,assoc_sh" && del /q git-install.exe
   

内容的提问来源于stack exchange，提问作者Bernoulli Lizard