清晰易懂的Docker安装与配置教程

Docker 是目前最流行的容器化技术，可以让你轻松打包、分发和运行应用程序。本教程将手把手教你安装 Docker 并运行第一个容器，从安装到实战，全程无坑！

---

一、安装 Docker（全平台支持）

1. Windows 系统安装

系统要求：

• Windows 10 64位（专业版/企业版/教育版，版本 2004 或更高）
• 启用 Hyper-V 和 WSL 2 功能

安装步骤：

1. 下载 Docker Desktop：https://www.docker.com/products/docker-desktop
2. 双击安装包运行安装向导
3. 安装完成后，勾选 “Start Docker Desktop when you log in”（开机自启）
4. 点击 “Finish” 完成安装

验证安装：

打开命令提示符（CMD）或 PowerShell：

docker --version
# 输出示例：Docker version 24.0.5, build ced0996
docker run hello-world
# 如果能显示 "Hello from Docker!" 说明安装成功

---

2. macOS 系统安装

系统要求：

• macOS 10.15 (Catalina) 或更高版本
• 支持 Intel 和 Apple Silicon (M1/M2) 芯片

安装步骤：

1. 下载 Docker Desktop for Mac：https://docs.docker.com/desktop/install/mac-install/
2. 双击下载的 .dmg 文件
3. 将 Docker 图标拖到 Applications 文件夹
4. 打开 Applications 文件夹，双击 Docker 图标启动

验证安装：

打开终端（Terminal）：

docker --version
docker run hello-world

---

3. Linux 系统安装（以 Ubuntu 为例）

安装步骤：

1. 卸载旧版本（如果有）：

   sudo apt remove docker docker-engine docker.io containerd runc
   

2. 安装依赖：

   sudo apt update
   sudo apt install ca-certificates curl gnupg
   

3. 添加 Docker 官方 GPG 密钥：

   sudo install -m 0755 -d /etc/apt/keyrings
   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
   sudo chmod a+r /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 \
   "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
   sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
   

5. 安装 Docker：

   sudo apt update
   sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
   

6. 验证安装：

   sudo docker run hello-world
   

---

二、配置 Docker（新手必看）

1. 解决权限问题（Linux）

默认情况下，运行 Docker 需要 sudo 权限。可以配置当前用户直接使用：

sudo groupadd docker          # 如果docker组不存在
sudo usermod -aG docker $USER
newgrp docker                # 刷新组权限

2. 配置国内镜像加速

1. 编辑或创建 /etc/docker/daemon.json（Linux/macOS）或 Docker Desktop 设置（Windows）：

   {
     "registry-mirrors": [
       "https://hub-mirror.c.163.com",
       "https://mirror.baidubce.com"
     ]
   }
   

2. 重启 Docker：

   sudo systemctl restart docker  # Linux
   # Windows/macOS 重启 Docker Desktop
   

3. 设置 Docker 开机自启

sudo systemctl enable docker  # Linux
# Windows/macOS 在 Docker Desktop 设置中勾选

---

三、运行第一个容器

1. 运行 Nginx 服务器

docker run -d -p 8080:80 --name my-nginx nginx

• -d：后台运行
• -p 8080:80：将容器80端口映射到主机8080端口
• --name：给容器命名

访问 http://localhost:8080 可以看到 Nginx 欢迎页面

2. 常用命令速查

命令	说明
docker ps	查看运行中的容器
docker ps -a	查看所有容器
docker stop <容器名>	停止容器
docker rm <容器名>	删除容器
docker images	查看镜像
docker rmi <镜像名>	删除镜像

---

四、新手容易忽略的细节

1. Windows 未开启 WSL 2 或 Hyper-V

• 现象：Docker Desktop 启动失败
• 解决：
  1. 确保 Windows 版本符合要求
  2. 启用 WSL 2：wsl --install
  3. 启用 Hyper-V：
     • 控制面板 → 程序和功能 → 启用或关闭 Windows 功能 → 勾选 Hyper-V

2. Linux 忘记配置用户组

• 现象：运行 docker ps 提示权限不足
• 解决：执行 sudo usermod -aG docker $USER 并重新登录

3. 镜像下载速度慢

• 现象：docker pull 速度极慢
• 解决：配置国内镜像加速（见第二节）

4. 容器端口冲突

• 现象：docker run 提示端口已被占用
• 解决：
  • 修改映射端口：-p 8081:80
  • 或停止占用端口的服务

---

五、总结

通过本教程，你已经：

1. 成功安装 Docker（Windows/macOS/Linux）
2. 配置了优化设置（权限、镜像加速）
3. 运行了第一个容器（Nginx）
4. 掌握了基本命令

下一步建议：

• 学习 Dockerfile 构建自定义镜像
• 尝试 Docker Compose 管理多容器应用
• 探索 Kubernetes 容器编排

遇到问题可以查阅 Docker 官方文档 或留言讨论！ 🐳