Windows 11 Docker Desktop 安装与配置指南

3.2 设置 WSL2 为默认版本

wsl --set-default-version 2

3.3 安装 Linux 发行版（推荐 Ubuntu）

1. 打开 Microsoft Store
2. 搜索 "Ubuntu"（推荐 Ubuntu 22.04 LTS）
3. 点击 "获取" 安装
4. 安装完成后，在开始菜单找到 Ubuntu 并启动
5. 首次启动会提示设置用户名和密码（密码输入时不显示，这是正常的）

四、下载 Docker Desktop

1. 访问 Docker 官网下载页：https://www.docker.com/products/docker-desktop
2. 点击 "Download for Windows" 按钮
3. 等待安装包下载（文件名为 Docker Desktop Installer.exe）

五、安装 Docker Desktop

5.1 执行安装程序

1. 双击下载的安装文件

2. 关键步骤：等待安装完成（无需手动选择组件）

注意：现代 Docker Desktop 会自动检测并使用 WSL2，无需手动配置。

5.2 安装过程

• 安装可能需要 3-5 分钟
• 如果出现 Windows 安全中心提示，点击 "允许访问"
• 安装完成后会提示重启电脑，建议 立即重启。

六、首次启动和配置

6.1 启动 Docker Desktop

1. 在开始菜单找到 "Docker Desktop" 启动
2. 任务栏右下角会出现 🐳 鲸鱼图标
3. 首次启动可能需要 1-2 分钟初始化

6.2 登录 Docker 账户（可选）

• 弹出登录窗口可以 Skip 跳过，或使用 Google/GitHub 快速注册
• 登录后可享受免费镜像仓库额度

6.3 基础配置

右键点击任务栏鲸鱼图标 → Settings：

General 设置：

• ✅ Start Docker Desktop when you log in（开机自启，按需勾选）

Resources - WSL Integration：

• 确保你的 Ubuntu 发行版已勾选（如 Ubuntu-22.04）
• 这样可以在 WSL 中直接使用 Docker 命令

点击 Apply & Restart 保存设置

七、验证安装

7.1 基本命令测试

打开 PowerShell 或 Windows 终端，执行：

# 查看 Docker 版本
docker --version
# 查看 Docker Compose 版本
docker compose version

八、基础使用教程

8.1 拉取并运行 Nginx 示例

# 拉取 Nginx 镜像
docker pull nginx
# 运行容器（后台模式，映射端口）
docker run -d -p 8080:80 --name my-nginx nginx

8.2 验证容器运行

1. 浏览器访问：http://localhost:8080
2. 应该看到 Nginx 欢迎页面

8.3 常用命令速查

# 查看运行中的容器
docker ps
# 查看所有容器（包括停止的）
docker ps -a
# 停止容器
docker stop my-nginx
# 删除容器
docker rm my-nginx
# 查看镜像列表
docker images
# 删除镜像
docker rmi nginx
# 查看日志
docker logs my-nginx

九、常见问题解决

❌ 问题 1：Docker 启动失败，提示 WSL2 错误

解决：

# 在 PowerShell 管理员模式下执行
wsl --shutdown
netsh winsock reset
netsh int ip reset all
# 重启电脑

❌ 问题 2：拉取镜像速度慢

解决：

在 Docker Desktop → Settings → Docker Engine，添加国内镜像源：

{
  "registry-mirrors": [
    "https://mirror.gcr.io",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}

点击 Apply & Restart

❌ 问题 3：提示内存不足

解决：

Settings → Resources → 调低 Memory 限制（建议不低于 2GB）

❌ 问题 4：端口被占用

解决：

# 查看端口占用
netstat -ano | findstr :8080
# 终止占用进程（以 PID 12345 为例）
taskkill /PID 12345 /F

总结

通过以上步骤，你已经成功在 Windows 11 上安装并配置了 Docker Desktop。关键点：

1. 必须开启 BIOS 虚拟化
2. 推荐使用 WSL2 后端
3. 遇到问题时优先查看鲸鱼图标状态

现在你可以开始学习 Docker 容器化技术，部署各种应用了。