Windows Server 2019中Docker遇TLS handshake timeout问题求助

问题背景 #

在Windows Server 2019上通过以下步骤安装并配置Linux容器后，执行镜像拉取或Docker Hub登录操作时出现Error response from daemon:TLS handshake timeout错误：

安装Docker步骤 #

Install-Module -Name DockerMsftProvider -Repository PSGallery -Force
Install-Package -Name docker -ProviderName DockerMsftProvider
Start-Service Docker

配置Linux容器步骤 #

Uninstall-Package -Name docker -ProviderName DockerMSFTProvider
[Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "$null", "Machine")
Install-Module DockerProvider
Install-Package Docker -ProviderName DockerProvider -RequiredVersion preview
[Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
Restart-Service docker

排查与解决步骤 #

• 检查网络连通性

  1. 测试服务器能否正常访问Docker Hub：

     Invoke-WebRequest https://hub.docker.com
     

     如果请求失败，先排查服务器网络、DNS设置，确认能正常访问外网。
  2. 检查Windows防火墙规则，确保允许Docker相关的出站/入站流量（重点是443端口），可临时关闭防火墙测试是否为防火墙拦截导致。
  3. 若服务器处于代理环境，需在Docker配置中添加代理：
     创建或修改C:\ProgramData\docker\config\daemon.json，添加代理配置：

     {
       "proxies": {
         "default": {
           "httpProxy": "http://your-proxy:port",
           "httpsProxy": "http://your-proxy:port",
           "noProxy": "localhost,127.0.0.1"
         }
       }
     }
     

     保存后重启Docker服务：Restart-Service docker

• 调整Docker daemon超时参数
  创建或修改C:\ProgramData\docker\config\daemon.json，增加超时配置：

  {
    "timeout": 600
  }
  

  重启Docker服务后重试操作。

• 重置Docker网络

  1. 停止Docker服务：

     Stop-Service docker
     

  2. 清理无效网络资源：

     docker network prune -f
     

  3. 重启Docker服务，再次尝试拉取镜像或登录。

• 验证LCOW配置正确性

  1. 检查环境变量：

     Get-Item Env:LCOW_SUPPORTED
     

     确认返回值为1。
  2. 手动拉取LCOW基础镜像：

     docker pull mcr.microsoft.com/windows/lcow:1809
     

     （1809对应Windows Server 2019的版本号，若失败则说明LCOW镜像获取存在问题）

• 切换至Docker稳定版
  预览版可能存在兼容性问题，尝试安装稳定版：

  # 卸载当前预览版
  Uninstall-Package Docker -ProviderName DockerProvider
  Uninstall-Module DockerProvider -Force
  
  # 重新安装稳定版并配置LCOW
  Install-Module -Name DockerMsftProvider -Repository PSGallery -Force
  Install-Package -Name docker -ProviderName DockerMsftProvider -Force
  [Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
  Restart-Service docker
  

内容的提问来源于stack exchange，提问作者samira mehdi