容器与云原生 / 系统课时
在 Linux 上安装 Docker Engine
在 Linux 上安装 Docker Engine
本课以 Ubuntu 22.04/24.04 为例,通过 Docker 官方 APT 软件源安装 Docker Engine,启动并设置开机自启,最后让当前用户可以直接执行 Docker 命令。
学习目标
- 完成 Docker Engine、CLI、containerd 与 Compose 插件安装
- 启动 Docker 服务并验证客户端和服务端可用
- 配置当前用户权限,理解
docker用户组的安全影响
确认系统与处理冲突包
先确认发行版与 CPU 架构。下面的输出只是示例,实际版本号和架构可能不同。
cat /etc/os-release | grep PRETTY_NAME
dpkg --print-architecture预期输出
PRETTY_NAME="Ubuntu 24.04.x LTS"
amd64若系统已安装发行版自带的 docker.io、旧版 Compose、containerd 或 runc,先移除冲突包。未安装这些包时,APT 可能提示无需移除,这是正常现象。
conflicts=$(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc 2>/dev/null | awk '{print $1}')
if [ -n "$conflicts" ]; then
sudo apt remove -y $conflicts
else
echo "No conflicting packages installed."
fi预期结果
未安装冲突包时输出:No conflicting packages installed.
已安装冲突包时,APT 显示对应软件包被移除。配置官方软件源并安装
以下命令添加 Docker 官方 GPG 密钥和 APT 软件源,再安装 Engine、CLI、containerd、Buildx 与 Compose 插件。
sudo apt update
sudo apt install -y 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
sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker --version
docker compose version预期输出
Docker version <VERSION>, build <COMMIT>
Docker Compose version v<VERSION><VERSION> 和 <COMMIT> 会随安装时间变化。若 APT 提示找不到 docker-ce,应检查 /etc/apt/sources.list.d/docker.sources 中的发行版代号与软件源地址。
启动并验证服务
Ubuntu 通常会在安装后自动启动 Docker。仍建议显式启用开机自启,并检查守护进程是否处于运行状态。
sudo systemctl enable --now docker
sudo systemctl is-active docker
sudo docker version --format '{{.Server.Version}}'预期输出
active
<VERSION>第一行不是 active 时,使用 sudo systemctl status docker 查看失败原因。常见问题包括配置文件格式错误、磁盘空间不足或系统内核能力不满足。
配置当前用户权限
Docker 默认通过由 root 管理的 Unix Socket 接收命令。把当前用户加入 docker 组后,可以省略 sudo;执行 newgrp docker 可让当前终端立即刷新组权限。
sudo usermod -aG docker "$USER"预期结果
命令成功时通常没有输出。退出当前登录会话并重新登录,使新的组成员关系生效。也可以在当前终端执行 newgrp docker 打开一个已刷新组权限的子 Shell,然后验证无 sudo 运行。
groups
docker run --rm hello-world预期输出(节选)
<USER> ... docker
Hello from Docker!
This message shows that your installation appears to be working correctly.<USER> 为当前用户名,其他用户组会因系统而异。docker 组成员可以控制 Docker 守护进程,权限接近主机 root。多人共享或安全要求较高的服务器应严格限制成员,必要时评估 Docker Rootless 模式。
典型失败处理
出现 permission denied 时,先执行 groups 确认当前用户是否已经属于 docker 组;若没有生效,退出并重新登录。出现 Cannot connect to the Docker daemon 时,检查 systemctl is-active docker,并确认命令没有连接到错误的 DOCKER_HOST。