安装前准备#

更新系统并安装依赖#

1
sudo apt-get update
2

3
sudo apt-get install -y \
4
    ca-certificates \
5
    curl \
6
    gnupg \
7
    lsb-release

创建密钥目录#

1
sudo mkdir -p /etc/apt/keyrings

Docker 安装#

注意：国内网络环境下无法直接访问 Docker 官方源，需使用国内镜像源（如阿里云）。

1. 清理旧的残留文件（可选）#

如果之前安装失败过，先清理：

1
sudo rm -f /etc/apt/keyrings/docker.gpg
2
sudo rm -f /etc/apt/sources.list.d/docker.list

2. 下载 GPG 密钥（阿里云镜像）#

1
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

3. 添加软件源（阿里云镜像）#

1
echo \
2
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu \
3
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4. 更新软件列表#

1
sudo apt-get update

5. 安装 Docker Engine#

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

6. 验证安装#

1
docker --version
2

3
sudo docker run hello-world

看到 “Hello from Docker!” 说明安装成功。

权限配置#

添加用户到 docker 组（推荐）#

1
# 创建 docker 组（通常已自动创建）
2
sudo groupadd docker
3

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

激活权限#

权限修改后需要重新登录：

1
# 方法1：激活新组设置（当前会话临时生效）
2
newgrp docker
3

4
# 方法2：重新登录 SSH
5

6
# 方法3：重启系统（最可靠）
7
sudo reboot

验证权限#

1
# 查看当前用户所属组
2
groups
3

4
# 测试（无需 sudo）
5
docker run hello-world

服务管理#

启停服务#

1
# 启动
2
sudo systemctl start docker
3

4
# 停止
5
sudo systemctl stop docker
6

7
# 重启
8
sudo systemctl restart docker
9

10
# 查看状态
11
sudo systemctl status docker

开机自启#

1
# 启用
2
sudo systemctl enable docker
3

4
# 禁用
5
sudo systemctl disable docker

镜像加速配置#

国内拉取镜像较慢，建议配置镜像加速器。

创建配置文件#

1
sudo mkdir -p /etc/docker
2

3
sudo tee /etc/docker/daemon.json > /dev/null <<EOF
4
{
5
  "registry-mirrors": [
6
    "https://docker.mirrors.ustc.edu.cn",
7
    "https://hub-mirror.c.163.com",
8
    "https://mirror.ccs.tencentyun.com"
9
  ],
10
  "log-driver": "json-file",
11
  "log-opts": {
12
    "max-size": "100m",
13
    "max-file": "3"
14
  }
15
}
16
EOF

应用配置#

1
sudo systemctl daemon-reload
2
sudo systemctl restart docker

验证配置#

1
docker info | grep -A 5 "Registry Mirrors"

常用命令速查#

镜像操作#

1
docker pull nginx:latest      # 拉取镜像
2
docker images                  # 查看本地镜像
3
docker rmi nginx:latest        # 删除镜像
4
docker build -t myapp:v1 .     # 构建镜像

容器操作#

1
docker run -d --name web nginx             # 后台运行
2
docker run -it ubuntu /bin/bash            # 交互式运行
3
docker ps                                   # 查看运行中容器
4
docker ps -a                                # 查看所有容器
5
docker stop web                             # 停止容器
6
docker start web                            # 启动容器
7
docker rm web                               # 删除容器
8
docker exec -it web /bin/bash              # 进入容器
9
docker logs web                             # 查看日志
10
docker logs -f web                          # 实时查看日志

系统清理#

1
docker system df                # 查看磁盘占用
2
docker system prune             # 清理未使用资源
3
docker system prune -a          # 清理所有未使用资源（含镜像）
4
docker volume prune             # 清理未使用卷

常见问题#

权限不足#

1
Got permission denied while trying to connect to the Docker daemon socket

解决：确认用户已加入 docker 组并重新登录。

镜像下载慢#

解决：配置国内镜像加速器（见上文）。

服务无法启动#

1
# 查看详细错误
2
sudo journalctl -xu docker.service
3

4
# 检查配置文件语法
5
sudo dockerd --validate