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

Docker Desktop WSL2发行版配置失败,Docker引擎无法启动求助

解决Docker Desktop WSL2发行版配置失败问题

先排查WSL2基础环境

  • 打开管理员权限的PowerShell,执行wsl --list --verbose,确认有WSL发行版且状态为Running。如果没有,先运行wsl --install安装WSL,完成后重启电脑。
  • 重置WSL网络:执行netsh winsock reset,重启后再尝试启动Docker。
  • 联系IT团队确认:公司防火墙可能限制了WSL的网络访问,需确保\\wsl$\相关路径被加入防火墙白名单,允许Windows与WSL之间的通信。

手动清理并重新配置Docker WSL发行版

  • 彻底卸载Docker Desktop,删除以下残留目录:C:\Program Files\Docker、%APPDATA%\Docker、%LOCALAPPDATA%\Docker,然后在PowerShell中执行wsl --unregister docker-desktop和wsl --unregister docker-desktop-data,清除旧的Docker发行版。
  • 重新安装Docker Desktop,安装时务必勾选“使用WSL2替代Hyper-V”选项,全程以管理员权限运行安装程序。
  • 安装完成后手动启动Docker的WSL发行版:执行wsl -d docker-desktop,若启动失败,根据具体报错信息针对性处理。

适配防火墙与代理设置

  • 在Docker Desktop的「资源->代理」中,勾选“手动配置代理”,填入公司代理地址。同时在WSL终端执行export HTTP_PROXY=http://代理地址:端口,测试代理是否可正常访问。
  • 确认公司防火墙未拦截WSL文件共享:\\wsl$\是WSL与Windows的文件共享路径,需IT团队开放相关通信规则,允许该路径的访问权限。

关于Docker Engine配置

当前配置无异常,启动成功后可按需调整:

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false
}

内容的提问来源于stack exchange,提问作者Felix Conrad

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.13 20:33:25