QCMS 智慧中枢

Ubuntu 安装 Docker 最全教程(最新)

分类:技术分享 时间:2025-12-05 阅读数: 27

简介:本文根据多篇权威文档与最新实践整理,详细介绍如何在 Ubuntu 系统中正确、完整地安装 Docker。内容涵盖卸载旧版本、安装依赖、添加 GPG 密钥、配置官方源、安装 Docker、镜像加速以及常见错误解决方法,适用于 Ubuntu 18.04 / 20.04 / 22.04 等版本。


一、卸载旧版本(可选)

如果你的系统之前安装过旧版 Docker,建议先卸载以避免冲突:

sudo apt-get remove docker docker-engine docker.io containerd runc

 

二、安装依赖包

更新软件包并安装必要依赖:

sudo apt update
sudo apt install -y \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg \
    lsb-release \
    software-properties-common

 

三、添加 Docker 官方 GPG 密钥

确保软件包来源可信:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

 

四、添加 Docker 软件源

方法 1:通用写法(自动识别架构与版本)

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

 

方法 2:手动指定版本(例如 Ubuntu 22.04)

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

 

五、更新软件源

sudo apt update

 

六、安装 Docker

安装最新版 Docker 引擎、CLI 及容器运行时:

sudo apt install -y docker-ce docker-ce-cli containerd.io

 

如果你需要 Docker Compose 插件,可额外安装:(这个我还没搞明白所以没有安装)

sudo apt install -y docker-buildx-plugin docker-compose-plugin

 

七、启动并启用 Docker 服务

sudo systemctl start docker
sudo systemctl enable docker

 

八、验证安装

查看版本:

sudo docker version

输出应包含客户端(Client)和服务端(Server)版本信息,如:

Client: Docker Engine - Community
 Version:           24.0.7
 ...
Server: Docker Engine - Community
 Engine:
  Version:          24.0.7

 

运行测试容器:

sudo docker run hello-world

若看到 Hello from Docker!,表示安装成功。

 

九、可选配置

1. 允许非 sudo 运行 Docker

sudo usermod -aG docker $USER

 

2. 配置国内镜像加速 (这一段非常重要,不然run hello-world我一直不成功,一直卡在那边)

创建或编辑 /etc/docker/daemon.json

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://mirror.baidubce.com",
    "https://docker.m.daocloud.io",
    "https://hub-mirror.c.163.com"
  ]
}
EOF

重启 Docker:

sudo systemctl restart docker

 

常见问题解决

 

1. Package 'docker-ce' has no installation candidate

  • 检查是否是低版本 Ubuntu,如 18.04 需要使用 bionic。
  • 检查源是否配置正确。

可换为阿里云源:

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

 

2. 网络超时

检查网络,必要时关闭防火墙测试:

sudo ufw disable

通过以上步骤,您即可在 Ubuntu 系统中成功安装 Docker,如需深入学习镜像管理、容器编排(Compose、Swarm、K8s)等内容,建议参考官方文档或持续关注本站的后续文章。

热门文章
acme.sh 自动部署与自动续签 SSL 证书完整教程 Linux 下 rsync daemon 完整部署教程(从安装到同步) acme.sh 证书在小程序无法访问的解决方案(ERR_SSL_VERSION_OR_CIPHER_MISMATCH) Ubuntu 安装 Docker 最全教程(最新) 常用 Docker 命令与实用案例整理(镜像管理、容器管理、部署示例)

相关模板推荐

域名授权查询

输入您的网址查询是否授权