Docker 彻底卸载指南：跨平台基础移除与深度清理

# 删除核心数据目录（镜像、容器、卷等）
sudo rm -rf /var/lib/docker /var/lib/containerd
# 删除配置文件
sudo rm -rf /etc/docker /etc/default/docker
# 删除用户配置
rm -rf ~/.docker
# 删除日志文件
sudo rm -rf /var/log/docker /var/log/containerd

3.2 Linux 系统（CentOS/RHEL）

3.2.1 停止服务与进程

sudo systemctl stop docker containerd
sudo systemctl disable docker containerd
# 禁止开机自启

3.2.2 移除 Docker 包

使用 yum 或 dnf 卸载：

sudo yum remove -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo yum autoremove -y

3.2.3 清理残留文件

sudo rm -rf /var/lib/docker /var/lib/containerd /etc/docker ~/.docker
sudo rm -rf /usr/lib/systemd/system/docker.service /usr/lib/systemd/system/docker.socket
sudo systemctl daemon-reload
# 刷新 systemd 配置

3.3 Windows 系统（Docker Desktop）

3.3.1 卸载 Docker Desktop 应用

1. 通过'设置'卸载： 打开 设置 > 应用 > 应用和功能，找到'Docker Desktop'，点击'卸载'，勾选'Also delete my settings and data'以删除配置和数据。

命令行强制卸载（适用于卸载失败场景）：

# 使用 winget 卸载
winget uninstall Docker.DockerDesktop
# 若失败，使用安装包卸载（替换实际版本号）
msiexec /x {DockerDesktop 安装包 GUID} /qn

3.3.2 清理 WSL 2 集成

Docker Desktop 依赖 WSL 2 时，需注销相关分发：

# 停止 WSL 实例
wsl --shutdown
# 注销 Docker 专用 WSL 分发
wsl --unregister docker-desktop
wsl --unregister docker-desktop-data

3.3.3 删除残留文件与注册表

• 注册表清理（需谨慎操作，建议先备份注册表）： 打开 regedit，删除以下路径：
  • HKEY_LOCAL_MACHINE\SOFTWARE\Docker Inc.
  • HKEY_CURRENT_USER\SOFTWARE\Docker Inc.
  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\Docker Desktop

文件残留：

# 删除程序文件
rm -rf "C:\Program Files\Docker"
rm -rf "C:\ProgramData\Docker"
rm -rf "$env:LOCALAPPDATA\Docker"
rm -rf "$env:APPDATA\Docker"
rm -rf "$env:USERPROFILE\.docker"

3.4 macOS 系统（Docker Desktop）

3.4.1 关闭 Docker Desktop 并删除应用

1. 点击菜单栏 Docker 图标，选择'Quit Docker Desktop'退出应用。

打开 Finder，进入 /Applications 目录，将 Docker.app 拖入废纸篓，或通过终端删除：

sudo rm -rf /Applications/Docker.app

3.4.2 删除支持文件与配置

macOS 的 Docker 残留文件分散在多个目录，需逐一清理：

# 删除应用支持数据
rm -rf ~/Library/Application\ Support/Docker\ Desktop
# 删除用户配置
rm -rf ~/.docker
# 删除日志文件
rm -rf ~/Library/Logs/Docker\ Desktop
# 删除偏好设置
defaults delete com.docker.docker

3.4.3 清理命令行工具

若手动安装过 Docker CLI，需删除相关二进制文件：

sudo rm -f /usr/local/bin/docker /usr/local/bin/docker-compose /usr/local/bin/docker-machine

四、深度残留清理：从文件到网络

4.1 核心残留文件路径汇总

不同系统的 Docker 残留文件路径差异较大，需针对性清理：

4.2 网络残留清理

Docker 安装时会创建虚拟网络设备和规则，卸载后需手动清理：

• Windows 网络清理： 打开'网络连接'，删除名称包含'Docker'的虚拟网卡（如'vEthernet (DockerNAT)'）。

Linux 网络清理：

# 删除 docker0 网桥
sudo ip link delete docker0
# 清理 iptables 规则（谨慎操作，会删除所有自定义规则）
sudo iptables -F && sudo iptables -t nat -F

4.3 系统服务与进程检查

确保无 Docker 相关进程或服务残留：

# Linux 检查进程
ps aux | grep docker
# 无输出则无残留进程
# Windows 检查服务
sc query | findstr "docker"
# 无输出则无残留服务

五、卸载验证：如何确认 Docker 已彻底移除？

5.1 基础验证步骤

