序章: 准备工作：从 Linux 基础到 Docker 环境配置

0.1. 本篇指南的目标读者：DevOps 赋能的容器化实践者

我们假定您是：

• 一位将 WSL2 作为核心开发环境的实践者，日常工作离不开 Windows Terminal 和 VS Code Remote - WSL 插件。
• 一位对 Linux 命令行 怀有敬畏并运用自如的开发者，grep, awk, curl, htop, systemctl 等工具是您解决问题的得力助手。
• 一位具备初步 DevOps 思维 的工程师，深刻理解环境一致性的重要性，并渴望将这种一致性从开发、测试延伸到生产部署的每一个环节。

0.2. 知识衔接：你的 Linux 技能在 Docker 中的应用价值

您最大的优势在于，Docker 并非凭空产生的“魔法”，而是构建在 Linux 内核特性之上的产物。您已掌握的技能不仅不会过时，反而会成为您理解 Docker 底层原理的“金钥匙”。

0.3. 前置要求：安装 WSL 2 与 Linux 发行版

如果您尚未完成此步骤，请务必参考以下这篇详尽的指南，它将指导您完成从零开始的全部流程，甚至包括如何将发行版安装到非系统盘。

请确保您已完成上述指南中的所有步骤，再继续阅读。

0.4. 安装并配置 Docker Desktop

0.4.1. 下载 Docker Desktop

• 访问 Docker 官方网站：https://www.docker.com/products/docker-desktop/
• 点击页面上的 “Download for Windows” 按钮，下载适用于 Windows 系统的 Docker Desktop 最新安装文件。

0.4.2. 执行安装程序

• 双击下载的 .exe 安装文件，启动安装向导。
• 在配置界面，请确保勾选 “Use WSL 2 instead of Hyper-V (recommended)” 选项。这是我们选择的最佳实践方案。点击 Ok 继续。

)

0.4.3. 完成首次启动配置

• 安装完成后，启动 Docker Desktop。
• 接受订阅协议: 首次打开时，会弹出 Docker 订阅服务协议，点击 Accept 接受以继续。

• 登录 (可选): 系统会提示您登录。您可以选择使用 Docker Hub、GitHub 或 Google 账户登录，如果暂时不需要，也可以点击 Continue without signing in 跳过此步骤。

• 问卷调查 (可选): 接下来会有一个关于您角色的简短问卷，可以直接点击 Skip 跳过。

)

• 启动完成: 完成以上步骤后，您将看到 Docker Desktop 的主界面，左下角显示为绿色，表示引擎正在运行。

0.5. 汉化 Docker Desktop（可选）

对于希望使用中文界面的用户，可以按照以下步骤进行汉化。

0.5.1. 下载中文语言包

• 访问 GitHub 上的开源项目 DockerDesktop-CN，下载最新的语言包。
  引用站外地址

  DockerDesktop-CN

  访问此 GitHub 仓库下载适用于 Docker Desktop 的中文语言包

• 将下载的 app.asar 文件（或包含该文件的压缩包）保存到本地。

0.5.2. 替换语言文件

• 检查版本: 在替换前，请查看您 Docker Desktop 的版本号。可以在主界面右下角或设置中找到。

• 定位目录: 导航至 Docker 的资源文件目录，默认路径为：
  C:\Program Files\Docker\Docker\resources
• 备份与替换:
  1. 在该目录下找到原始的 app.asar 文件，将其重命名为 app.asar.bak 以作备份。
  2. 将您从 GitHub 下载的、与您版本对应的中文 app.asar 文件复制到此目录。

0.5.3. 重启 Docker Desktop

• 彻底关闭 Docker Desktop（可以右键任务栏图标选择 Quit Docker Desktop）。
• 重新启动程序。此时，界面应该已经显示为中文。

0.6. 关键问题排查：解决 WSL 更新失败

)

解决方案：升级 Windows 并手动更新 WSL

1. 检查 Windows 版本

• 按下 Win + R 组合键，输入 winver 并回车。
• 查看您的 Windows 版本号。WSL2 的完整功能和稳定性需要 Windows 11 版本 22H2 或更高版本。如果您的版本较低（如 21H2），则必须升级。

2. 手动升级 Windows

• 访问 Windows 11 安装助手官方页面。
• 在“Windows 11 安装助手”部分，点击 立即下载。

• 运行下载的工具，按照提示完成系统升级。这个过程耗时较长，请确保电脑电量充足并保持网络连接。
• 升级完成后，再次运行 winver 命令，确认系统版本已达到 22H2 或更高。

3. 手动更新 WSL 内核

• 系统升级后，以 管理员身份 运行 PowerShell 或 Windows Terminal。
• 执行 WSL 更新命令：

  1	wsl --update

• 更新完成后，检查 WSL 版本以确认成功：

  1	wsl --version

4. 重新启动 Docker Desktop

• 完成以上所有步骤后，再次启动 Docker Desktop。此时，之前的 WSL 错误应该已经消失。

0.7. 最终验证与镜像加速配置

完成上述步骤后，您的 Docker 环境已基本就绪。现在，我们来进行最后的验证和优化。

1. 验证 Docker 环境

打开您的 WSL2 终端 (例如，在 Windows Terminal 中打开 Ubuntu 标签页)，执行以下命令：

1
2

# 检查 Docker 版本，确认客户端和服务端均已正常运行
docker --version

1
2

# 运行经典的 "hello-world" 镜像，验证 Docker 的完整工作流程
docker run hello-world

如果您能看到 “Hello from Docker!” 的问候语，那么恭喜您，Docker 环境已成功搭建！

2. 配置国内镜像加速器

1. 在任务栏右下角右键点击 Docker 图标，选择 Settings (设置)。
2. 导航到 Docker Engine 标签页。
3. 在右侧的 JSON 配置文件中，添加 registry-mirrors 字段。以下是一些常用的公共加速器地址（请选择一个或多个）：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.xuanyuan.me"
  ]
}

4. 点击右下角的 “Apply & Restart” 按钮。Docker 将会重启并应用新的配置。

至此，您的开发环境已完全准备就绪。在下一章中，我们将正式深入 Docker 的内部，从其核心架构与概念开始，真正地“拆开”这个黑盒。