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-worldCentOS/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-worldmacOS 安装
使用 Docker Desktop(推荐)
-
下载 Docker Desktop for Mac
- 访问 Docker Desktop 下载页面
- 选择适合的版本(Intel 或 Apple Silicon)
-
安装
- 双击下载的
.dmg文件 - 将 Docker 图标拖到 Applications 文件夹
- 启动 Docker Desktop
- 双击下载的
-
验证安装
docker --version
docker run hello-world使用 Homebrew
# 安装 Docker Desktop
brew install --cask docker
# 启动 Docker Desktop
open /Applications/Docker.appWindows 安装
使用 Docker Desktop(推荐)
-
系统要求
- Windows 10 64-bit: Pro, Enterprise, or Education (Build 19041 或更高版本)
- Windows 11 64-bit: Home or Pro version 21H2 或更高版本
- 启用 WSL 2 功能
-
安装步骤
- 下载 Docker Desktop for Windows
- 运行安装程序
- 按照向导完成安装
- 重启计算机(如需要)
-
验证安装
docker --version
docker run hello-worldDocker Desktop 使用
基本配置
-
资源分配
- Settings → Resources
- 配置 CPU、内存、磁盘限制
-
镜像加速器
- Settings → Docker Engine
- 添加国内镜像源配置
{
"registry-mirrors": [
"https://docker.mirrors.ustc.edu.cn",
"https://hub-mirror.c.163.com"
]
}- 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 docker2. 无法连接到 Docker daemon
问题:Cannot connect to the Docker daemon
解决方案:
# 启动 Docker 服务
sudo systemctl start docker
# 检查服务状态
sudo systemctl status docker3. 镜像拉取慢
解决方案:配置镜像加速器(见上方 Docker Desktop 配置)
4. WSL 2 相关问题(Windows)
问题:WSL 2 未安装或未启用
解决方案:
# 以管理员身份运行 PowerShell
wsl --install
wsl --set-default-version 2详细文档:有关 WSL 2 与 Docker 集成的完整配置,请参考 WSL 与 Docker 集成