Docker & Docker Compose安装教程

Docker & Docker Compose 安装教程

一、Docker 安装

1. Windows 系统安装

方法一：Docker Desktop（推荐）访问 Docker 官网下载 Docker Desktop for Windows 运行安装程序安装过程中勾选 "Use WSL 2 instead of Hyper-V"（推荐）重启计算机启动 Docker Desktop，完成初始化系统要求：

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

2. macOS 系统安装

方法一：Docker Desktop 访问 Docker 官网下载 Docker Desktop for Mac（Intel芯片或Apple芯片对应版本）双击下载的 .dmg 文件将 Docker 图标拖到 Applications 文件夹启动 Docker.app 完成初始设置系统要求：

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

3. Linux 系统安装

Ubuntu/Debian

# 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

CentOS/RHEL

# 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

方法二：使用包管理器（Ubuntu/Debian）

# 使用 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。建议：

定期更新到最新版本学习 Dockerfile 和 docker-compose.yml 编写探索 Docker Hub 上的官方镜像使用 volumes 持久化数据在生产环境中使用时要考虑安全性配置

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

Docker 官方文档
Docker Compose 文档