前言

在现代软件开发和人工智能应用中，环境的稳定性和可移植性至关重要。Docker 作为一种轻量级的容器化技术，为开发者提供一致的运行环境，使得软件可以在不同平台上无缝运行，极大地提升了开发和部署的效率。无论是本地开发、测试，还是大规模的云端部署，Docker 都能显著降低环境配置的复杂性，减少依赖冲突问题。

本教程将详细介绍在 Windows 上 Docker Desktop 的安装和配置方法，帮助用户快速上手并熟练使用 Docker。此外，我们还提供了 Docker Desktop 的 汉化教程，使用户能够以更直观的方式管理和使用容器环境。希望本指南能为您的开发工作带来便利，让 Docker 成为您高效工作的得力助手。

本教程内容摘自我之前撰写的文章 《在Windows上轻松部署本地大语言模型：Ollama与Open-WebUI的完整指南》。由于原文的浏览量不尽如人意，因此我将其中的 Docker Desktop 安装与汉化部分 单独整理成这篇独立教程，以便更多读者能够快速获取相关信息。

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

在 Windows 上使用 Docker Desktop 依赖 WSL 2 作为后端运行环境。因此，在安装 Docker Desktop 之前，您需要先 安装 WSL 2 并配置至少一个 Linux 发行版（如 Ubuntu）。如果您尚未完成此步骤，请参考我之前的文章：
🔗 Win10/11系统下WSL2+Ubuntu20.04的全流程安装指南（支持安装至 D 盘）
按照教程完成 WSL 2 的安装，并确保能够在 WSL 终端中正常运行 Linux 命令后，再继续进行 Docker Desktop 的安装配置。

一、安装 Docker Desktop

1. 下载 Docker Desktop：

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

2. 安装 Docker Desktop：

• 双击下载的安装文件，开始安装 Docker Desktop。
• 按照安装向导的指示完成安装。在安装过程中，将提示安装 WSL 2，建议勾选此选项以获得更好的性能。
  

3. 配置 Docker Desktop：

• 安装完成后，启动 Docker Desktop。

• 首次打开时，将出现 Docker 订阅协议，点击 Accept（接受）以继续。

  

• 随后，系统将提示用户登录。您可以选择使用 GitHub 账户或 Google 账户登录，若无上述账户，可选择跳过登录步骤。

  

• 接下来，将出现调查问卷，您可以根据个人喜好选择填写，或直接跳过此步骤。

  

• 最后，Docker Desktop 将正常启动。

  

二、汉化 Docker Desktop（可选）

若想使 Docker Desktop 显示中文界面，按照以下步骤进行汉化：

1. 下载对应版本的中文语言包：

• 访问 GitHub，下载适用于 Docker Desktop 的中文语言包，链接地址为：DockerDesktop-CN。
  
• 将下载的文件解压至 C:\Program Files\Docker 目录下（即 Docker 的安装根目录）。
  

2. 检查 Docker Desktop 版本：

• 启动 Docker Desktop，版本号将在右下角显示。
  

3. 备份并替换 app.asar 文件：

• 打开 Docker Desktop 中文语言包，选择与您 Docker 版本相符的 app.asar 文件并复制。
  
• 导航至 Docker 的安装目录，路径默认为：

  C:\Program Files\Docker\Docker\frontend\resources
  

• 在该目录下找到 app.asar 文件，建议先备份原文件，然后将复制的中文语言包中的 app.asar 文件粘贴并替换原有文件。
  

4. 重新启动 Docker Desktop：

• 完成替换后，请关闭 Docker Desktop，然后重新启动该程序。此时，Docker Desktop 应该以中文界面显示。
  

三、报错 WSL 更新失败

打开 Docker Desktop 后若出现如下警告，表明 Docker Desktop 在 WSL 更新时失败，系统无法找到 WSL。这通常是由于 Windows 版本较低，导致 WSL 兼容性问题，建议升级 Windows 以解决该问题。

解决方案：升级 Windows 11 版本以修复 WSL2 更新问题

1. 检查 Windows 版本

• 在 PowerShell 或 运行（Win + R） 输入：

  winver
  

  如图所示我的 Windows版本 为是 21H2，WSL2 需要至少满足 22H2 或更高。

  

2. 手动升级 Windows

1. 访问 Windows 11 安装助手官网 ，点击 立即下载。

   

2. 根据系统提示，依次完成下载、安装和重启，直至升级完成，请勿中断操作，这里不再进行演示。

3. 再次检查 Windows版本，在 PowerShell 或 运行（Win + R） 输入：

   winver
   

   如图所示我的 Windows版本 已成功升级至 24H2，满足 WSL2 需求（至少 22H2 或更高）。

   

3. 手动更新 WSL

1. Windows 更新完毕后，以管理员身份运行 PowerShell 执行：

   wsl --update
   

2. 如果一切正常，然后运行，你会看到如下图所示，说明 WSL 已成功更新！

   wsl --version
   

   

4. 重新启动 Docker Desktop

• 重新启动 Docker Desktop 后可以看到不再弹出报错