当前位置：首页 > news >正文

一篇就够！Windows上Docker Desktop安装 + 汉化完整指南（包含解决wsl更新失败方案）

news 来源：原创 2025/5/21 23:55:31

前言

在现代软件开发和人工智能应用中，环境的稳定性和可移植性至关重要。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

访问 Windows 11 安装助手官网，点击 立即下载。
根据系统提示，依次完成下载、安装和重启，直至升级完成，请勿中断操作，这里不再进行演示。
再次检查 Windows版本，在 PowerShell 或 运行（Win + R） 输入：
```
winver
```
如图所示我的 Windows版本 已成功升级至 24H2，满足 WSL2 需求（至少 22H2 或更高）。