ubuntu下安装docker engine的核心是使用官方apt仓库安装最新稳定版,需四步:卸载旧包(docker、docker.io等)、配置可信源(导入gpg密钥并添加适配发行版的仓库)、安装docker-ce及配套工具、启用服务并配置免sudo权限;全程命令行可复制执行,适配ubuntu 24.04(noble)及后续版本。
在 ubuntu 下安装 docker engine,核心是使用官方 apt 仓库安装最新稳定版,避免系统自带的老旧 docker.io 包。整个过程分四步:清理旧包、配置可信源、安装引擎、启用普通用户权限。操作全部基于命令行,可直接复制执行,适配 ubuntu 24.04(noble)及后续版本。
卸载可能冲突的旧版本
Ubuntu 自带或第三方安装的 docker 相关包(如 docker.io、docker-engine、containerd、runc)必须先清除,否则会与官方 Docker Engine 冲突:
- 运行以下命令一次性卸载常见旧包(无害,即使未安装也不会报错):
sudo apt remove -y docker docker-engine docker.io containerd runc - (可选)彻底清理残留数据和配置:
sudo rm -rf /var/lib/docker /var/lib/containerd
配置 Docker 官方 APT 源
跳过系统默认源,改用 Docker 官方仓库,确保获取最新稳定版(如 29.x 系列)并支持自动升级:
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境(极空间等),支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件,不暴露在代码中。
- 安装基础依赖:
sudo apt update && sudo apt install -y ca-certificates curl gnupg lsb-release apt-transport-https - 创建密钥目录并导入 GPG 密钥(用于验证软件包完整性):
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.asc
sudo 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 update
安装 Docker Engine 和配套工具
安装包含运行时、CLI、构建工具和 Compose 插件的一体化套件:
- 安装最新稳定版(推荐新手):
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - (生产环境可选)安装指定版本(例如 5:29.4.3-1~ubuntu.24.04~noble):
VERSION_STRING=5:29.4.3-1~ubuntu.24.04~noble
sudo apt install -y docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin
启动服务并配置免 sudo 权限
安装完成后需启用服务,并让当前用户无需每次加 sudo 才能使用 docker 命令:
- 启动 Docker 并设为开机自启:
sudo systemctl enable docker
sudo systemctl start docker - 将当前用户加入 docker 组:
sudo groupadd docker 2>/dev/null || true
sudo usermod -aG docker $USER - 立即生效(无需重启或登出):
newgrp docker - 验证是否成功:
docker run hello-world(首次会自动拉取镜像并输出欢迎信息)
docker version 和 docker compose version 查看组件版本










