Windows(WSL2)下如何在IntelliJ IDEA中关联Docker Compose与Podman？

根本原因 #

这个crun: create '/sys/fs/cgroup/docker/buildx': Permission denied错误，本质是WSL2的cgroup v2管理模式与Podman BuildKit容器的权限配置不匹配——IDEA调用Docker Compose构建镜像时，BuildKit容器无法访问WSL2中未正确授权的cgroup路径。

分步解决配置方案 #

1. 启用WSL2的systemd与cgroup v2支持

WSL2默认可能未启用systemd，而cgroup v2需要systemd来管理。

• 在WSL终端中编辑全局配置文件：

  sudo nano /etc/wsl.conf
  

• 添加以下内容并保存：

  [boot]
  systemd=true
  

• 在Windows终端执行命令重启WSL：

  wsl --shutdown
  

• 重新进入WSL，运行systemctl status验证systemd是否正常启动。

2. 配置Podman的BuildKit与cgroup管理

修改Podman的容器配置，让BuildKit使用systemd作为cgroup管理器：

• 在WSL用户目录下创建/编辑容器配置文件：

  nano ~/.config/containers/containers.conf
  

• 添加或修改以下配置项：

  [engine]
  cgroup_manager = "systemd"
  events_logger = "journald"
  
  [engine.buildkit]
  enabled = true
  

• 保存后重启Podman服务：

  systemctl --user restart podman
  

3. 修正IDEA的Docker关联配置

确保IDEA正确连接到WSL2中的Podman套接字，而非Windows本地的Docker服务：

• 打开IDEA的Settings → Build, Execution, Deployment → Docker
• 点击+添加Docker服务器，选择Unix socket，输入Podman的套接字路径：

  unix:///run/user/你的WSL用户UID/podman/podman.sock
  

  注：用id -u命令在WSL终端查看你的用户UID，通常是1000
• 切换到Docker Compose标签页，勾选Use Docker Compose V2，确保环境变量中没有强制禁用BuildKit的配置（除非临时调试）。

4. 验证配置有效性

• 在WSL终端运行以下命令，确认cgroup配置正确：

  podman info | grep -A2 Cgroup
  

  输出应显示Cgroup Manager: systemd和Cgroup Version: v2。
• 在IDEA中重新运行Docker Compose构建服务，检查权限错误是否消失。

额外注意事项 #

• 确保你的WSL2发行版是Ubuntu 22.04+、Debian 11+等支持systemd的版本，旧版本可能需要额外配置。
• 如果仍有权限问题，可临时在IDEA的Compose运行配置中添加环境变量DOCKER_BUILDKIT=0禁用BuildKit（不推荐长期使用，仅用于调试）。
• 确认Windows端的docker-compose.exe是通过Podman的兼容层运行的，执行docker-compose --version应显示包含podman的版本信息。

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