如何将Visual Studio Code终端连接到Podman容器？

原因 #

VS Code的Docker扩展默认查找Docker的socket文件，而Podman使用独立的socket路径，需做兼容配置。

解决步骤 #

1. 配置Podman的Docker兼容Socket #

• 启用并启动Podman用户级socket服务：

  systemctl --user enable --now podman.socket
  

• 验证socket文件存在：

  ls -la $XDG_RUNTIME_DIR/podman/podman.sock
  

• 创建Docker兼容的软链接（让扩展能识别Podman的socket）：

  mkdir -p $HOME/.docker/run
  ln -s $XDG_RUNTIME_DIR/podman/podman.sock $HOME/.docker/run/docker.sock
  

• 或者设置永久环境变量（添加到~/.bashrc或~/.zshrc）：

  echo 'export DOCKER_HOST=unix://$XDG_RUNTIME_DIR/podman/podman.sock' >> ~/.bashrc
  source ~/.bashrc
  

2. 配置VS Code Docker扩展 #

• 打开VS Code，按Ctrl+,打开设置面板，搜索Docker: Host
• 将其值设置为：

  unix:///run/user/$(id -u)/podman/podman.sock
  

• 或者直接编辑settings.json（按Ctrl+Shift+P输入Open Settings (JSON)），添加：

  "docker.host": "unix:///run/user/$(id -u)/podman/podman.sock"
  

3. 验证连接 #

重启VS Code后，打开Docker扩展面板，即可看到已拉取的python:slim镜像和运行中的容器，右键容器选择Attach Shell即可连接终端。

内容的提问来源于stack exchange，提问作者Péter Szilvási