macOS 上安装 Docker：详细步骤与常见问题解决 – wiki词典

作者： /

在 macOS 上安装 Docker：详细步骤与常见问题解决

Docker 已成为现代软件开发不可或缺的工具，它通过容器化技术简化了应用程序的打包、部署和运行。对于 macOS 用户而言，Docker Desktop 提供了一个集成的环境，让您可以在 Mac 上无缝地使用 Docker。本文将详细介绍如何在 macOS 上安装 Docker Desktop，并解决一些常见的安装和使用问题。

一、Docker 是什么？为什么在 macOS 上使用它？

Docker 是一个开源平台，用于开发、发布和运行应用程序。它通过将应用程序及其所有依赖项（库、配置、运行时等）打包到一个称为容器的独立单元中，从而确保应用程序在任何环境中都能以相同的方式运行。

在 macOS 上使用 Docker 的优势：

  1. 环境一致性：解决“在我的机器上能运行”的问题，确保开发、测试和生产环境的一致性。
  2. 隔离性：容器之间相互隔离，避免了依赖冲突。
  3. 轻量级：容器比传统虚拟机更轻量、启动更快，资源占用少。
  4. 跨平台：Docker 容器几乎可以在任何支持 Docker 的操作系统上运行。
  5. 易于部署：简化了应用程序的部署流程。

二、安装前的准备工作

在开始安装 Docker Desktop 之前，请确保您的 macOS 系统满足以下最低要求：

  • macOS 版本：
    • 对于 Intel 芯片的 Mac：macOS 10.15 或更高版本。
    • 对于 Apple 芯片 (M1/M2/M3) 的 Mac：macOS 11 或更高版本。
  • 内存 (RAM)：至少 4GB。
  • 磁盘空间：建议至少 20GB 可用空间（Docker 镜像和容器会占用大量空间）。
  • 网络连接：下载 Docker Desktop 安装包需要网络。

重要提示： 如果您使用的是较旧的 macOS 版本，可能需要安装旧版本的 Docker Desktop。请访问 Docker 官方文档查看兼容性列表。

三、详细安装步骤

步骤 1：下载 Docker Desktop

  1. 打开您的网络浏览器，访问 Docker 官方下载页面：https://www.docker.com/products/docker-desktop
  2. 根据您的 Mac 芯片类型（Intel 或 Apple 芯片）选择正确的下载链接。点击下载相应的 .dmg 文件。
    • Mac with Apple chip (M1/M2/M3)
    • Mac with Intel chip

步骤 2：安装 Docker Desktop

  1. 下载完成后，双击下载的 .dmg 文件。
  2. 一个安装窗口将打开。将 Docker 图标拖动到 Applications 文件夹中。
  3. 等待文件复制完成。

步骤 3：启动 Docker Desktop

  1. 打开 Applications 文件夹，找到 Docker 图标并双击启动。
  2. 首次启动时，macOS 可能会提示“Docker Desktop”是从互联网下载的应用程序，询问您是否确定要打开它。点击 “打开” (Open)。
  3. Docker Desktop 可能会要求获取文件访问权限。这是一个标准的安全提示，用于允许 Docker 访问其运行所需的内部文件和目录。点击 “接受” (Accept)。
  4. 如果您使用的是较新的 macOS 版本，Docker Desktop 可能会要求您输入密码以安装特权 helper 工具。这是 Docker 正常运行所必需的，请放心输入您的管理员密码。

步骤 4：完成初始设置

  1. 首次启动后，Docker Desktop 可能会显示一个欢迎界面或教程。您可以选择跳过或按照指引进行操作。
  2. Docker Desktop 应用程序会在菜单栏中显示一个鲸鱼图标。当鲸鱼图标稳定且没有动画时，表示 Docker Desktop 已成功启动并正在运行。

四、验证安装

要确认 Docker 是否已正确安装并运行，可以打开终端 (Terminal) 并运行几个简单的 Docker 命令。

  1. 打开 Terminal (可以通过 Spotlight 搜索 Terminal 或在 Applications/Utilities 文件夹中找到)。

  2. 运行以下命令来检查 Docker 版本：

    bash
    docker --version

    如果安装成功，您将看到 Docker 客户端的版本信息，例如：Docker version 24.0.5, build 7268edf (版本号可能不同)。

  3. 运行以下命令来检查 Docker Compose 版本（Docker Desktop 包含了 Docker Compose）：

    bash
    docker compose version

    您将看到 Docker Compose 的版本信息。

  4. 运行一个简单的 Docker 镜像来验证功能：

    bash
    docker run hello-world

    此命令会尝试从 Docker Hub 下载一个名为 hello-world 的测试镜像（如果本地没有），并在容器中运行它。如果一切正常，您应该会在终端中看到类似以下输出：

    Hello from Docker!
    This message shows that your installation appears to be working correctly.
    ...

    这表明您的 Docker Desktop 安装已成功，并且可以正常拉取和运行容器。

五、Docker Desktop 配置（可选）

通过点击菜单栏的鲸鱼图标，然后选择 Preferences / Settings，您可以调整 Docker Desktop 的配置：

  • Resources (资源)：
    • CPUs (CPU)：您可以分配给 Docker 的 CPU 核心数量。
    • Memory (内存)：分配给 Docker 的内存大小。
    • Disk image size (磁盘镜像大小)： Docker 存储镜像和容器数据的磁盘空间上限。
    • Swap：交换空间大小。
    • Files Sharing (文件共享)：配置哪些本地目录可以被 Docker 容器访问。这对于在容器中挂载本地代码非常重要。
  • Docker Engine：可以编辑 Docker 守护进程的 JSON 配置。
  • Kubernetes：如果需要，可以启用内置的 Kubernetes 集群。
  • Extensions (扩展)：管理 Docker 扩展。

