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版（适配极空间）

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 查看组件版本