Docker 安装与环境配置

Docker 在不同平台的安装方法和环境配置


📋 目录


Linux 安装

Ubuntu/Debian

# 更新包索引
sudo apt-get update
 
# 安装必要的依赖
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
 
# 添加 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
 
# 设置仓库
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
 
# 安装 Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
 
# 启动 Docker
sudo systemctl start docker
sudo systemctl enable docker
 
# 验证安装
sudo docker run hello-world

CentOS/RHEL

# 安装必要的依赖
sudo yum install -y yum-utils
 
# 添加 Docker 仓库
sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo
 
# 安装 Docker Engine
sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
 
# 启动 Docker
sudo systemctl start docker
sudo systemctl enable docker
 
# 验证安装
sudo docker run hello-world

配置非 root 用户(可选)

# 创建 docker 用户组
sudo groupadd docker
 
# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER
 
# 重新登录或执行以下命令使更改生效
newgrp docker
 
# 验证(不需要 sudo)
docker run hello-world

macOS 安装

使用 Docker Desktop(推荐)

  1. 下载 Docker Desktop for Mac

  2. 安装

    • 双击下载的 .dmg 文件
    • 将 Docker 图标拖到 Applications 文件夹
    • 启动 Docker Desktop
  3. 验证安装

docker --version
docker run hello-world

使用 Homebrew

# 安装 Docker Desktop
brew install --cask docker
 
# 启动 Docker Desktop
open /Applications/Docker.app

Windows 安装

使用 Docker Desktop(推荐)

  1. 系统要求

    • Windows 10 64-bit: Pro, Enterprise, or Education (Build 19041 或更高版本)
    • Windows 11 64-bit: Home or Pro version 21H2 或更高版本
    • 启用 WSL 2 功能
  2. 安装步骤

    • 下载 Docker Desktop for Windows
    • 运行安装程序
    • 按照向导完成安装
    • 重启计算机(如需要)
  3. 验证安装

docker --version
docker run hello-world

Docker Desktop 使用

基本配置

  1. 资源分配

    • Settings → Resources
    • 配置 CPU、内存、磁盘限制
  2. 镜像加速器

    • Settings → Docker Engine
    • 添加国内镜像源配置
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}
  1. WSL 2 集成(Windows)
    • Settings → General
    • 启用 “Use the WSL 2 based engine”
    • 详细配置请参考 WSL 与 Docker 集成

安装验证

检查版本

# Docker 版本
docker --version
 
# Docker 详细信息
docker info
 
# Docker Compose 版本
docker compose version

运行测试容器

# 运行 hello-world 容器
docker run hello-world
 
# 运行交互式容器
docker run -it ubuntu:latest /bin/bash

检查 Docker 服务状态(Linux)

# 检查服务状态
sudo systemctl status docker
 
# 查看 Docker 进程
ps aux | grep docker

常见问题

1. 权限问题(Linux)

问题permission denied while trying to connect to the Docker daemon socket

解决方案

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

2. 无法连接到 Docker daemon

问题Cannot connect to the Docker daemon

解决方案

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

3. 镜像拉取慢

解决方案:配置镜像加速器(见上方 Docker Desktop 配置)

4. WSL 2 相关问题(Windows)

问题:WSL 2 未安装或未启用

解决方案

# 以管理员身份运行 PowerShell
wsl --install
wsl --set-default-version 2

详细文档:有关 WSL 2 与 Docker 集成的完整配置,请参考 WSL 与 Docker 集成


📚 参考资源


相关笔记