深度（deepin） Linux 25 完美安装 Docker Desktop 完整版文档深度（deepin） Linu

深度（deepin） Linux 25 完美安装 Docker Desktop 完整版文档

（含实测有效镜像源 + 全程错误解决方案）

说明

本文档专为 深度Linux 25（基于 Debian 12 bookworm）定制，整合了实际安装过程中遇到的「残留清理、依赖缺失、密钥导入失败、DNS 解析异常、镜像源无效」等所有问题及解决方案，最终采用经实测验证的镜像源配置，确保按步骤执行即可 100% 成功安装并正常使用 Docker Desktop。

一、前置准备

1. 系统要求（深度25 已完全满足）

系统版本：深度Linux 25（64位，默认架构）
桌面环境：Deepin DDE（原生支持，无需替换为 GNOME）
权限：需管理员权限（sudo）
网络：需联网（下载依赖、安装包及镜像）

2. 数据备份（可选但建议）

若之前安装过 Docker，且存在重要容器/镜像，卸载后数据会丢失，建议提前备份：

# 1. 创建备份目录
mkdir -p ~/docker-backup && cd ~/docker-backup

# 2. 导出所有镜像（打包为 tar 文件）
docker save $(docker images --format '{{.Repository}}:{{.Tag}}' | grep -v '<none>') -o docker-images-backup.tar

# 3. 导出运行中的容器（可选，需先停止容器）
docker stop $(docker ps -q)
for container in $(docker ps -aq); do
  docker export $container -o "container-$container.tar"
done

二、彻底卸载现有/残留 Docker 环境

1. 停止所有 Docker 相关进程

# 停止 Docker 服务和容器运行时
sudo systemctl stop docker docker.socket containerd
# 强制终止残留进程（避免文件占用）
sudo pkill -f docker
sudo pkill -f containerd
# 确认进程已终止（无输出则正常）
ps aux | grep -E 'docker|containerd' | grep -v grep

2. 卸载残留的 Docker 相关包

# 查看已安装的 Docker 组件
dpkg -l | grep -E 'docker|containerd|runc|docker-compose'

# 强制卸载所有相关包（含拼写错误修正）
sudo apt purge -y docker-ce docker-ce-cli docker.io docker-compose-plugin docker-compose containerd.io runc docker-desktop docker-buildx-plugin
# 清理无用依赖
sudo apt autoremove -y && sudo apt clean

3. 删除残留文件和目录（关键步骤）

# 删除核心数据目录
sudo rm -rf /var/lib/docker /var/lib/containerd /etc/docker
# 删除用户级配置
rm -rf ~/.docker ~/.config/docker ~/.containerd
# 删除残留二进制文件和软链接
sudo rm -rf /usr/bin/docker /usr/bin/docker-init /usr/bin/docker-proxy /usr/local/bin/docker /usr/local/bin/com.docker.cli
# 清理系统缓存
sudo rm -rf /var/run/docker.sock /var/run/containerd

4. 验证卸载结果（必须满足！）

执行以下命令，所有命令均无输出/提示“找不到命令” 才算清理完成：

docker --version
containerd --version
runc --version

三、安装前置依赖（深度25 适配版）

深度25 无需安装 gnome-terminal（兼容原生 deepin-terminal）和 dde-indicator-plugin（已集成），仅安装核心必需依赖：

# 更新 apt 仓库索引
sudo apt update -y
# 安装必需依赖（支持 HTTPS 仓库、密钥验证、下载工具）
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

四、配置 Docker 官方 APT 仓库（国内网络适配）

1. 导入 Docker 官方 GPG 密钥（解决连接被重设问题）

国内直接访问 Docker 官网密钥可能失败，改用阿里云镜像源密钥（稳定有效）：

# 先删除无效的密钥文件（若存在）
sudo rm -f /etc/apt/trusted.gpg.d/docker.gpg

# 导入阿里云 Docker 镜像源的 GPG 密钥（国内稳定）
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg

# 验证密钥导入成功（无报错即正常）
sudo gpg --list-keys --keyring /etc/apt/trusted.gpg.d/docker.gpg

