Docker全平台安装指南(Mac/Linux/Windows)｜开发环境搭建必备

一、什么是Docker？

Docker是一个开源的容器化平台，允许开发者将应用及其依赖打包到轻量级、可移植的容器中。与虚拟机相比，Docker容器共享主机系统内核，启动更快、资源占用更少，是实现"一次构建，处处运行"的理想工具。

二、为什么开发者需要Docker？

• ✅ 环境一致性：解决"在我机器上能跑"的问题
• ⚡ 快速部署：秒级启动容器 vs 分钟级启动VM
• 📦 隔离性：每个容器拥有独立的运行环境
• 🔄 易扩展：支持快速水平扩展应用实例

三、安装前提

通用要求

• 64位操作系统
• 2GB以上可用内存(建议4GB+)
• 20GB可用磁盘空间

各平台特殊要求

四、Mac安装步骤

1. 通过Homebrew安装（推荐）

brew install --cask docker

# 顺便把docker compose也安装了，比直接使用docker更方便
brew install docker-compose

2. 官方PKG安装

1. 下载Docker Desktop for Mac
2. 双击DMG文件，拖拽Docker图标到Applications文件夹
3. 首次启动需在终端执行：

xattr -d com.apple.quarantine /Applications/Docker.app

3. 验证安装

docker --version
# 应显示类似：Docker version 20.10.17, build 100c701

五、Linux安装步骤

Ubuntu/Debian系

# 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 安装依赖
sudo apt-get update
sudo apt-get install \
    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

# 设置稳定版仓库
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-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 验证安装
sudo docker run hello-world

CentOS/RHEL系

# 卸载旧版本
sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

# 安装yum工具
sudo yum install -y yum-utils

# 添加仓库
sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

# 安装Docker引擎
sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 启动Docker
sudo systemctl start docker

# 设置开机自启
sudo systemctl enable docker

六、Windows安装步骤

1. 启用WSL2（Windows 10/11）

1. 以管理员身份打开PowerShell运行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

2. 下载WSL2内核更新包并安装
3. 设置WSL2为默认版本：

wsl --set-default-version 2

2. 安装Docker Desktop

1. 下载Docker Desktop for Windows
2. 双击安装包，勾选：
   • ☑ Install required Windows components for WSL 2
   • ☑ Add shortcut to desktop
3. 安装完成后重启电脑

3. 配置镜像存储位置（可选）

# 停止Docker服务
wsl --shutdown

# 导出数据
wsl --export docker-desktop-data D:\docker\docker-desktop-data.tar

# 注销原有分发
wsl --unregister docker-desktop-data

# 导入到新位置
wsl --import docker-desktop-data D:\docker\data D:\docker\docker-desktop-data.tar --version 2

七、常见问题处理

❌ Docker启动失败

• Mac/Linux：检查服务状态 sudo systemctl status docker
• Windows：确保已启用Hyper-V和WSL2

🐢 镜像拉取缓慢

配置国内镜像源（以Linux为例）：

// /etc/docker/daemon.json
{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}

重启服务：sudo systemctl restart docker

💾 磁盘空间不足

• Windows：按前文方法迁移存储位置
• Mac：在Docker Desktop中执行Disk cleanup
• Linux：定期清理无用镜像：

docker system prune -a

下一步

✅ 已完成Docker安装
➡️ 继续学习Dify在Docker上的安装部署

本文持续更新，遇到问题可在评论区留言。如果觉得有帮助，请点赞收藏支持！