Docker & Docker Compose安装教程

一、Docker 安装

1. Windows 系统安装

• Windows 10/11 64位（专业版、企业版或教育版）
• 开启 Hyper-V 或 WSL 2 支持
• 至少 4GB RAM

2. macOS 系统安装

• macOS 10.15 或更高版本
• 至少 4GB RAM

3. Linux 系统安装

# 1. 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 2. 安装依赖包
sudo apt-get update
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# 3. 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 4. 设置仓库
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

# 5. 安装 Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 6. 验证安装
sudo docker run hello-world

# 1. 卸载旧版本
sudo yum remove docker \
    docker-client \
    docker-client-latest \
    docker-common \
    docker-latest \
    docker-latest-logrotate \
    docker-logrotate \
    docker-engine

# 2. 安装依赖
sudo yum install -y yum-utils

# 3. 设置仓库
sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

# 4. 安装 Docker Engine
sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 5. 启动 Docker
sudo systemctl start docker
sudo systemctl enable docker

# 6. 验证安装
sudo docker run hello-world

二、Docker Compose 安装

1. Windows 和 macOS

Docker Desktop 已包含 Docker Compose，无需单独安装。

2. Linux 单独安装

# 下载最新版本（如需要特定版本，替换 v2.20.0）
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

# 使用 apt 安装（较老版本）
sudo apt-get update
sudo apt-get install docker-compose

# 或安装最新版本
sudo apt-get install docker-compose-plugin

三、安装后配置

1. 非 root 用户使用 Docker（Linux）

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

# 重新登录或重启系统使更改生效
newgrp docker

# 验证
docker run hello-world

2. 配置镜像加速器（国内用户）

# Docker Desktop（图形界面配置）
# Settings -> Docker Engine -> 添加 registry-mirrors

# Linux 系统
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}
EOF

# 重启 Docker
sudo systemctl restart docker

3. 常用镜像源（中国）

• 阿里云：https://<你的ID>.mirror.aliyuncs.com
• 中科大：https://docker.mirrors.ustc.edu.cn
• 网易：https://hub-mirror.c.163.com
• 百度：https://mirror.baidubce.com

四、验证安装

1. 验证 Docker

docker --version
docker info
docker run hello-world

2. 验证 Docker Compose

docker-compose --version
# 或（如果安装了插件）
docker compose version

五、基本使用测试

创建测试项目

# 创建项目目录
mkdir docker-test && cd docker-test

# 创建 docker-compose.yml
cat > docker-compose.yml << EOF
version: '3.8'
services:
  web:
    image: nginx:alpine
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
  db:
    image: postgres:13
    environment:
      POSTGRES_PASSWORD: example
EOF

# 创建测试页面
mkdir html
echo "<h1>Docker Compose Test</h1>" > html/index.html

# 启动服务
docker-compose up -d

# 查看运行状态
docker-compose ps

# 停止服务
docker-compose down

六、常见问题解决

1. Docker 启动失败（Linux）

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

# 查看日志
sudo journalctl -u docker.service

# 重启服务
sudo systemctl restart docker

2. 权限问题

# 检查当前用户是否在 docker 组
groups $USER

# 如果没有，添加用户并重新登录
sudo usermod -aG docker $USER
logout  # 重新登录

3. 端口冲突

# 查看端口占用
sudo netstat -tulpn | grep :80

# 或者使用 lsof
sudo lsof -i :80

4. 磁盘空间不足

# 清理无用镜像
docker system prune -a

# 查看磁盘使用情况
docker system df

七、卸载 Docker

Ubuntu/Debian

sudo apt-get purge docker-ce docker-ce-cli containerd.io
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

CentOS/RHEL

sudo yum remove docker-ce docker-ce-cli containerd.io
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

总结

通过以上步骤，你应该已经成功安装了 Docker 和 Docker Compose。建议：

如需进一步学习，建议查阅官方文档：

• Docker 官方文档
• Docker Compose 文档