网站导航
> 技术文档 > Docker全平台安装指南(Mac/Linux/Windows)｜开发环境搭建必备_docker安装详细步骤

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

网友: 技术文档 2025-09-02 23:39:55

目录

    • 一、什么是Docker？
    • 二、为什么开发者需要Docker？
    • 三、安装前提
      • 通用要求
      • 各平台特殊要求
    • 四、Mac安装步骤
      • 1. 通过Homebrew安装（推荐）
      • 2. 官方PKG安装
      • 3. 验证安装
    • 五、Linux安装步骤
      • Ubuntu/Debian系
      • CentOS/RHEL系
    • 六、Windows安装步骤
      • 1. 启用WSL2（Windows 10/11）
      • 2. 安装Docker Desktop
      • 3. 配置镜像存储位置（可选）
    • 七、常见问题处理
      • ❌ Docker启动失败
      • 🐢 镜像拉取缓慢
      • 💾 磁盘空间不足
    • 下一步

一、什么是Docker？

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

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

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

三、安装前提

通用要求

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

各平台特殊要求

平台 要求 Mac macOS 10.15+ Linux 内核3.10+（Ubuntu 16.04+/CentOS 7+） Windows Win10专业版/企业版 v1903+ 或家庭版v2004+:cite[4]

四、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 updatesudo apt-get install \\ ca-certificates \\ curl \\ gnupg \\ lsb-release# 添加Docker官方GPG密钥sudo mkdir -p /etc/apt/keyringscurl -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 updatesudo 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# 启动Dockersudo 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 /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
  1. 下载WSL2内核更新包并安装
  2. 设置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上的安装部署

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

八度云下载

网络标签：

相关问题