Ubuntu From Scratch如何安装Docker

Ubuntu 最小化环境安装 Docker 的实操指南

前置说明与准备

• 本指南面向从最小化安装起步的 Ubuntu（无桌面、仅命令行），目标是安装并运行 Docker Engine（社区版）。
• 准备事项：
  • 架构为 amd64（如 x86_64）；其他架构需替换相应仓库与包。
  • 至少具备 sudo 权限与可用的网络访问。
  • 建议先更新索引并安装基础工具：sudo apt-get update && sudo apt-get install -y ca-certificates curl gnupg lsb-release
  • 可选：卸载旧版组件以避免冲突：sudo apt-get remove -y docker docker-engine docker.io containerd runc。

方法一 APT 仓库安装（推荐）

• 步骤概览：
  1. 安装依赖：sudo apt-get update && sudo apt-get install -y apt-transport-https ca-certificates curl gnupg lsb-release
  2. 导入官方 GPG 密钥：curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  3. 添加 Docker APT 源（使用推荐的 signed-by 方式）：

     echo \
       "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
       $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
     

  4. 安装引擎与组件：sudo apt-get update && sudo apt-get install -y docker-ce docker-ce-cli containerd.io
  5. 启动与开机自启：sudo systemctl start docker && sudo systemctl enable docker
  6. 验证安装：
     • 查看版本：docker --version
     • 运行测试容器：sudo docker run --rm hello-world
• 说明：上述步骤覆盖从仓库添加、签名校验到服务启动与验证的完整链路，适合最小化系统的标准安装方式。

方法二 官方安装脚本一键安装

• 适合快速部署与测试环境：
  1. 下载并执行脚本：curl -fsSL https://get.docker.com -o get-docker.sh && sudo sh get-docker.sh
  2. 启动服务：sudo systemctl start docker && sudo systemctl enable docker
  3. 验证：docker --version 与 sudo docker run --rm hello-world
• 提示：脚本会安装最新稳定版，生产环境仍建议优先使用 APT 仓库方式以便可控升级与审计。

安装后的必要配置

• 以非 root 用户运行 Docker（推荐）：
  • 将当前用户加入 docker 组：sudo usermod -aG docker $USER
  • 生效方式：注销并重新登录，或执行 newgrp docker
  • 验证：docker info（无需 sudo 应可正常输出）
• 镜像加速（可选，提升国内拉取速度）：

  sudo mkdir -p /etc/docker
  sudo tee /etc/docker/daemon.json <<-'EOF'
  {
    "registry-mirrors": ["https://<你的加速器地址>.mirror.aliyuncs.com"]
  }
  EOF
  sudo systemctl restart docker
  

• 常用管理命令：
  • 查看状态：sudo systemctl status docker
  • 开机自启：sudo systemctl enable docker
  • 拉取与运行：docker pull ubuntu，docker run -it --rm ubuntu bash。

常见问题与排查

• 无法找到包或签名错误：确认已正确导入 GPG 密钥并使用 signed-by 的 APT 源；执行 sudo apt-get update 后再安装。
• 命令需 sudo：未将用户加入 docker 组或会话未重新加载；执行 sudo usermod -aG docker $USER 并重新登录。
• 服务未启动：使用 sudo systemctl start docker 启动；若失败，查看 sudo systemctl status docker 与 journalctl -u docker 的日志定位问题。
• 拉取镜像慢或超时：配置国内镜像加速器（见上文），再重启 Docker 服务。