Docker 安装（Ubuntu）

本章将详细介绍如何在 Ubuntu 系统上安装和配置 Docker Engine。

系统要求

Docker Engine 支持以下 Ubuntu 版本（64 位）：

• Ubuntu 24.04 (Noble)
• Ubuntu 22.04 (Jammy)
• Ubuntu 20.04 (Focal)

硬件要求：

• 64 位处理器
• 内核版本 3.10 或更高
• 至少 2GB RAM（推荐 4GB 以上）

卸载旧版本

如果之前安装过旧版本的 Docker，需要先卸载：

sudo apt-get remove docker docker-engine docker.io containerd runc

安装方法一：使用 APT 仓库安装（推荐）

1. 更新包索引并安装依赖

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg

2. 添加 Docker 官方 GPG 密钥

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

3. 添加 Docker APT 仓库

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4. 安装 Docker Engine

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

5. 验证安装

sudo docker run hello-world

安装方法二：使用便捷脚本

Docker 提供了一键安装脚本，适合快速安装：

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

⚠️ 便捷脚本不建议在生产环境使用，因为它会自动安装最新版本且无法自定义配置。

安装后配置

配置非 root 用户运行 Docker

默认情况下，Docker 命令需要 sudo 权限。将用户添加到 docker 组可以免去 sudo：

# 创建 docker 组（通常安装时已自动创建）
sudo groupadd docker

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER

# 使组变更生效（或重新登录）
newgrp docker

# 验证无需 sudo 即可运行
docker run hello-world

配置 Docker 开机自启

# 设置开机自启
sudo systemctl enable docker.service
sudo systemctl enable containerd.service

# 如需禁用开机自启
sudo systemctl disable docker.service
sudo systemctl disable containerd.service

配置 Docker Daemon

创建或编辑 /etc/docker/daemon.json：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  },
  "storage-driver": "overlay2"
}
EOF

# 重启 Docker 使配置生效
sudo systemctl restart docker

常见问题

权限问题

# 如果遇到 "permission denied" 错误
sudo chmod 666 /var/run/docker.sock

# 或者确认用户已在 docker 组中
groups $USER

服务启动失败

# 检查 Docker 服务状态
sudo systemctl status docker

# 查看详细日志
sudo journalctl -xu docker.service

DNS 解析问题

如果容器内无法解析域名，编辑 /etc/docker/daemon.json：

{
  "dns": ["8.8.8.8", "8.8.4.4"]
}

卸载 Docker

# 卸载 Docker Engine
sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# 删除所有镜像、容器和数据卷
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

验证安装成功

# 检查版本
docker --version
docker compose version

# 查看系统信息
docker info

# 运行测试容器
docker run hello-world

如果所有命令正常执行，说明 Docker 在 Ubuntu 上安装成功。

延伸阅读

• Docker 官方 Ubuntu 安装文档
• Docker 安装后配置