Windows 上 Docker 报 /var/run/docker.sock 权限拒绝怎么办？
/var/run/docker.sock 是 Linux 的 Unix socket，Windows 上不存在；Windows 容器需用命名管道 npipe 或 Docker Remote API；Docker Desktop 里跑 Linux 容器则用挂载 sock 的方式。分场景解决。
问题本质：/var/run/docker.sock 是 Linux 上 Docker 守护进程的 Unix socket。Windows 没有这个文件——Windows 容器用命名管道 \\.\pipe\docker_engine 通信。报错说明你把 Linux 的访问方式用到了 Windows 环境，按实际容器类型换机制即可。
先分清你在哪种容器里
| 场景 | Docker API 访问方式 |
|---|---|
| Linux 容器（Docker Desktop 的 Linux 模式） | 挂载 /var/run/docker.sock 可用 |
| Windows 容器 | 命名管道 \\.\pipe\docker_engine |
| 远程 Docker 主机 | TCP + TLS（Docker Remote API） |
场景一：Docker Desktop 的 Linux 容器
Linux 容器里访问 sock 本身是支持的，报权限错通常是挂载写法问题。Windows 终端里挂载要写完整路径映射：
docker run -v /var/run/docker.sock:/var/run/docker.sock -it myimg
如果用了 WSL2 后端，在 WSL 发行版内执行同样命令即可。
场景二：Windows 容器
Windows 容器内无法使用 Unix socket，挂载命名管道代替：
docker run -v \\.\pipe\docker_engine:\\.\pipe\docker_engine -it myimg
容器内通过 Docker CLI 或 Remote API 操作宿主机 Docker。
场景三：用 Remote API 跨平台访问
在宿主机开启 Docker 的 TCP 监听（2376，务必配 TLS 证书），任何系统的容器都能通过 HTTPS 调用：
docker -H tcp://docker-host:2376 --tlsverify ps
观测云对照
采集端少碰 docker.sock 更省心。 很多容器监控方案要求挂载 docker.sock，权限配置麻烦且有安全面。DataKit 在 K8s/容器环境按标准方式部署，默认配置即可采集容器指标与日志，Windows 主机也有对应的部署方式。
常见问题（FAQ）
Q：挂载 docker.sock 给容器安全吗？
A：要谨慎。拿到 sock 等于拿到宿主机 Docker 的 root 级控制权，只给可信容器，并考虑只读代理方案。
Q：Docker Desktop 切 Windows 容器模式在哪？
A：托盘图标右键 → "Switch to Windows containers"，两种模式镜像与数据不共享。
Q：CI 流水线里报这个错？
A：CI agent 若是 Windows 节点而脚本按 Linux 写的挂载，统一改 Remote API 或换 Linux agent。
