Ubuntu 24.04 安装与维护 Docker 全指南
Docker 已成为现代软件开发和部署的核心工具，它通过容器化技术实现了应用程序的快速部署、测试和扩展。本文将详细介绍在 Ubuntu 24.04 系统上安装、配置和维护 Docker 的完整流程。
目录
1. 安装前准备
在安装 Docker 之前，建议执行以下操作确保系统环境最佳：
bash
# 更新系统包索引
sudo apt update
# 升级所有可更新的包
sudo apt upgrade -y
# 安装必要的依赖包
sudo apt install -y ca-certificates curl gnupg lsb-release apt-transport-https
如果之前安装过 Docker 相关的旧版本，建议先卸载：
bash sudo apt remove -y docker docker-engine docker.io containerd runc
2. Docker 安装步骤
2.1 添加 Docker 官方 GPG 密钥
bash
# 创建密钥存储目录
sudo mkdir -p /etc/apt/keyrings
# 下载并添加 Docker 官方 GPG 密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
2.2 设置 Docker 稳定版仓库
bash
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
2.3 安装 Docker 引擎
bash
# 更新包索引
sudo apt update
# 安装最新版本的 Docker 组件
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
2.4 验证安装是否成功
bash
# 运行 hello-world 容器测试
sudo docker run hello-world
如果安装成功，会看到类似以下的输出：
Hello from Docker! This message shows that your installation appears to be working correctly. ...
3. 基本配置
3.1 配置用户权限（可选）
默认情况下，只有 root 用户和 docker 组的用户可以运行 Docker 命令。
为了避免每次使用 Docker 都需要输入 sudo，可以将当前用户添加到 docker 组：
bash
# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER
# 刷新组权限（或注销并重新登录）
newgrp docker
3.2 配置 Docker 开机自启
bash
# 启用 Docker 服务开机自启
sudo systemctl enable docker
# 启动 Docker 服务
sudo systemctl start docker
3.3 配置镜像加速（可选）
如果访问 Docker Hub 速度较慢，可以配置国内镜像源加速：
bash
# 创建或编辑 Docker 配置文件
sudo nano /etc/docker/daemon.json
添加以下内容（使用适合你的镜像源）：
json {
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com",
"https://reg-mirror.qiniu.com" ]
}
重启 Docker 使配置生效：
bash
sudo systemctl daemon-reload
sudo systemctl restart docker
4. 常用命令
4.1 容器管理
bash
# 查看正在运行的容器
docker ps
# 查看所有容器（包括已停止的）
docker ps -a
# 启动一个容器
docker start [容器ID或名称]
# 停止一个容器
docker stop [容器ID或名称]
# 重启一个容器
docker restart [容器ID或名称]
# 删除一个容器
docker rm [容器ID或名称]
# 强制删除一个运行中的容器
docker rm -f [容器ID或名称]
4.2 镜像管理
bash
# 查看本地镜像
docker images
# 拉取镜像
docker pull [镜像名:标签]
# 删除镜像
docker rmi [镜像ID或名称]
# 清理悬空镜像
docker image prune
4.3 Docker 服务管理
bash
# 检查 Docker 服务状态
sudo systemctl status docker
# 启动 Docker 服务
sudo systemctl start docker
# 停止 Docker 服务
sudo systemctl stop docker
# 重启 Docker 服务
sudo systemctl restart docker
5. 日常维护
5.1 更新 Docker
bash
# 更新包索引
sudo apt update
# 升级 Docker 相关包
sudo apt upgrade -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
5.2 清理磁盘空间
Docker 运行一段时间后会产生大量的镜像、容器和数据卷，可以定期清理：
bash
# 清理未使用的数据（镜像、容器、网络）
docker system prune
# 清理包括未使用的卷在内的所有数据
docker system prune -a --volumes
5.3 查看 Docker 磁盘使用情况
bash
docker system df
5.4 备份与恢复
备份 Docker 镜像：
bash
# 保存镜像为tar文件
docker save -o [备份文件名.tar] [镜像名:标签]
# 加载备份的镜像
docker load -i [备份文件名.tar]
6. 卸载 Docker
如果需要完全卸载 Docker：
bash
# 停止所有运行中的容器
sudo docker stop $(sudo docker ps -aq)
# 删除所有容器
sudo docker rm $(sudo docker ps -aq)
# 删除所有镜像
sudo docker rmi $(sudo docker images -q)
# 卸载 Docker 包
sudo apt purge -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
# 删除相关文件
sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd sudo rm -rf /etc/apt/keyrings/docker.gpg sudo rm -rf /etc/apt/sources.list.d/docker.list
7. 常见问题解决
7.1 权限问题 如果遇到 “permission denied” 错误，通常是因为当前用户没有加入 docker 组：
bash
sudo usermod -aG docker $USER
newgrp docker
7.2 Docker 服务无法启动
检查服务状态并查看日志：
bash
sudo systemctl status docker
sudo journalctl -u docker
常见问题可能是配置文件错误，可以尝试重置配置：
bash
sudo mv /etc/docker/daemon.json /etc/docker/daemon.json.bak
sudo systemctl restart docker
7.3 镜像拉取失败
如果拉取镜像失败，可能是网络问题或镜像源问题：
- 检查网络连接
- 配置镜像加速（见 3.3 节）
- 尝试使用特定镜像源拉取：
docker pull registry.cn-hangzhou.aliyuncs.com/library/ubuntu:latest
— 通过本文的指南，你应该能够在 Ubuntu 24.04 系统上成功安装、配置和维护 Docker 环境。Docker 生态系统非常丰富，建议进一步学习 Docker Compose 进行多容器管理，以及 Docker Swarm 或 Kubernetes 进行容器编排。