安装 Docker

Linux

官方便捷脚本

适合能够访问 Docker 官方软件源的环境，以及开发、测试或快速部署。生产环境优先使用软件源安装。

# 安装 Docker
curl -fsSL https://get.docker.com | sh  # 执行官方便捷安装脚本

该脚本会安装 Docker Engine 和 Compose 插件。安装说明见 Docker 官方文档。

系统软件源

适合已配置可用 APT 镜像的 Ubuntu 26 和 Debian 13，国外和国内环境均可使用。软件版本由发行版仓库维护。

Ubuntu 26

# 安装 Docker
apt update                                  # 更新软件包索引
apt install -y docker.io docker-compose-v2  # 安装 Docker 与 Compose

Debian 13

# 安装 Docker
apt update                               # 更新软件包索引
apt install -y docker.io docker-compose  # 安装 Docker 与 Compose

阿里云镜像源

适合无法稳定访问国外软件源的国内环境，按照 阿里云：在 Linux 上安装 Docker 和 Docker Compose 配置对应发行版的软件源并安装。

卸载

根据安装来源卸载 Docker Engine 和 Compose：

官方或阿里云软件源（APT）

# 卸载软件包
# 卸载 Docker 与 Compose，保留数据
apt purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras

Ubuntu 26 系统软件源

# 卸载软件包
apt purge -y docker.io docker-compose-v2  # 卸载 Docker 与 Compose，保留数据

Debian 13 系统软件源

# 卸载软件包
apt purge -y docker.io docker-compose  # 卸载 Docker 与 Compose，保留数据

卸载软件包不会删除已有的镜像、容器、存储卷和网络，数据默认保留在 /var/lib/docker/ 和 /var/lib/containerd/。

删除全部 Docker 数据

确认不再需要已有数据后执行。该操作不可恢复：

# 删除数据（不可恢复）
rm -rf /var/lib/docker      # 删除 Docker 镜像、容器和卷等数据
rm -rf /var/lib/containerd  # 删除 containerd 数据

自定义配置和软件源配置不会自动删除，需要时手动清理。完整说明见 Docker 官方卸载文档。

镜像加速

在 Linux 中创建或编辑 Docker 守护进程配置：

# 配置镜像加速
mkdir -p /etc/docker         # 创建配置目录
vim /etc/docker/daemon.json  # 编辑守护进程配置

将 Docker Hub 代理地址添加为镜像源：

{
  "registry-mirrors": ["https://docker.example.com"]
}

保存配置后重启 Docker 服务：

# 应用配置
systemctl restart docker  # 重启 Docker 服务

macOS

get.docker.com 不支持 macOS。需使用 Docker Desktop（自带 Compose）：

# 安装 Docker Desktop
brew install --cask docker  # 使用 Homebrew 安装

或下载 Docker Desktop for Mac 安装包。

装完后打开 Docker.app

检查：

# 检查安装
docker version          # 查看客户端与服务端版本
docker compose version  # 查看 Compose 版本

开启 shell 补全

Settings → General → Configure shell completions

Windows

需开启 WSL 2。

可下载 Docker Desktop for Windows 安装包（自带 Compose）。

winget

# 安装环境
wsl --install                        # 安装 WSL
winget install Docker.DockerDesktop  # 安装 Docker Desktop

# 启动 Docker Desktop 后检查
docker version          # 查看客户端与服务端版本
docker compose version  # 查看 Compose 版本

wsl

# 安装 Docker
curl -fsSL https://get.docker.com | sh  # 执行官方便捷安装脚本

# 检查安装
docker version          # 查看客户端与服务端版本
docker compose version  # 查看 Compose 版本