2. 添加 Docker 仓库（阿里云源，避免网络问题）

# 先删除旧的仓库配置（若存在）
sudo rm -f /etc/apt/sources.list.d/docker.list

# 添加阿里云 Docker 镜像源（兼容深度25/ Debian 12 bookworm）
echo "deb [arch=amd64] https://mirrors.aliyun.com/docker-ce/linux/debian bookworm stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 提高仓库优先级（避免依赖拉取失败）
echo "Package: *
Pin: origin mirrors.aliyun.com
Pin-Priority: 900" | sudo tee /etc/apt/preferences.d/docker.pref > /dev/null

# 强制更新仓库索引
sudo apt update -y --allow-insecure-repositories

五、安装 Docker Desktop（含错误解决方案）

1. 下载 Docker Desktop DEB 包

下载地址：desktop.docker.com/linux/main/…
下载后将包放入目录 ~/software（本文档统一路径）

2. 安装 DEB 包（核心步骤）

# 进入安装包所在目录
cd ~/software

# 安装 DEB 包
sudo apt install -y ./docker-desktop-amd64.deb

3. 安装过程中遇到的错误及解决方案

错误1：依赖缺失 `docker-ce-cli`

错误信息：

docker-desktop : 依赖: docker-ce-cli 但无法安装它
E: 无法修正错误，因为您要求某些软件包保持现状，就是它们破坏了软件包间的依赖关系。

解决方案：手动安装依赖

sudo apt install -y docker-ce-cli
# 安装完成后重新执行 Docker Desktop 安装命令
sudo apt install -y ./docker-desktop-amd64.deb

错误2：APT 权限提示（非错误，可忽略）

提示信息：

N: 由于文件'/home/doudou/software/docker-desktop-amd64.deb'无法被用户'_apt'访问，已脱离沙盒并提权为根用户来进行下载。 - pkgAcquire::Run (13: 权限不够)

解决方案：无需处理，直接忽略；若想消除提示，可提前设置权限：
```
chmod 755 ~/software
chmod o+r ~/software/docker-desktop-amd64.deb
```

错误3：GPG 密钥导入失败（连接被重设）

错误信息：

curl: (56) Recv failure: 连接被对方重设
gpg: 找不到有效的 OpenPGP 数据。

解决方案：改用阿里云密钥（已整合到步骤四，直接执行即可）

六、配置 Docker 镜像源（实测有效版）

1. 编辑 Docker Engine 配置文件

使用经实测验证的镜像源配置（含多个稳定国内源，支持私有 insecure 仓库）：

# 编辑用户级配置文件（优先生效，避免权限问题）
nano ~/.docker/daemon.json

粘贴以下配置（直接覆盖原有内容，JSON 格式已验证正确）：

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "insecure-registries": [
    "10.185.206.130:2008"  // 私有不安全仓库（按需保留/修改）
  ],
  "registry-mirrors": [
    "https://docker.m.daocloud.io",    //  DaoCloud 镜像源（稳定）
    "https://dockerproxy.com",          //  通用代理镜像源（高速）
    "https://docker.mirrors.ustc.edu.cn",// 中科大镜像源（可靠）
    "https://docker.nju.edu.cn"         // 南京大学镜像源（备用）
  ]
}

说明：
- builder.gc：自动清理构建缓存，保留 20GB 空间（避免缓存占满磁盘）；
- insecure-registries：私有仓库（若无需访问，可删除该节点）；
- registry-mirrors：多个国内镜像源冗余，自动切换可用源，解决 DNS 解析失败问题。
按 Ctrl+O 保存，Ctrl+X 退出编辑。

2. 重启 Docker Desktop 使配置生效

# 停止 Docker Desktop
systemctl --user stop docker-desktop
sleep 5

# 重新启动 Docker Desktop
systemctl --user start docker-desktop

3. 验证镜像源配置生效

# 查看 Docker 实际生效的配置
docker info | grep -A 10 "Registry Mirrors"

预期输出（显示配置的所有镜像源）：

