本文将手把手教你在 Ubuntu 上安装 Docker，包含官方安装方式、国内加速、验证方法以及常见问题排查，适用于 Ubuntu 20.04 / 22.04 / 24.04。
一、Docker 是什么？
Docker 是一种轻量级容器技术，可以把应用及其依赖打包成“容器”，实现：
- 一次构建，到处运行
- 环境隔离（不会污染系统）
- 非常适合部署：Web、AI模型、数据库等
官网：
二、Ubuntu 安装 Docker 前准备
1. 更新系统
sudo apt update
sudo apt upgrade -y
2. 安装必要工具
sudo apt install -y ca-certificates curl gnupg lsb-release
三、使用官方方式安装 Docker（推荐）
1. 添加 Docker GPG Key
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
2. 添加 Docker 软件源
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
3. 安装 Docker Engine
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
四、验证 Docker 是否安装成功
docker --version
测试运行：
sudo docker run hello-world
如果看到：
Hello from Docker!
说明安装成功 ✔
五、配置 Docker（推荐做）
1. 允许普通用户运行 Docker
sudo usermod -aG docker $USER
然后重新登录或执行：
newgrp docker
2. 设置开机启动
sudo systemctl enable docker
sudo systemctl start docker
六、安装 Docker Compose（新版已内置）
检查：
docker compose version
如果没有，可以单独安装：
sudo apt install docker-compose-plugin
七、配置国内镜像加速（重要）
如果你在国内或访问慢，可以配置镜像加速：
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
"registry-mirrors": [
"https://mirror.ccs.tencentyun.com",
"https://docker.mirrors.ustc.edu.cn"
]
}
EOF
重启 Docker：
sudo systemctl daemon-reexec
sudo systemctl restart docker
八、Docker 基础使用命令
1. 拉取镜像
docker pull nginx
2. 运行容器
docker run -d -p 80:80 nginx
3. 查看运行容器
docker ps
4. 停止容器
docker stop container_id
5. 删除容器
docker rm container_id
九、Docker Compose 使用示例
创建 docker-compose.yml：
version: "3.9"
services:
web:
image: nginx
ports:
- "8080:80"
启动：
docker compose up -d
十、常见问题排查
1. docker: permission denied
解决：
sudo usermod -aG docker $USER
newgrp docker
2. Docker 服务未启动
sudo systemctl start docker
3. 拉取镜像很慢
配置镜像加速（第七部分）
4. docker command not found
说明没装成功，重新执行：
sudo apt install docker-ce
十一、Docker 官方资源
- 官方文档：Docker Docs
- 官方安装指南：Docker Install Guide
- 官网主页：Docker Home
十二、总结
在 Ubuntu 上安装 Docker 的核心流程：
- 添加官方源
- 安装 docker-ce
- 配置用户权限
- 启动服务
- 验证运行