Windows 10 Home下Docker切换至Windows容器时启动挂起求助

问题背景 #

Windows 10 Home系统，通过第三方方法安装启用Hyper-V，Docker在Linux容器模式下正常运行，但切换到Windows容器后，Docker Desktop重启后无限卡在“Docker Desktop is starting...”状态。诊断工具检测到三个核心问题：

1. VM网络连通性测试失败：无法ping通主机，退出状态1
   提示：VM存在网络连接问题，请检查主机防火墙和杀毒软件是否拦截VM
2. Docker网络与主机IP重叠：bridge子网172.17.0.0/16与主机IP172.17.176.1冲突
   提示：子网重叠会导致容器无法访问对应IP地址，需配置自定义网络IP范围
3. 后端进程未运行：vpnkit.exe未启动

分步解决方案 #

1. 修复VM网络连接问题 #

• 打开Windows Defender防火墙高级设置，确保所有Hyper-V相关的入站、出站规则均已启用；若安装了第三方杀毒软件，暂时关闭后测试是否恢复
• 检查Hyper-V虚拟交换机：打开Hyper-V管理器，找到Docker关联的虚拟交换机（通常命名为DockerNAT），右键选择「属性」，确认连接类型为「外部网络」并绑定正确的物理网卡，同时勾选「允许管理操作系统共享此网络适配器」
• 重置Docker网络：以管理员权限打开PowerShell，执行以下命令后重启Docker Desktop：

  docker network prune
  docker system prune -f
  

2. 解决子网IP重叠问题 #

• 通过Docker Desktop设置修改默认子网：进入「设置」→「资源」→「网络」，将bridge子网修改为与主机IP不重叠的范围，比如192.168.0.0/16
• 若使用docker-compose，在配置文件中指定自定义子网：

  version: '3'
  networks:
    default:
      ipam:
        config:
          - subnet: 192.168.50.0/24
  

• 修改完成后重启Docker Desktop，验证子网冲突是否解决

3. 修复vpnkit.exe未运行问题 #

• 打开任务管理器「详细信息」标签，确认vpnkit.exe是否未运行
• 手动启动进程：找到Docker安装目录（默认路径为C:\Program Files\Docker\Docker\resources\vpnkit.exe），双击运行该程序；或在PowerShell中执行：

  Start-Process "C:\Program Files\Docker\Docker\resources\vpnkit.exe"
  

• 若启动失败，建议彻底卸载Docker Desktop（删除残留配置文件）后重新安装

额外适配建议（针对Win10 Home第三方Hyper-V） #

由于是通过非官方方法启用Hyper-V，可能存在兼容性问题，可尝试：

• 检查Hyper-V服务状态：在PowerShell中执行Get-Service *hyper-v*，确保所有Hyper-V相关服务状态为Running
• 重置Hyper-V服务：以管理员权限打开CMD，执行以下命令后重启电脑：

  net stop vmms
  net start vmms
  

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