无根DinD环境下无法连接Docker daemon的解决方法求助

问题分析 #

你的配置存在几个关键问题：

• 直接用postCreateCommand后台启动dockerd-entrypoint.sh会绕过rootless DinD的初始化流程（比如UID映射、环境变量配置）
• 缺少rootless DinD运行必需的部分环境变量
• 在macOS的Docker Desktop环境下，特权模式容器需要额外配置才能正确运行rootless Daemon

修复步骤 #

1. 修改devcontainer.json配置 #

移除冗余的postCreateCommand，补充必要的运行参数：

{
    "name": "Docker",
    "dockerFile": "Dockerfile",
    "runArgs": [
        "--privileged",
        "--security-opt", "seccomp=unconfined",
        "--cap-add", "SYS_ADMIN"
    ],
    "remoteUser": "rootless"
}

• --security-opt seccomp=unconfined：解决rootless DinD在容器中运行时的系统调用限制
• --cap-add SYS_ADMIN：提供rootless Daemon所需的文件系统挂载权限
• 移除postCreateCommand：让docker:dind-rootless镜像的默认Entrypoint自动完成Daemon的初始化和启动流程

2. 调整Dockerfile补充环境变量 #

添加rootless DinD运行必需的环境变量，确保socket路径和运行时目录正确：

FROM docker:dind-rootless
USER root
RUN apk add git bash curl make vim go
USER rootless
# 确保运行时目录存在并配置正确权限
RUN mkdir -p /run/user/1000 && chown rootless:rootless /run/user/1000
ENV DOCKER_HOST=unix:///run/user/1000/docker.sock
ENV XDG_RUNTIME_DIR=/run/user/1000
# 禁用TLS认证，rootless模式默认使用unix socket
ENV DOCKER_TLS_CERTDIR=""

3. 验证修复效果 #

重新构建Dev Container后，执行以下命令确认Daemon状态：

docker info

如果仍无法连接，可手动检查Daemon日志排查问题：

cat /var/log/docker.log

跨平台兼容性说明 #

• macOS：该问题并非macOS特有，仅为配置缺失导致。Docker Desktop的HyperKit虚拟机环境完全支持rootless DinD，配置正确即可正常运行。
• WSL2：WSL2基于Linux内核，对rootless DinD的支持更原生。只需确保WSL2已启用Docker Desktop集成，或在WSL2内部安装了Docker环境，上述配置可直接复用，无需额外修改。

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