macOS Docker安装指南：一步步教你搞定 – wiki基地

作者： /

macOS Docker安装指南：一步步教你搞定

Docker 已经成为现代软件开发中不可或缺的工具。它允许开发者将应用程序及其所有依赖项打包到一个标准化的、可移植的容器中，从而解决了“在我机器上能跑”的问题。无论你是前端、后端、DevOps 工程师，还是刚刚踏入开发领域的新手，在 macOS 上安装并使用 Docker 都是提升开发效率和环境一致性的重要一步。

本指南将带你一步步完成在 macOS 上安装 Docker Desktop 的过程，并进行基本的验证和操作。

1. 为什么要在 macOS 上使用 Docker？

  • 环境隔离与一致性： 你的应用程序运行在独立的容器中，不会与 macOS 本身的环境相互干扰。团队成员使用相同的 Docker 镜像，确保开发、测试和生产环境的一致性。
  • 快速部署： 打包好的 Docker 镜像可以轻松部署到任何支持 Docker 的平台，大大简化了部署流程。
  • 资源利用： 容器比传统虚拟机更轻量级，启动更快，占用的系统资源更少。
  • 生态系统： Docker 拥有庞大的镜像库（Docker Hub）和活跃的社区支持，你可以轻松找到并使用各种现成的服务。

2. 前置条件

在开始安装之前，请确保你的 macOS 系统满足以下条件：

  • macOS 版本： macOS Sierra 10.12 或更高版本。
  • 硬件要求：
    • Intel 芯片 Mac： 2010 年或更新型号的 Mac，支持 Intel VT-x 虚拟化技术。
    • Apple Silicon (M1/M2/M3) Mac： 支持 Apple 芯片的 Mac。
  • 内存： 至少 4GB RAM，推荐 8GB 或更高。
  • 网络连接： 下载 Docker Desktop 安装包需要稳定的网络连接。

3. 安装 Docker Desktop

Docker Desktop 是在 macOS 上运行 Docker 的官方推荐方式，它提供了一个图形用户界面（GUI）和所有必要的组件（Docker Engine、Docker CLI、Docker Compose、Kubernetes）。

步骤 1：下载 Docker Desktop

  1. 打开你的网页浏览器，访问 Docker 官方下载页面：https://www.docker.com/products/docker-desktop
  2. 根据你的 Mac 芯片类型（Intel 或 Apple Silicon），选择对应的 macOS 版本下载。
    • 如果你是 M1/M2/M3 芯片的 Mac，请选择 “Mac with Apple chip”。
    • 如果你是 Intel 芯片的 Mac，请选择 “Mac with Intel chip”。
  3. 点击下载按钮，会下载一个 .dmg 格式的安装文件（例如 Docker.dmg）。

步骤 2：安装 Docker Desktop

  1. 找到下载的 Docker.dmg 文件，双击打开。
  2. 在弹出的窗口中，将 Docker 图标拖拽到 Applications (应用程序) 文件夹中。
  3. 等待文件复制完成。
  4. 完成复制后，可以关闭安装窗口并弹出 Docker.dmg 文件。

步骤 3：启动 Docker Desktop

  1. 打开 Applications (应用程序) 文件夹，找到并双击 Docker 图标启动 Docker Desktop。
  2. 首次启动时，macOS 可能会提示“Docker 应用程序来自互联网，你确定要打开它吗？”点击 “打开”。
  3. Docker Desktop 会请求访问某些系统权限，例如“Docker Desktop 需要特权访问”。按照提示输入你的 macOS 用户密码并点击 “好” 或 “OK” 以授权。
  4. Docker Desktop 启动后，你可能会看到一份服务条款协议。请阅读并接受协议以继续。
  5. 在系统菜单栏（屏幕右上角）中，你会看到一个 Docker 的鲸鱼图标。如果鲸鱼图标是稳定的（没有动画效果），并且显示“Docker Desktop is running”，则表示 Docker 已成功启动。

4. 验证安装

安装完成后，我们需要验证 Docker 是否正确工作。

  1. 打开你的 Terminal (终端) 应用程序。

  2. 输入以下命令，检查 Docker 版本：

    bash
    docker --version
    docker compose version

    如果这些命令成功执行并显示版本信息，说明 Docker CLI 工具已正确安装并可在你的 PATH 中找到。

  3. 接下来，运行一个简单的 Docker 镜像来验证 Docker Engine 是否正常工作：

    bash
    docker run hello-world

    • docker run 命令用于创建并运行一个新的容器。
    • hello-world 是 Docker 官方提供的一个极小的测试镜像。

    如果一切正常，你应该会在终端看到类似以下内容的输出：

    Unable to find image 'hello-world:latest' locally
    latest: Pulling from library/hello-world
    ...
    Hello from Docker!
    This message shows that your installation appears to be working correctly.
    ...

    这表明 Docker 已经成功地从 Docker Hub 拉取了 hello-world 镜像并在容器中运行了它。

5. Docker Desktop 实用功能概览

在 macOS 菜单栏点击 Docker 鲸鱼图标，你可以访问 Docker Desktop 的 GUI 界面，这里提供了一些有用的功能：

  • Dashboard (仪表盘): 查看和管理你正在运行的容器、镜像和卷。
  • Preferences (偏好设置):
    • Resources (资源): 配置 Docker 可用的 CPU、内存、磁盘空间等系统资源。对于性能敏感的应用，调整这些设置非常重要。
    • Kubernetes: 如果你需要使用 Kubernetes，可以在这里启用它。
    • Docker Engine: 配置 Docker Engine 的高级设置。
  • Troubleshoot (故障排除): 提供诊断工具和重置 Docker Desktop 的选项。

6. 常见问题与故障排除

  • “Docker Desktop is starting…” 一直显示：
    • 确保你的 macOS 系统已更新到最新版本。
    • 尝试重启你的 Mac。
    • 在 Docker Desktop 菜单的 Troubleshoot (故障排除) 中尝试 Restart Docker Desktop (重启 Docker Desktop) 或 Reset to factory defaults (恢复出厂设置)。
  • “Cannot connect to the Docker daemon”：
    • 这通常意味着 Docker Engine 没有运行。检查菜单栏的鲸鱼图标，确保它显示“Docker Desktop is running”。
    • 如果 Docker Desktop 没有启动，尝试手动启动它。
  • 性能问题：
    • 在 Preferences (偏好设置) -> Resources (资源) 中，适当增加分配给 Docker 的 CPU 和内存。
    • 避免在 Docker Volume 中存放大量文件，这可能会影响性能。

7. 恭喜！你已成功安装 Docker！

现在你已经在 macOS 上成功安装并运行了 Docker Desktop。你可以开始探索 Docker 的强大功能了：

  • 拉取更多镜像： docker pull nginx
  • 运行一个 Web 服务器： docker run -p 80:80 --name my-nginx -d nginx
  • 查看运行中的容器： docker ps
  • 停止容器： docker stop my-nginx
  • 删除容器： docker rm my-nginx
  • 探索 Docker Compose： 用于定义和运行多容器 Docker 应用程序的工具。

Docker 的世界广阔而充满机遇，祝你在容器化的旅程中一切顺利！

滚动至顶部