424 字
2 分钟
Ubuntu 24.04 安装 Docker
Ubuntu 24.04 安装 Docker（官方 APT 源）
1. 适用环境
- 系统版本：
Ubuntu 24.04 LTS（noble） - 安装方式：Docker 官方
APT仓库 - 目标组件：
docker-ce、docker-ce-cli、containerd.io、docker-buildx-plugin、docker-compose-plugin
2. 卸载可能冲突的旧版本
如果机器上装过系统仓库里的旧 Docker 包，先清理：
for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove -y $pkgdone3. 添加 Docker 官方仓库
sudo apt-get updatesudo apt-get install -y ca-certificates curlsudo install -m 0755 -d /etc/apt/keyringssudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.ascsudo chmod a+r /etc/apt/keyrings/docker.asc
echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo \"${UBUNTU_CODENAME:-$VERSION_CODENAME}\") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update4. 安装 Docker Engine 与常用插件
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin5. 验证安装
sudo docker versionsudo docker run --rm swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io/library/hello-world:latestdocker compose version如果 hello-world 输出欢迎信息，说明 Docker Engine 工作正常。
6. 配置开机自启与免 sudo（可选但推荐）
sudo systemctl enable --now dockersudo usermod -aG docker $USERnewgrp docker验证当前用户是否可直接执行：
docker ps如果提示权限问题，退出当前终端重新登录一次再试。
7. 常见问题排查
7.1 apt-get update 报 GPG 或签名错误
重点检查这两个点：
/etc/apt/keyrings/docker.asc是否存在- 权限是否至少可读（
chmod a+r /etc/apt/keyrings/docker.asc）
7.2 运行 Docker 报 permission denied（/var/run/docker.sock）
通常是用户组尚未生效，重新登录会话后再执行 docker ps。
7.3 已发布端口但防火墙规则不符合预期
Docker 的端口发布规则会直接写入 iptables，如果你同时使用 ufw，需要额外检查防火墙策略与 DOCKER-USER 链。
8. 一句话总结
在 Ubuntu 24.04 上，推荐始终使用 Docker 官方 APT 仓库安装，流程是：清理旧包 -> 添加官方源 -> 安装引擎与插件 -> 验证与初始化权限。