debian系统安装docker的核心是正确配置软件源、导入密钥、安装服务并设置权限。需先更新系统、确认架构与发行代号，再创建keyrings目录、下载安装gpg密钥、写入源地址，随后更新并安装docker-ce等组件，启动服务并设为开机自启，最后将用户加入docker组以免sudo执行，验证运行hello-world容器成功。

Debian 系统安装 Docker 的核心是**正确配置软件源、导入密钥、安装服务并设置权限**。整个过程不复杂，但几个关键点配错会导致 apt 报错或无法拉镜像。

确保系统基础就绪

Debian 11（Bullseye）及以上版本都支持；低于 Debian 10（Buster）需谨慎，部分仓库已停止维护。先更新系统：

• sudo apt update && sudo apt upgrade -y
• 确认系统架构：运行 dpkg --print-architecture（通常是 amd64 或 arm64）
• 检查发行代号：运行 lsb_release -cs（如 bookworm、trixie）——后续会用到

添加 Docker 官方源和密钥

推荐使用 keyrings 目录方式（比旧版 apt-key 更安全）：

• 创建密钥目录：sudo mkdir -p /etc/apt/keyrings
• 下载并安装 GPG 密钥：curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
• 设置密钥权限：sudo chmod a+r /etc/apt/keyrings/docker.gpg
• 写入源地址（注意把 debian 和 $(lsb_release -cs) 替换为真实值）：
  echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装并启用 Docker 服务

完成源配置后，执行安装：

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• sudo apt update
• sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
• 启动服务：sudo systemctl start docker
• 设为开机自启：sudo systemctl enable docker

让普通用户免 sudo 使用 Docker

默认只有 root 或 docker 组成员能执行 docker 命令：

• 将当前用户加入 docker 组：sudo usermod -aG docker $USER
• 立即生效需重新登录终端（或运行 newgrp docker 临时切换组）
• 验证：docker run hello-world —— 不报 permission denied 即成功

国内加速可选配置（非必需但实用）

如果 docker pull 极慢，可配置镜像加速器：

• 创建 daemon 配置：sudo mkdir -p /etc/docker
• 写入阿里云镜像源（或其他如清华源）：
  sudo tee /etc/docker/daemon.json { "registry-mirrors": ["https://yxzrazem.mirror.aliyuncs.com"] }
  EOF
• 重载并重启：sudo systemctl daemon-reload && sudo systemctl restart docker