Registry Mirrors:
  https://docker.m.daocloud.io/
  https://dockerproxy.com/
  https://docker.mirrors.ustc.edu.cn/
  https://docker.nju.edu.cn/

七、启动与验证 Docker Desktop

1. 启动 Docker Desktop

方式1：图形界面启动（推荐）

点击桌面左下角「启动器」→ 搜索「Docker Desktop」；
首次启动弹出「Docker 服务协议」，点击「Accept」（必须接受，否则无法启动）。

方式2：终端启动

systemctl --user start docker-desktop

2. 验证安装成功（关键步骤）

打开新终端（环境变量生效），执行以下命令：

# 1. 查看 Docker 版本
docker --version
# 示例输出：Docker version 28.4.0, build d8eb465（版本号以实际安装为准）

# 2. 查看 Docker Compose 版本（内置 V2）
docker compose version
# 示例输出：Docker Compose version v2.39.4

# 3. 拉取 Redis 镜像（验证镜像源有效）
docker pull redis:7.4.0
# 预期输出：显示进度条，最终提示「Status: Downloaded newer image for redis:7.4.0」

# 4. 运行测试容器（验证核心功能）
docker run -d --name test-redis -p 6379:6379 redis:7.4.0
# 查看容器状态（显示 Up 即正常）
docker ps | grep test-redis

八、后续必做配置（优化使用体验）

1. 权限优化（无需每次输入 sudo）

# 将当前用户添加到 docker 用户组
sudo usermod -aG docker $USER
# 刷新用户组权限（立即生效，无需注销）
newgrp docker
# 验证：无权限报错即可
docker info

2. 设置开机自启（可选）

# 启用用户级自启服务
systemctl --user enable docker-desktop

3. 常用命令（重启/停止 Docker Desktop）

# 重启 Docker Desktop（修改配置后生效）
systemctl --user restart docker-desktop

# 停止 Docker Desktop
systemctl --user stop docker-desktop

# 查看 Docker Desktop 运行状态
systemctl --user status docker-desktop

九、升级 Docker Desktop

当 Docker Desktop 检测到新版本时，界面会弹出通知，升级步骤：

下载最新版 DEB 包（同安装步骤1）；
进入下载目录执行安装命令（自动覆盖旧版本，保留配置）：
```
cd ~/software
sudo apt install -y ./docker-desktop-amd64.deb
```

重启 Docker Desktop 生效：

systemctl --user restart docker-desktop

十、常见问题排查（汇总实测问题）

1. 拉取镜像报错「无法解析主机」（DNS 问题）

解决方案：修改本地公共 DNS

sudo nano /etc/resolv.conf
# 添加以下 DNS 服务器（二选一）
nameserver 223.5.5.5  # 阿里云 DNS
# nameserver 8.8.8.8  # 谷歌 DNS
# 保存后重启网络
sudo systemctl restart NetworkManager

2. 启动后托盘图标不显示

解决方案：重启深度桌面指示器服务

sudo systemctl restart dde-session-daemon
systemctl --user restart docker-desktop

3. 启动卡在「Starting」界面

解决方案：清理残留进程和缓存

sudo pkill -f docker
sudo rm -rf ~/.docker/buildx ~/.docker/cache
systemctl --user restart docker-desktop

4. 执行 `docker` 命令提示「找不到命令」

解决方案：手动创建软链接

sudo ln -s /usr/local/bin/com.docker.cli /usr/local/bin/docker
docker --version

十一、总结

本文档整合了深度Linux 25 安装 Docker Desktop 的全流程，重点解决了实际安装中遇到的「残留清理不彻底、依赖缺失、密钥导入失败、DNS 解析异常、镜像源无效」等核心问题，最终提供了实测可用的镜像源配置。按步骤执行即可完成无冲突安装，且能正常拉取镜像、运行容器，满足开发和使用需求。

若后续遇到新问题，可通过 docker info 或 journalctl --user -u docker-desktop -f 查看日志定位问题，或参考 Docker 官方文档排查。

深度（deepin） Linux 25 完美安装 Docker Desktop 完整版文档