Ubuntu安装Docker引擎
安装Docker引擎
一、注意事项
-
防火墙兼容性
- 若使用
ufw
或firewalld
,Docker 容器端口会绕过防火墙规则。建议通过iptables
或ip6tables
配置防火墙,并将规则添加到DOCKER-USER
链。 - 仅支持
iptables-nft
和iptables-legacy
,不支持nft
规则。
- 若使用
-
系统要求
-
支持的 Ubuntu 版本:
- Ubuntu24.10(Oracular)
- Ubuntu24.04(Noble LTS)
- Ubuntu22.04(Jammy LTS)
- Ubuntu20.04(Focal LTS)
-
支持的架构:
x86_64/amd64
,armhf
,arm64
,s390x
,ppc64le
-
非官方支持:Linux Mint 等衍生版本可能不兼容。
-
二、卸载旧版本
-
卸载冲突软件包
sudo apt-get remove docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc
-
若已安装过 Docker,需清理数据(谨慎操作):
sudo rm -rf /var/lib/docker # 删除所有镜像、容器、卷 sudo rm -rf /var/lib/containerd
-
三、安装 Docker 引擎
方法一:通过 APT 仓库安装
-
添加 Docker 官方仓库
sudo apt-get update sudo apt-get install ca-certificates curl sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc sudo chmod a+r /etc/apt/keyrings/docker.asc echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \ https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null sudo apt-get update
-
安装 Docker 包
-
安装最新版本:
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
-
安装指定版本:
apt-cache madison docker-ce # 列出可用版本 sudo apt-get install docker-ce=<VERSION> docker-ce-cli=<VERSION> containerd.io docker-buildx-plugin docker-compose-plugin
-
方法二:手动下载 DEB 包安装
-
访问 Docker 下载页面,选择对应版本和架构,下载以下包:
-
containerd.io_<version>_<arch>.deb
-
docker-ce_<version>_<arch>.deb
-
docker-ce-cli_<version>_<arch>.deb
-
docker-buildx-plugin_<version>_<arch>.deb
-
docker-compose-plugin_<version>_<arch>.deb
-
-
安装 DEB 包
sudo dpkg -i ./containerd.io_<version>_<arch>.deb \ ./docker-ce_<version>_<arch>.deb \ ./docker-ce-cli_<version>_<arch>.deb \ ./docker-buildx-plugin_<version>_<arch>.deb \ ./docker-compose-plugin_<version>_<arch>.deb
方法三:使用便捷脚本安装(仅测试环境)
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
- 风险提示:自动安装最新版本,可能引入不稳定依赖,不建议生产环境使用。
四、验证安装
sudo docker run hello-world
- 若输出
Hello from Docker!
表示安装成功。
五、配置非 Root 用户权限
-
添加用户到
docker
组sudo usermod -aG docker $USER newgrp docker # 刷新组权限
-
验证非 Root 权限
docker run hello-world # 无需 sudo
六、卸载 Docker
-
卸载软件包
sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-ce-rootless-extras
-
删除数据及配置
sudo rm -rf /var/lib/docker sudo rm -rf /var/lib/containerd sudo rm /etc/apt/sources.list.d/docker.list sudo rm /etc/apt/keyrings/docker.asc
七、升级 Docker
- APT 方式:
sudo apt-get update && sudo apt-get upgrade
- 手动安装:下载新版 DEB 包重复安装步骤。
参考链接:
Docker 官方文档 - Ubuntu 安装指南https://docs.docker.com/engine/
本文当参考的是