对于大多数用户，默认设置就足够了，但如果您遇到性能问题或需要更多资源，可以根据您的需求进行调整。

六、常见问题解决

1. “Docker Desktop requires a newer macOS version.” (Docker Desktop 需要较新的 macOS 版本)

  • 问题原因：您的 macOS 版本低于 Docker Desktop 所要求的最低版本。
  • 解决方案：
    • 升级您的 macOS 系统到最新版本（如果您的硬件支持）。
    • 如果无法升级 macOS，请查找兼容您当前 macOS 版本的 Docker Desktop 旧版本并安装。Docker 官方文档通常会提供旧版本的下载链接和兼容性信息。

2. “Docker Desktop Failed to Start” (Docker Desktop 启动失败)

  • 问题原因：可能的原因包括：系统资源不足、权限问题、损坏的安装文件或与第三方虚拟化软件冲突。
  • 解决方案：
    • 重启 Mac：最简单的解决方案，有时可以解决临时性问题。
    • 重置 Docker Desktop：在菜单栏点击鲸鱼图标 -> Preferences / Settings -> Troubleshoot -> “Reset to factory defaults” (重置为出厂设置)。这会清除所有镜像和容器，但通常能解决启动问题。
    • 重新安装：如果重置无效，尝试完全卸载 Docker Desktop (从 Applications 文件夹拖到垃圾桶，并清空垃圾桶)，然后重新下载最新版本并安装。
    • 检查系统资源：确保您的 Mac 有足够的内存和磁盘空间。
    • 检查冲突：如果同时安装了其他虚拟化软件（如 VirtualBox, VMware Fusion），尝试禁用或卸载它们，看是否解决冲突。

3. 运行 docker run hello-world 提示 “Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?” (无法连接到 Docker 守护进程，Docker 守护进程是否正在运行？)

  • 问题原因：Docker Desktop 应用程序（即 Docker 守护进程）没有运行或没有正确启动。
  • 解决方案：
    • 确认 Docker Desktop 应用程序已启动：检查菜单栏的鲸鱼图标。如果它是灰色的或显示动画，说明正在启动或未运行。等待它稳定下来，或者手动从 Applications 文件夹启动 Docker Desktop。
    • 等待 Docker fully initialized：Docker Desktop 启动后需要一些时间来初始化其内部组件。请耐心等待，直到鲸鱼图标稳定显示。
    • 重启 Docker Desktop：在菜单栏点击鲸鱼图标 -> “Quit Docker Desktop” (退出 Docker Desktop)，然后重新启动它。

4. “disk image for Docker Desktop is too small” 或 “out of disk space” (Docker Desktop 磁盘镜像太小或磁盘空间不足)

  • 问题原因：Docker 镜像和容器占用了 Docker Desktop 分配的虚拟磁盘空间。
  • 解决方案：
    • 清理 Docker 资源：
      • 删除不再使用的容器：docker rm $(docker ps -aq) (删除所有停止的容器)
      • 删除不再使用的镜像：docker rmi $(docker images -aq) (删除所有未被使用的镜像)
      • 清理所有未被使用的 Docker 对象（容器、镜像、网络、卷）：docker system prune -a (谨慎使用，这会删除所有不使用的资源)
    • 增加 Docker Desktop 的磁盘镜像大小：菜单栏点击鲸鱼图标 -> Preferences / Settings -> Resources -> Disk image size。增加此值，然后点击 Apply & Restart。

5. 性能问题：Docker 运行缓慢或占用过多资源

  • 问题原因：默认分配给 Docker 的 CPU/内存可能不足，或者容器内部应用程序效率低下。
  • 解决方案：
    • 调整资源分配：菜单栏点击鲸鱼图标 -> Preferences / Settings -> Resources。根据您的 Mac 硬件配置和使用情况，适当增加 CPU 和内存的分配。
    • 优化容器内的应用程序：确保您的 Dockerfile 尽量精简，安装必要的依赖，并遵循最佳实践。
    • 使用 .dockerignore 文件：避免将不必要的文件（如 node_modules）复制到镜像中。
    • 清理不必要的卷和网络：docker volume prune 和 docker network prune 可以帮助清理。

6. 无法从容器访问本地文件 (File Sharing issues)

  • 问题原因：您没有在 Docker Desktop 的设置中正确配置文件共享。
  • 解决方案：
    • 菜单栏点击鲸鱼图标 -> Preferences / Settings -> Resources -> File Sharing。
    • 点击 + 号添加您希望容器能够访问的本地目录。
    • 确保容器中挂载的路径与 Docker Desktop 共享的路径匹配。例如，如果您共享了 /Users/youruser/projects，那么在 docker run 命令中，您可以这样挂载：-v /Users/youruser/projects:/app。

总结

通过遵循以上详细步骤和解决常见问题，您应该能够在 macOS 上成功安装并运行 Docker Desktop。Docker 将极大地提升您的开发效率，让您能够更加灵活和可靠地管理和运行应用程序。熟悉基本的 Docker 命令并定期清理不必要的资源，将有助于保持您的开发环境高效运行。

滚动至顶部