在 Ubuntu 22.04 (Jammy Jellyfish) 上安装 Docker,目前最稳妥、也是官方推荐的做法是通过 Docker 官方 APT 仓库进行安装。
为什么不建议直接用 apt install docker.io?
因为 Ubuntu 自带的 docker.io 包版本通常较老,且更新滞后。而使用官方源安装的 docker-ce (Community Edition) 能确保你拿到的是最新稳定版,驱动和内核兼容性也更好。
以下是生产环境常用的标准流程,步骤清晰,无废话。
前置检查:确认系统环境
- 架构确认:Docker 仅支持 64 位系统。
uname -m # 输出应为 x86_64 或 aarch64 (ARM) - 权限要求:后续所有命令需要
sudo权限。 - 清理旧版本(如果之前装过):
sudo apt-get remove docker docker-engine docker.io containerd runc注意:这不会删除镜像、容器和数据卷,但为了干净起见,建议先备份重要数据。
第一步:更新包索引并安装依赖
Docker 的 APT 仓库需要通过 HTTPS 访问,所以需要先安装必要的传输层安全工具。
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release
第二步:添加 Docker 官方 GPG 密钥
为了防止中间人攻击和确保下载包的真实性,必须导入 Docker 的官方签名密钥。
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
提示:国内网络有时连接
download.docker.com较慢,如果超时,可以考虑配置镜像提速或使用XX,但请确保来源可信。
第三步:设置 Docker APT 仓库
我们需要告诉 apt 去哪里下载 Docker 软件包。Ubuntu 22.04 的代码名是 jammy。
echo
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
执行完后,可以检查一下文件内容是否正确:
cat /etc/apt/sources.list.d/docker.list
第四步:安装 Docker Engine
再次更新包索引,然后安装最新的 Docker 引擎组件。
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
这里安装了四个核心组件:
docker-ce: Docker 引擎本身。docker-ce-cli: 命令行客户端。containerd.io: 容器运行时标准实现。docker-compose-plugin: 用于运行docker compose命令(V2 版本,替代了旧的独立二进制包)。
第五步:验证安装
安装完成后,Docker 服务通常会自动启动。我们可以直接运行一个测试容器来验证。
sudo docker run hello-world
如果看到类似以下的输出,说明安装成功:
Hello from Docker!
This message shows that your installation appears to be working correctly.
...
第六步:非 root 用户管理 Docker(可选但推荐)
默认情况下,只有 root 用户或 docker 组的成员才能运行 Docker 命令。如果你不想每次都要敲 sudo,可以将你的用户名加入 docker 组。
- 创建
docker组(如果不存在):sudo groupadd docker - 将当前用户加入该组:
sudo usermod -aG docker $USER - 注销并重新登录,或者重启服务器,使组更改生效。
- 验证:
docker ps # 无需 sudo 即可列出正在运行的容器
常见问题与避坑指南
1. 关于 Systemd 和 cgroup
Ubuntu 22.04 默认使用 systemd 作为初始化系统,并且推荐使用 cgroup v2。Docker 20.10+ 已经很好地支持了 cgroup v2。如果你的内核非常老旧或者手动禁用了 systemd,可能会遇到兼容性问题。保持默认配置即可。
2. 防火墙配置
Docker 在安装过程中会自动处理 iptables/nftables 规则。通常情况下,你不需要手动开放端口,除非你在宿主机上直接映射端口到外部。如果需要自定义防火墙策略,请使用 ufw 或 iptables,并确保允许转发流量。
# 查看当前防火墙状态
sudo ufw status
3. 国内镜像提速(重要)
由于 Docker Hub 在国内访问速度不稳定,拉取镜像时容易超时。建议在 /etc/docker/daemon.json 中配置镜像提速器。
编辑或创建文件:
sudo nano /etc/docker/daemon.json
填入以下内容(以阿里云为例,其他厂商如腾讯云、华为云也有类似的提速地址):
{
"registry-mirrors": [
"https://<your-code>.mirror.aliyuncs.com"
]
}
注:你需要去阿里云容器镜像服务控制台获取自己的专属提速地址。
保存后,重启 Docker 服务:
sudo systemctl daemon-reload
sudo systemctl restart docker
4. 如何卸载 Docker?
如果你将来想彻底重装或卸载:
# 卸载包
sudo apt 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
总结
在 Ubuntu 22.04 上,不要再用 apt install docker.io。遵循“添加官方源 -> 安装 docker-ce”的路径是最规范的做法。安装完成后,务必配置镜像提速器,这对于国内开发者的日常效率提升至关重要。
云技术博客