Docker Desktop 在 macOS 上无法运行容器时，需依次确认应用启动、CLI 连通性、上下文配置、资源权限及端口映射。具体步骤包括：启动 Docker Desktop 并检查菜单栏状态；运行 docker version 和 docker info 验证通信；切换至 desktop-linux 上下文；在 Settings 中调高内存并添加文件共享路径；最后用 nginx 测试容器运行与 localhost:8080 访问。
如果您在 macOS 上安装了 Docker Desktop，但无法正常连接或运行容器，则可能是由于 Docker Desktop 未启动、后台服务异常、权限配置缺失或 Docker CLI 与后台守护进程通信失败所致。以下是完成 MAC 连接 Docker 桌面版并正确配置容器运行环境的具体步骤：
一、确认 Docker Desktop 已正确启动并运行
Docker Desktop 在 macOS 中以图形化应用形式运行，其后台依赖于一个驻留的守护进程（com.docker.desktop），只有该进程处于活跃状态，CLI 才能通过 Unix socket 与其通信。
1、打开“访达”，进入“应用程序”文件夹，双击 Docker Desktop 图标启动应用。
2、观察屏幕右上角菜单栏，确认出现鲸鱼图标且状态为 正在运行（图标无灰色遮罩、无感叹号）。
3、点击菜单栏鲸鱼图标，选择“About Docker Desktop”，查看版本号是否显示；若显示“Not running”，则需点击“Start Docker Desktop”。
二、验证 Docker CLI 与守护进程连通性
Docker 命令行工具（docker）需通过本地 Unix socket（/var/run/docker.sock）与 Docker Desktop 内置的 Moby VM 通信；若路径不可达或权限拒绝，将导致“Cannot connect to the Docker daemon”错误。
1、打开“终端”，执行命令：docker version，检查 Client 和 Server 两部分均输出版本信息。
2、若提示“Cannot connect to the Docker daemon”，运行：ls -l /var/run/docker.sock，确认该 socket 文件存在且属组为 docker。
3、如无输出或权限报错，重启 Docker Desktop：菜单栏鲸鱼图标 → “Restart”；重启后再次运行 docker info 验证响应。
三、启用并配置 Docker CLI 的默认上下文
macOS 上 Docker Desktop 默认使用 desktop-linux 上下文，该上下文指向内置 LinuxKit VM；若上下文被手动切换至其他（如 kubernetes 或远程），会导致本地容器无法运行。
1、在终端中执行：docker context ls，查看当前上下文列表及标记为 * 的活动项。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
2、若活动项非 desktop-linux，执行：docker context use desktop-linux 切换回默认上下文。
3、执行：docker context inspect desktop-linux，确认其中 Host 字段值为 unix:///Users/xxx/.docker/run/docker.sock 类似路径（实际路径以输出为准）。
四、配置容器运行所需的资源与权限
Docker Desktop for Mac 默认运行在轻量级 Linux 虚拟机中，其 CPU、内存、磁盘镜像等资源由用户显式分配；若资源不足或文件共享路径未授权，容器可能启动失败或挂载失败。
1、点击菜单栏鲸鱼图标 → “Settings” → “Resources” → “Memory”，将内存调高至 2GB 或以上（推荐 4GB）。
2、在同一设置页中，点击 “File sharing”，确认项目所在目录（如 /Users/yourname/workspace）已添加至共享路径列表，并勾选启用。
3、点击 “Apply & Restart”，等待 Docker Desktop 重启完成，再尝试运行容器命令。
五、测试容器运行与端口映射功能
完成上述配置后，应能成功拉取镜像、创建并运行容器；特别注意 macOS 环境下宿主机网络命名空间与容器隔离机制，端口映射必须显式声明才能从 macOS 访问。
1、在终端中执行：docker run --rm -d -p 8080:80 nginx，以后台模式启动 Nginx 容器并将容器 80 端口映射至宿主机 8080 端口。
2、执行：docker ps，确认容器状态为 Up，且 PORTS 列显示 0.0.0.0:8080->80/tcp。
3、在 Safari 或 Chrome 中访问 http://localhost:8080，页面显示 “Welcome to nginx!” 即表示容器运行与网络配置成功。
