如何将WSL中的Docker连接到IntelliJ？

核心逻辑 #

WSL2的文件系统和Windows系统存在固定路径映射，我们只需要找到docker.sock在Windows侧的对应路径，就能完成IntelliJ的配置。

具体配置步骤 #

1. 确认WSL发行版名称
   打开Windows命令提示符或PowerShell，执行：

   wsl -l -v
   

   找到你的Ubuntu20.04对应的发行版名称（一般是Ubuntu-20.04）。

2. 生成Windows侧的docker.sock路径
   WSL2根文件系统在Windows中的映射格式为：

   \\wsl$\<发行版名称>\var\run\docker.sock
   

   比如你的发行版是Ubuntu-20.04，对应的本地路径就是：

   \\wsl$\Ubuntu-20.04\var\run\docker.sock
   

3. IntelliJ配置操作

   • 打开IntelliJ的设置面板（File → Settings），定位到Build, Execution, Deployment → Docker
   • 点击添加按钮（+），选择"Docker for Windows"选项
   • 在配置窗口中：
     • 找到「Path mappings」区域，点击添加映射规则：
       • Local path：填入刚才生成的Windows侧路径，例如\\wsl$\Ubuntu-20.04\var\run\docker.sock
       • Virtual machine path：填入/var/run/docker.sock
   • 点击「Apply」和「OK」，测试连接即可完成配置。

额外优化提示 #

• 若每次执行sudo dockerd都需要输入密码，可修改sudoers配置实现免密启动：
  执行sudo visudo，添加一行规则（替换<你的用户名>为WSL内的实际用户名）：

  <你的用户名> ALL=(ALL) NOPASSWD: /usr/bin/dockerd
  

• 确保你的WSL版本是2（通过wsl -l -v查看版本列，显示2即可），WSL1不支持这种路径映射方式。

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