docker install 怎么装?Windows、macOS、Linux 安装与验证步骤
简答:普通电脑优先选择 Docker Desktop,Linux 服务器选择 Docker Engine;Linux 建议使用 Docker 官方软件仓库,安装后运行 docker version 与 docker run hello-world 验证。具体系统版本、CPU 架构和可用安装包应以你查看当天的 Docker 官方页面为准。
定义:docker install 是根据操作系统安装 Docker Desktop 或 Docker Engine,并通过命令验证容器运行环境的过程。
先选 Docker Desktop 还是 Docker Engine
如果你是在 Windows 或 macOS 电脑上学习、开发或运行本地容器,优先选择 Docker Desktop;如果你使用的是没有桌面环境的 Linux 服务器,通常选择 Docker Engine。Docker 官方说明 Docker Desktop 集成 Docker Engine、Docker CLI、Buildx 和 Compose,而 Linux 服务器场景应使用 Docker Engine。可先查看Docker Desktop 官方安装说明与Docker Engine 官方安装总览。
| 使用场景 | 建议选择 | 安装后的主要验证 |
|---|---|---|
| Windows 个人电脑 | Docker Desktop | docker version、docker run hello-world |
| macOS Intel 或 Apple 芯片电脑 | Docker Desktop | docker version、docker run hello-world |
| Ubuntu、Debian 服务器 | Docker Engine | sudo systemctl status docker、sudo docker run hello-world |
| Fedora、RHEL 服务器 | Docker Engine | sudo systemctl enable --now docker、sudo docker run hello-world |
本文属于网络与客户端连接排查主题下的 Docker 安装基础说明;如果你的目标是部署具体应用,应继续核对应用本身的端口、DNS、MTU 和外部网络连通性要求。
Windows 和 macOS:安装 Docker Desktop
Windows 用户先查看系统要求、处理 WSL 2 或虚拟化条件,再下载并运行 Docker Desktop 安装程序。Docker 官方页面说明,Windows 安装过程中可能需要重启,安装完成后从开始菜单打开 Docker Desktop。
- 打开Windows 安装官方页面,确认系统版本、处理器架构和 WSL 2 条件。
- 下载与设备架构匹配的安装程序。x86_64 与 Arm 设备不要混用安装包。
- 运行安装程序,按向导完成安装;如果系统提示重启,请先重启再继续。
- 从开始菜单打开 Docker Desktop,等待引擎状态正常。
- 在 PowerShell 或 Windows Terminal 中执行以下命令:
docker version
docker run hello-world
macOS 用户应根据 Intel 或 Apple 芯片选择对应版本。安装流程通常是下载 Docker.dmg、将 Docker 拖入 Applications,然后从 Applications 打开 Docker Desktop 并接受相关协议。完整菜单和权限要求以macOS 安装官方页面为准。
- 确认 Mac 芯片类型,并下载匹配的 Docker Desktop 安装包。
- 打开 Docker.dmg,将 Docker 拖到 Applications。
- 从 Applications 启动 Docker Desktop,按界面提示完成首次设置。
- 打开 Terminal,执行:
docker version
docker run hello-world
如果命令提示无法连接 Docker daemon,先确认 Docker Desktop 已经启动并完成初始化,不要只重复执行命令。
Ubuntu:使用官方 apt 仓库安装 Docker Engine
以下命令需要在 Ubuntu 终端执行,并使用具有 sudo 权限的账户。Docker 官方页面截至 2026-11-20 列出多个受支持的 Ubuntu 版本与 CPU 架构;请以你查看当天的官方页面为准,不要只根据网上旧教程判断是否兼容。
第一步,删除可能冲突的发行版软件包。这个操作不会自动删除 Docker 数据目录,但如果机器上已有容器或镜像,仍应先确认数据是否需要保留。
sudo apt remove docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc
第二步,添加 Docker 官方 GPG 密钥和 apt 软件源:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: ${UBUNTU_CODENAME:-$VERSION_CODENAME}
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
第三步,安装 Docker Engine、CLI、containerd、Buildx 插件和 Compose 插件:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
第四步,检查服务状态;如果服务没有运行,再手动启动:
sudo systemctl status docker
sudo systemctl start docker
第五步,用测试容器确认安装:
sudo docker version
sudo docker run hello-world
上述仓库、软件包和验证流程来自Docker Ubuntu 官方安装文档。如果你使用的是 Ubuntu 衍生版,Docker 官方提示其支持状态可能不同,不能直接把 Ubuntu 的结果当作正式兼容承诺。
Debian:使用 apt 仓库安装 Docker Engine
Debian 终端命令需要 sudo 权限。Docker 官方 Debian 页面截至 2026-11-20 列出受支持的 Debian 版本和 amd64、arm64 等架构;安装前先核对系统信息:
cat /etc/os-release
dpkg --print-architecture
删除可能冲突的软件包:
sudo apt remove docker.io docker-compose docker-doc docker-buildx podman-docker containerd runc
添加官方密钥和软件源:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/debian
Suites: $(. /etc/os-release && echo "$VERSION_CODENAME")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
安装并启动:
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl status docker
sudo systemctl start docker
sudo docker run hello-world
完整的软件包名称、Debian 版本和卸载说明请以Docker Debian 官方安装文档为准。
Fedora 或 RHEL:使用 dnf 仓库安装 Docker Engine
Fedora 和 RHEL 使用 dnf,安装命令需要 sudo 权限。Docker 官方页面对两类系统分别提供仓库配置方式,版本支持会随时间变化,建议先查看官方页面当前列出的版本。
Fedora 安装
sudo dnf remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-selinux docker-engine-selinux docker-engine
sudo dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo
sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo docker run hello-world
RHEL 安装
sudo dnf remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine podman runc
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker
sudo docker run hello-world
Fedora 的仓库、服务启动和验证步骤见Docker Fedora 官方文档;RHEL 的版本、仓库和冲突包说明见Docker RHEL 官方文档。如果安装后提示 iptables 相关错误,先查看系统日志和当前防火墙实现,不要直接删除防火墙规则。
Linux 安装后:取消 sudo、验证 Compose 与处理权限
Linux 安装完成后默认可能只能通过 sudo 执行 Docker 命令。Docker 官方说明,docker 用户组能够访问 Docker Unix socket,而该组权限接近 root 权限,因此只应把可信账户加入其中。
将当前用户加入 docker 组:
sudo groupadd docker
sudo usermod -aG docker $USER
newgrp docker
docker run hello-world
如果系统提示 docker 组已经存在,通常可以继续执行。也可以完全退出当前登录会话后重新登录,让组权限重新加载。若之前用 sudo 执行过 Docker,出现 ~/.docker/config.json: permission denied,可按官方建议修复目录权限:
sudo chown "$USER":"$USER" "$HOME/.docker" -R
sudo chmod g+rwx "$HOME/.docker" -R
验证 Compose 和 Buildx 是否安装:
docker compose version
docker buildx version
如果只需要临时执行一次命令,也可以继续使用 sudo,不必为了去掉 sudo 而修改权限。docker 用户组的安全含义与 rootless 模式说明,见Docker Linux 安装后官方说明。
安装失败时,按症状排查
| 现象 | 先执行什么 | 判断方向 |
|---|---|---|
docker: command not found | command -v docker | 客户端未安装、PATH 未更新,或安装的是另一套软件包。 |
| 无法连接 Docker daemon | sudo systemctl status docker | Linux 服务未启动;先执行 sudo systemctl start docker。 |
| 没有权限访问 Docker socket | docker run hello-world | 先用 sudo 验证,再检查 docker 组和重新登录状态。 |
| apt 或 dnf 依赖冲突 | dpkg --get-selections 或 dnf list installed | 检查 docker.io、旧 Compose、containerd、runc 或发行版自带包。 |
| hello-world 拉取超时 | docker info、curl -I https://registry-1.docker.io/v2/ | 区分 Docker 服务、DNS、代理、防火墙和镜像仓库访问路径。 |
| Windows 启动失败 | 检查 Docker Desktop、WSL 2、虚拟化状态 | 优先按 Docker Desktop Windows 官方安装页面逐项核对。 |
排障时应先确认问题发生在哪一层:命令是否存在、Docker 服务是否运行、当前账户是否有权限、镜像仓库是否可达。不要把镜像拉取失败直接判断为安装失败。
卸载 Docker:先区分软件与数据
卸载 Docker Engine 不等于自动删除镜像、容器、卷和网络数据。若数据仍要保留,只卸载软件包;若确认需要清空本机 Docker 数据,再执行删除数据目录的命令。
Ubuntu 或 Debian:
sudo apt purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
Fedora 或 RHEL:
sudo dnf remove docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
确认数据不再需要后,再考虑:
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd
删除数据目录属于不可逆操作,执行前应先检查容器、镜像、卷和自定义配置是否需要备份。Docker Desktop 则应使用对应系统的应用卸载流程,并以官方桌面端文档为准。
常见问题
docker install 应该安装 Docker Desktop 还是 Docker Engine?
Windows 和 macOS 普通电脑优先选择 Docker Desktop;没有桌面环境的 Linux 服务器选择 Docker Engine。Docker Desktop 集成图形界面与常用组件,Docker Engine 更适合服务器环境。
Linux 可以直接运行 curl -fsSL https://get.docker.com/ | sudo sh 吗?
可以用于开发或测试环境的快速安装,但 Docker 官方不建议把 convenience script 作为生产环境的首选。生产或长期运行的服务器更适合使用对应发行版的官方软件仓库,并先检查脚本内容与系统状态。
为什么安装后 docker 命令必须加 sudo?
Linux 默认由 root 拥有 Docker Unix socket,普通用户没有访问权限。可以继续使用 sudo,也可以按 Docker 官方步骤将用户加入 docker 组;但 docker 组拥有接近 root 的权限,加入前应确认账户可信。
docker run hello-world 失败,是否说明 Docker 没有安装成功?
不一定。先分别执行 docker version、sudo systemctl status docker 和 docker info,判断是客户端、服务、权限还是镜像仓库访问问题。命令存在且服务运行时,hello-world 失败也可能是 DNS、代理、防火墙或仓库连接问题。
卸载 Docker 会不会删除镜像和容器?
Docker 官方安装页面说明,卸载软件包通常不会自动删除 /var/lib/docker 中的镜像、容器、卷和网络数据。只有在确认数据不再需要时,才执行删除数据目录的命令。
Docker Compose 和 Buildx 是否需要另外安装?
使用官方仓库安装 Docker Engine 时,推荐同时安装 docker-compose-plugin 和 docker-buildx-plugin。安装后可用 docker compose version 与 docker buildx version 检查;Docker Desktop 通常已集成这些组件。