简介:本文根据多篇权威文档与最新实践整理,详细介绍如何在 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确保软件包来源可信:
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg方法 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/nullsudo apt update安装最新版 Docker 引擎、CLI 及容器运行时:
sudo apt install -y docker-ce docker-ce-cli containerd.io
如果你需要 Docker Compose 插件,可额外安装:(这个我还没搞明白所以没有安装)
sudo apt install -y docker-buildx-plugin docker-compose-pluginsudo 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
可换为阿里云源:
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)等内容,建议参考官方文档或持续关注本站的后续文章。
输入您的网址查询是否授权