1. 准备工作与环境检查在开始安装Docker之前我们需要确保Debian系统已经做好了充分的准备。很多新手容易忽略这一步结果在后续安装过程中遇到各种奇怪的问题。我自己第一次在Debian上安装Docker时就踩过这个坑当时因为没更新系统直接安装结果出现了依赖冲突。首先让我们更新系统已有的软件包列表。这个步骤相当于去超市购物前先确认货架上的商品清单是否最新sudo apt update接下来升级所有可升级的已安装软件包。这就像把家里所有旧家具都换成最新款避免新家具Docker和旧家具系统组件不兼容sudo apt upgrade -y重要提示如果你的Debian系统是新安装的可能缺少一些基础工具。我建议安装以下工具包它们会在后续步骤中派上用场sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release software-properties-common这些工具的作用分别是apt-transport-https允许apt通过HTTPS协议与仓库通信ca-certificates让系统能够识别和信任CA颁发的SSL证书curl用于从网络下载文件gnupg处理GPG密钥的工具lsb-release提供标准的LSBLinux标准基础信息software-properties-common管理软件仓库的工具2. 处理旧版本Docker与冲突软件很多人在安装新版本Docker时遇到问题往往是因为系统里已经存在旧版本或其他容器运行时。就像你不能同时穿两双鞋一样系统也不能同时运行多个容器引擎。首先让我们检查系统是否已经安装了旧版Docker或其他容器软件dpkg -l | grep -E docker|containerd|podman如果发现有任何已安装的相关软件应该先卸载它们。我推荐使用以下命令彻底清理sudo apt remove -y docker docker-engine docker.io containerd runc podman-docker有时候仅仅使用remove是不够的残留的配置文件可能会影响新版本安装。为了彻底清理可以加上purge参数sudo apt purge -y docker-ce docker-ce-cli containerd.io最后别忘了清理可能残留的文件sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd特别注意如果你之前尝试过安装Docker但失败了这些清理步骤尤为重要。我曾经遇到过因为残留文件导致新安装的Docker无法正常启动的情况。3. 添加Docker官方GPG密钥GPG密钥相当于Docker官方的数字签名用来验证下载的软件包是否真实可信。没有正确的密钥系统会拒绝安装Docker这是Debian的安全机制。添加密钥的标准方法是curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg这个命令做了以下几件事从Docker官网下载GPG密钥使用gpg --dearmor命令转换密钥格式将密钥保存到系统密钥环目录常见问题如果你在国内可能会遇到下载速度慢或连接超时的情况。这时可以考虑使用国内镜像源的密钥curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg验证密钥是否添加成功sudo gpg --list-keys --keyring /usr/share/keyrings/docker-archive-keyring.gpg你应该能看到Docker的发布密钥信息包括指纹9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88。4. 配置Docker的APT仓库有了密钥后我们需要告诉系统从哪里获取Docker软件包。这一步就像给手机添加一个新的应用商店。首先确定你的Debian版本代号lsb_release -cs根据输出结果如bookworm、bullseye等创建Docker的仓库配置文件echo \ deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/docker-archive-keyring.gpg] \ https://download.docker.com/linux/debian \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null重要提示如果你的Debian是衍生版本如Kali Linuxlsb_release -cs可能返回不兼容的代号。这时需要手动替换为对应的Debian代号比如Kali通常使用Debian的testing仓库。对于国内用户建议使用国内镜像加速下载echo \ deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/docker-archive-keyring.gpg] \ https://mirrors.aliyun.com/docker-ce/linux/debian \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null更新APT包索引确保系统能识别新添加的仓库sudo apt update验证Docker仓库是否配置正确apt-cache policy docker-ce正确的输出应该显示来自Docker官方仓库的版本信息而不是Debian自带的旧版本。5. 安装Docker引擎现在终于到了安装Docker的核心步骤。我们将安装Docker引擎及其相关组件sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin这个命令安装了以下组件docker-ceDocker社区版引擎docker-ce-cliDocker命令行工具containerd.io容器运行时docker-buildx-plugin构建多平台镜像的插件docker-compose-plugin容器编排工具安装选项如果你想安装特定版本的Docker可以先查看可用版本apt-cache madison docker-ce然后指定版本安装sudo apt install -y docker-ceVERSION docker-ce-cliVERSION containerd.io安装完成后启动Docker服务并设置开机自启sudo systemctl enable --now docker验证Docker是否正常运行sudo docker run hello-world如果看到Hello from Docker!的欢迎信息说明安装成功。我第一次看到这个信息时感觉就像收到了来自技术世界的一封情书。6. 解决常见安装错误即使按照上述步骤操作你仍可能遇到一些问题。下面是一些常见错误及其解决方案6.1 GPG密钥添加失败错误现象在执行apt update时出现NO_PUBKEY或GPG error。解决方案删除现有密钥sudo rm /usr/share/keyrings/docker-archive-keyring.gpg重新添加密钥可以尝试不同的镜像源更新软件包列表sudo apt update6.2 仓库源配置错误错误现象apt update时出现404 Not Found或Release file not found。原因通常是因为Debian版本代号不正确。解决方案确认你的Debian版本cat /etc/os-release编辑仓库配置文件sudo nano /etc/apt/sources.list.d/docker.list将版本代号改为正确的Debian代号如bullseye、bookworm等再次更新sudo apt update6.3 依赖冲突错误现象安装时出现dependency problems或unmet dependencies。解决方案尝试修复依赖关系sudo apt --fix-broken install如果问题依旧可以尝试安装特定版本的依赖包作为最后手段可以尝试sudo apt full-upgrade6.4 权限问题错误现象执行docker命令时出现Got permission denied。解决方案 将当前用户加入docker组sudo usermod -aG docker $USER然后退出当前终端会话重新登录或者执行newgrp docker安全提示docker组实际上等同于root权限因此只应该将可信用户加入此组。7. 配置优化与后续步骤安装完成后我们可以进行一些优化配置让Docker更好用。7.1 配置国内镜像加速国内用户可能会发现拉取镜像速度很慢可以配置国内镜像加速器sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://你的镜像加速器地址] } EOF sudo systemctl restart docker常用的国内镜像加速器包括阿里云https://你的ID.mirror.aliyuncs.com腾讯云https://mirror.ccs.tencentyun.com中科大https://docker.mirrors.ustc.edu.cn7.2 配置日志轮转默认情况下Docker容器日志会不断增长可能占用大量磁盘空间。我们可以配置日志轮转sudo tee /etc/docker/daemon.json -EOF { log-driver: json-file, log-opts: { max-size: 10m, max-file: 3 } } EOF sudo systemctl restart docker这样配置后每个容器日志文件最大为10MB最多保留3个文件。7.3 安装Docker Compose虽然我们已经安装了docker-compose-plugin但如果你习惯使用独立的Docker Compose可以这样安装DOCKER_CONFIG${DOCKER_CONFIG:-$HOME/.docker} mkdir -p $DOCKER_CONFIG/cli-plugins curl -SL https://github.com/docker/compose/releases/latest/download/docker-compose-linux-x86_64 -o $DOCKER_CONFIG/cli-plugins/docker-compose chmod x $DOCKER_CONFIG/cli-plugins/docker-compose验证安装docker compose version8. 验证与测试完成所有安装和配置后我们应该全面验证Docker是否正常工作。8.1 检查Docker服务状态sudo systemctl status docker正常状态应该是active (running)。8.2 检查Docker版本信息docker version docker info这两个命令会显示详细的版本信息和系统配置。8.3 运行测试容器docker run -d -p 80:80 nginx然后访问http://localhost应该能看到Nginx的欢迎页面。8.4 检查容器日志docker logs 容器ID8.5 清理测试容器docker stop 容器ID docker rm 容器ID通过这些测试你可以确认Docker已经完全安装配置成功可以开始你的容器化之旅了。