Mac环境下挂载Docker客户端与套接字后容器内无法运行Docker

你遇到的核心问题是Mac主机上的/usr/local/bin/docker并非原生Linux可执行文件，且挂载后在容器内变成了无效目录：

1. Mac的Docker Desktop运行在隐藏的Linux虚拟机中，本地/usr/local/bin/docker只是一个转发请求的包装脚本/符号链接，不是真正的二进制执行文件。直接挂载这个文件到Ubuntu容器，容器无法识别Mac环境的脚本，甚至因挂载机制问题，在容器内生成了空目录（从你的ls结果可见/usr/bin/docker是目录而非文件）。
2. 即便挂载了正确的客户端，Ubuntu容器默认缺少Docker客户端依赖库，也会导致执行失败。

方案一：在容器内安装Linux版Docker客户端（推荐） #

无需挂载主机的Docker客户端，只保留docker.sock挂载，直接在容器内安装适配Linux的Docker客户端：

1. 进入容器后执行：

apt update && apt install -y docker.io

2. 或者通过Dockerfile预先安装，修改docker-compose.yml：

services:
  jenkins:
    build: .
    container_name: ubuntu
    privileged: true
    tty: true
    volumes:
      - ./ubuntu/home:/home
      - /var/run/docker.sock:/var/run/docker.sock

对应的Dockerfile内容：

FROM ubuntu:latest
RUN apt update && apt install -y docker.io

方案二：挂载Linux版Docker二进制文件 #

如果坚持要通过挂载方式提供客户端，需下载适配Linux架构的Docker二进制文件：

1. 在Mac主机上下载Linux版Docker客户端（以amd64架构为例）：

curl -LO https://download.docker.com/linux/static/stable/x86_64/docker-24.0.7.tgz
tar xzvf docker-24.0.7.tgz

2. 修改docker-compose.yml的挂载路径，指向解压后的Linux版docker二进制文件：

services:
  jenkins:
    image: ubuntu:latest
    container_name: ubuntu
    privileged: true
    tty: true
    volumes:
      - ./ubuntu/home:/home
      - ./docker/docker:/usr/bin/docker
      - /var/run/docker.sock:/var/run/docker.sock

注：./docker/docker是你解压后得到的Linux版docker二进制文件的本地路径。

完成配置后，进入容器执行docker -v，若返回版本信息则表示配置成功。

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