如何在ubuntu虚拟机中安装Docker容器

在 Ubuntu 虚拟机中安装与运行 Docker 的完整步骤

一 准备与系统检查

• 确认虚拟机已安装 Ubuntu Desktop/Server 并能正常上网，建议使用 Ubuntu 20.04/22.04/24.04。
• 查看系统版本与内核信息：
  • 查看版本：lsb_release -a
  • 查看内核：uname -r
• 更新索引并升级系统（可选但推荐）：
  • sudo apt update && sudo apt upgrade -y
• 安装常用工具（便于后续操作）：sudo apt install -y ca-certificates curl gnupg lsb-release

二 安装 Docker 引擎

• 推荐安装最新稳定版（方式一，GPG 写入 keyrings，更安全）
  1. 卸载旧版本（如有）：sudo apt remove -y docker.io docker-doc docker-compose* podman-docker containerd runc
  2. 安装依赖：sudo apt install -y ca-certificates curl gnupg lsb-release
  3. 添加 Docker 官方 GPG 密钥：curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  4. 添加 APT 源（自动匹配架构与版本代号）：

     echo "deb [arch=$(dpkg --print-architecture) 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
     

  5. 更新索引并安装：sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
• 备选方式（方式二，使用系统仓库，版本可能较旧）：sudo apt install -y docker.io docker-compose，随后可用 docker -v 查看版本

三 启动与验证

• 启动并设置开机自启：
  • sudo systemctl start docker
  • sudo systemctl enable docker
• 验证安装与运行状态：
  • 查看版本：docker version 或 docker -v
  • 查看服务状态：sudo systemctl status docker
  • 运行测试容器：sudo docker run --rm hello-world（看到 “Hello from Docker!” 即成功）

四 常用配置与优化

• 免 sudo 使用 Docker（将当前用户加入 docker 组，需重新登录生效）：
  • sudo usermod -aG docker $USER
• 配置镜像加速器（可选，提升拉取速度）
  • 新建或编辑 /etc/docker/daemon.json：

    {
      "registry-mirrors": [
        "https://docker.m.daocloud.io",
        "https://hub-mirror.c.163.com",
        "https://mirror.baidubce.com"
      ]
    }
    

  • 重启 Docker：sudo systemctl daemon-reload && sudo systemctl restart docker
  • 验证生效：sudo docker info | grep -A 10 'Registry Mirrors'
• 运行第一个应用容器（映射端口示例）
  • sudo docker run -d --name web -p 80:80 nginx
  • 在宿主机浏览器访问虚拟机的 IP 地址，应看到 Nginx 欢迎页

五 常见问题与排查

• apt 被占用报错（如 “Could not get lock …”）
  • 多见于并发包管理或异常退出，可等待锁释放或清理后重试：
    • sudo rm /var/cache/apt/archives/lock
    • sudo rm /var/lib/dpkg/lock*
    • 再执行 sudo apt update
• 旧版 GPG 添加方式弃用提示
  • 使用 signed-by 方式将密钥写入 /usr/share/keyrings/（见上文方式一步骤 3-4），避免 apt-key add 的 DEP 警告
• 运行 hello-world 失败
  • 确认 Docker 服务已启动：sudo systemctl status docker
  • 重启虚拟机后再试：sudo reboot，随后 sudo docker run --rm hello-world
• 拉取镜像很慢
  • 配置 registry-mirrors（见上文第四节），并重启 Docker 服务