1. 命令检查：在终端执行 docker --version，若返回'command not found'则 Docker CLI 已移除。
2. 文件检查：确认核心残留目录（如 /var/lib/docker、~/.docker）已删除。
3. 服务检查：
   • Linux：sudo systemctl list-unit-files | grep docker 无输出。
   • Windows：services.msc 中无'Docker Desktop Service'等相关服务。

5.2 高级验证：系统资源扫描

• 磁盘空间：使用 df -h（Linux/macOS）或'此电脑'（Windows）检查 /var/lib/docker 所在分区空间是否释放。
• 网络端口：通过 netstat -tulpn（Linux）检查 Docker 默认端口（如 2375、2376）是否被占用。
• 内核模块：Linux 系统执行 lsmod | grep docker，无输出则无相关内核模块残留。

六、常见问题与解决方案

6.1 卸载后无法重装 Docker

问题：重装 Docker 时提示'已安装旧版本'或'配置冲突'。 解决方案：

1. 彻底删除残留文件：sudo rm -rf /var/lib/docker /etc/docker ~/.docker。

清理包管理器缓存：

# Ubuntu/Debian
sudo apt clean && sudo apt update
# CentOS/RHEL
sudo yum clean all && sudo yum makecache

6.2 WSL 2 集成残留导致冲突

问题：Windows 卸载 Docker 后，WSL 分发无法启动或提示'docker-desktop 未找到'。 解决方案：

# 重置 WSL
wsl --set-default-version 2
wsl --install -d Ubuntu
# 重新安装默认分发

6.3 权限错误：无法删除 /var/lib/docker

问题：Linux 执行 rm -rf /var/lib/docker 提示'Permission denied'。 解决方案：

1. 确认 Docker 服务已停止：sudo systemctl stop docker。

强制删除（需谨慎）：

sudo chattr -i /var/lib/docker/* # 移除文件 immutable 属性
sudo rm -rf /var/lib/docker

七、企业级批量卸载方案：Ansible 自动化脚本

对于企业环境中多节点 Docker 卸载需求，可使用 Ansible 实现批量操作。以下为 Linux 节点卸载 Docker 的 Ansible Playbook 示例：

- name: 彻底卸载 Docker
  hosts: all
  become: yes
  tasks:
    - name: 停止 Docker 服务
      systemd:
        name: "{{ item }}"
        state: stopped
        enabled: no
      loop:
        - docker
        - docker.socket
        - containerd.service
    - name: 卸载 Docker 包（Ubuntu/Debian）
      apt:
        name:
          - docker-ce
          - docker-ce-cli
          - containerd.io
          - docker-compose-plugin
        state: absent
        purge: yes
        autoremove: yes
      when: ansible_os_family == "Debian"
    - name: 卸载 Docker 包（CentOS/RHEL）
      yum:
        name:
          - docker-ce
          - docker-ce-cli
          - containerd.io
          - docker-compose-plugin
        state: absent
        autoremove: yes
      when: ansible_os_family == "RedHat"
    - name: 删除 Docker 残留文件
      file:
        path: "{{ item }}"
        state: absent
      loop:
        - /var/lib/docker
        - /var/lib/containerd
        - /etc/docker
        - /etc/default/docker
        - "{{ ansible_env.HOME }}/.docker"
    - name: 清理 Docker 网络规则
      command: "{{ item }}"
      loop:
        - ip link delete docker0
        - iptables -F
        - iptables -t nat -F
      ignore_errors: yes
      # 忽略网络设备不存在的错误

使用方法：

1. 将上述内容保存为 uninstall_docker.yml。
2. 执行命令：ansible-playbook -i inventory.ini uninstall_docker.yml（inventory.ini 为目标节点列表）。

八、总结：构建 Docker 卸载的'安全 checklist'

彻底卸载 Docker 需遵循'停止服务→移除组件→清理残留→验证结果'的流程，关键步骤包括：

1. 备份数据：卸载前导出重要镜像、容器和卷。
2. 分系统操作：根据 Linux、Windows、macOS 选择对应步骤，避免跨系统套用命令。
3. 深度清理：重点删除 /var/lib/docker（Linux）、WSL 分发（Windows）、~/.docker（全系统）等残留目录。
4. 验证卸载：通过命令检查、文件扫描和服务状态确认 Docker 完全移除。

通过本文方法，可确保 Docker 及其组件被彻底清理，为系统重装或工具切换扫清障碍。如需进一步学习，建议参考 Docker 官方文档的'Uninstall Docker'章节或容器引擎迁移指南（如 Docker 到 Podman 的平滑过渡方案）。