努力
加油

在云服务器Ubuntu 22.04系统上安装Docker的完整步骤是什么?

在 Ubuntu 22.04 (Jammy Jellyfish) 上安装 Docker,目前最稳妥、也是官方推荐的做法是通过 Docker 官方 APT 仓库进行安装。

为什么不建议直接用 apt install docker.io?
因为 Ubuntu 自带的 docker.io 包版本通常较老,且更新滞后。而使用官方源安装的 docker-ce (Community Edition) 能确保你拿到的是最新稳定版,驱动和内核兼容性也更好。

以下是生产环境常用的标准流程,步骤清晰,无废话。

前置检查:确认系统环境

  1. 架构确认:Docker 仅支持 64 位系统。
    uname -m
    # 输出应为 x86_64 或 aarch64 (ARM)
  2. 权限要求:后续所有命令需要 sudo 权限。
  3. 清理旧版本(如果之前装过):
    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 组。

  1. 创建 docker 组(如果不存在):
    sudo groupadd docker
  2. 将当前用户加入该组:
    sudo usermod -aG docker $USER
  3. 注销并重新登录,或者重启服务器,使组更改生效。
  4. 验证:
    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”的路径是最规范的做法。安装完成后,务必配置镜像提速器,这对于国内开发者的日常效率提升至关重要。