梯子Z 来自巴黎的稳定快速安全ShadowsocksR梯子返回首页

docker install 怎么装?Windows、macOS、Linux 安装与验证步骤

更新于 2026-11-20 · zionladderq.shop

简答:普通电脑优先选择 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 Desktopdocker version、docker run hello-world
macOS Intel 或 Apple 芯片电脑Docker Desktopdocker version、docker run hello-world
Ubuntu、Debian 服务器Docker Enginesudo systemctl status docker、sudo docker run hello-world
Fedora、RHEL 服务器Docker Enginesudo 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。

  1. 打开Windows 安装官方页面,确认系统版本、处理器架构和 WSL 2 条件。
  2. 下载与设备架构匹配的安装程序。x86_64 与 Arm 设备不要混用安装包。
  3. 运行安装程序,按向导完成安装;如果系统提示重启,请先重启再继续。
  4. 从开始菜单打开 Docker Desktop,等待引擎状态正常。
  5. 在 PowerShell 或 Windows Terminal 中执行以下命令:

docker version docker run hello-world

macOS 用户应根据 Intel 或 Apple 芯片选择对应版本。安装流程通常是下载 Docker.dmg、将 Docker 拖入 Applications,然后从 Applications 打开 Docker Desktop 并接受相关协议。完整菜单和权限要求以macOS 安装官方页面为准。

  1. 确认 Mac 芯片类型,并下载匹配的 Docker Desktop 安装包。
  2. 打开 Docker.dmg,将 Docker 拖到 Applications。
  3. 从 Applications 启动 Docker Desktop,按界面提示完成首次设置。
  4. 打开 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 foundcommand -v docker客户端未安装、PATH 未更新,或安装的是另一套软件包。
无法连接 Docker daemonsudo systemctl status dockerLinux 服务未启动;先执行 sudo systemctl start docker。
没有权限访问 Docker socketdocker 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 通常已集成这些组件。

相关阅读

参考资料

  1. Docker Engine 安装总览
  2. Docker Desktop 快速安装
  3. Docker Desktop Windows 安装
  4. Docker Desktop macOS 安装
  5. Docker Engine Ubuntu 安装
  6. Docker Engine Debian 安装
  7. Docker Engine Fedora 安装
  8. Docker Engine RHEL 安装
  9. Docker Engine Linux 安装后配置