Docker 安装指南

Docker 是当今最流行的容器化技术，本文将详细介绍如何在各个操作系统上安装 Docker。

系统要求

在安装 Docker 之前，请确保你的系统满足以下要求：

Windows

• Windows 10 64位：专业版、企业版或教育版（Build 19041 或更高版本）
• Windows 11 64位
• 启用 WSL 2（Windows Subsystem for Linux）
• 启用 BIOS 虚拟化支持

macOS

• macOS 12 (Monterey) 或更高版本
• Apple Silicon (M1/M2/M3) 或 Intel 芯片
• 至少 4GB 内存

Linux

• 64位系统
• 内核版本 3.10 或更高
• 支持的发行版：Ubuntu、Debian、CentOS、Fedora 等

Docker Desktop（跨平台推荐）

Docker Desktop 是官方提供的跨平台图形化工具，支持 Windows、macOS 和 Linux，适合大多数用户。

下载地址

访问 Docker 官网 根据你的系统下载对应版本：

系统	下载链接
Windows	Docker Desktop for Windows
macOS (Apple Silicon)	Docker Desktop for Mac (M)
macOS (Intel)	Docker Desktop for Mac (Intel)
Linux	Docker Desktop for Linux

Windows 安装

方法一：Docker Desktop

1. 启用 WSL 2（首次安装需要）

   以管理员身份打开 PowerShell，执行：

   wsl --install                    # 安装之后需要重启
   wsl --set-default-version 2      # 设置默认版本

2. 安装 Docker Desktop

   • 双击下载的 Docker Desktop Installer.exe
   • 勾选 “Use WSL 2 instead of Hyper-V”
   • 点击 “Ok” 开始安装
   • 安装完成后重启电脑

3. 验证安装

   docker --version
   docker run hello-world

方法二：WSL 2 + Linux Docker

• 如果不想使用 Docker Desktop，可以在 WSL 2 中安装 Linux 版 Docker：

  # 在 WSL 2 Ubuntu 中执行
  curl -fsSL https://get.docker.com -o get-docker.sh
  sudo sh get-docker.sh
  
  # 将当前用户添加到 docker 组
  sudo usermod -aG docker $USER

macOS 安装

方法一：Docker Desktop

1. 下载对应芯片版本（Apple Silicon 或 Intel）
2. 打开下载的 .dmg 文件
3. 将 Docker 图标拖到 Applications 文件夹
4. 打开 Docker 应用，等待启动完成

方法二：Homebrew 安装

• 在安装了 Homebrew 的前提下

  brew install --cask docker
  open /Applications/Docker.app

方法三：Colima（轻量替代方案）

• 如果不想使用 Docker Desktop，可以使用开源的 Colima：

  brew install colima docker
  colima start
  docker run hello-world

Linux 安装

Ubuntu / Debian

• 终端运行如下代码:

  # 更新包索引
  sudo apt update
  
  # 安装依赖
  sudo apt install -y ca-certificates curl gnupg lsb-release
  
  # 添加 Docker 官方 GPG 密钥
  sudo mkdir -p /etc/apt/keyrings
  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  
  # 添加 Docker 仓库
  echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  
  # 安装 Docker
  sudo apt update
  sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  
  # 将当前用户添加到 docker 组（免 sudo）
  sudo usermod -aG docker $USER
  
  # 重新登录后生效，或执行
  newgrp docker
  
  # 验证安装
  docker run hello-world

CentOS / RHEL / Fedora

• 终端运行如下代码:

  # 安装依赖
  sudo yum install -y yum-utils
  
  # 添加 Docker 仓库
  sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
  
  # 安装 Docker
  sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  
  # 启动 Docker
  sudo systemctl start docker
  sudo systemctl enable docker
  
  # 将当前用户添加到 docker 组
  sudo usermod -aG docker $USER
  
  # 验证安装
  docker run hello-world

一键安装脚本（所有 Linux）

• Docker 官方提供了便捷安装脚本：

  # 下载并执行安装脚本
  curl -fsSL https://get.docker.com -o get-docker.sh
  sudo sh get-docker.sh
  
  # 将当前用户添加到 docker 组
  sudo usermod -aG docker $USER

  ⚠️ 注意：官方脚本仅建议用于开发环境，生产环境请使用手动安装方式。

配置 Docker 镜像加速

由于网络原因，国内访问 Docker Hub 可能较慢，建议配置镜像加速。

Linux / macOS

• 编辑或创建 /etc/docker/daemon.json：

  {
      "insecure-registries": [
          "docker.gh-proxy.com"
      ],
      "registry-mirrors": [
          "https://docker.1ms.run",
          "https://docker.xuanyuan.me"
      ],
      "dns": [
          "8.8.8.8",
          "1.1.1.1",
          "223.5.5.5"
      ]
  }

• 重启 Docker：

  sudo systemctl restart docker

Docker Desktop

1. 打开 Docker Desktop 设置
2. 选择 “Docker Engine”
3. 添加镜像加速配置
4. 点击 “Apply & Restart”

验证安装

• 安装完成后，运行以下命令验证：

  # 查看 Docker 版本
  docker --version
  
  # 查看详细信息
  docker info
  
  # 运行测试容器
  docker run hello-world
  
  # 查看正在运行的容器
  docker ps
  
  # 查看所有容器
  docker ps -a

常见问题

1. Windows: WSL 2 未启用

• Powershell 运行如下代码:

  # 以管理员身份运行
  dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
  dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  
  # 重启后设置 WSL 2
  wsl --set-default-version 2

2. Linux: permission denied

• 终端运行如下代码:

  # 将用户添加到 docker 组
  sudo usermod -aG docker $USER
  
  # 重新登录或执行
  newgrp docker

3. macOS: Docker Desktop 启动慢

• 分配更多内存和 CPU（设置 → Resources）
• 清理未使用的镜像和容器：docker system prune -a

4. 拉取镜像超时

• 配置镜像加速，或使用代理：

  # 临时设置代理
  export HTTP_PROXY=http://proxy:port
  export HTTPS_PROXY=http://proxy:port
  docker pull nginx

Docker 基本命令

• 安装完成后，试试这些基本命令：

  # 拉取镜像
  docker pull nginx
  
  # 运行容器
  docker run -d -p 8080:80 nginx
  
  # 查看容器
  docker ps
  
  # 停止容器
  docker stop <container_id>
  
  # 删除容器
  docker rm <container_id>
  
  # 删除镜像
  docker rmi nginx

下一步

Docker 安装完成后，你可以：

TODO…

Happy Dockering! 🐳