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

Windows 环境下 Docker Desktop 安装 + 汉化

news 来源：原创 2025/6/25 2:10:28

一、WSL2+Ubuntu20.04以及Docker Desktop安装

在开发过程中，Docker 是一款极为实用的工具。本教程专为 Windows 用户打造，将全面且细致地讲解 Docker Desktop 的安装与配置步骤，助您迅速入门并熟练掌握。同时，考虑到语言使用习惯，我们精心准备了 Docker Desktop 汉化教程，让您能以更直观易懂的界面管理和操作容器环境。期望这份指南能为您的开发工作增添助力，使 Docker 成为您提升效率的绝佳帮手。

这边文章摘抄自我之前创作的文章《RAGFlow Windows环境下本地部署全攻略》，由于这部分比较特殊，所以另开一篇进行讲述。

1. 简介

WSL2（Windows Subsystem for Linux 2）是 Windows 提供的一种轻量级 Linux 运行环境，具备完整的 Linux 内核，并支持更好的文件系统性能和兼容性。它允许用户在 Windows 系统中运行 Linux 命令行工具和应用程序，而无需安装虚拟机或双系统。

Docker 是一种轻量级的容器化技术，为开发者提供一致的运行环境，使得软件可以在不同平台上无缝运行，极大地提升了开发和部署的效率。无论是本地开发、测试，还是大规模的云端部署，Docker 都能显著降低环境配置的复杂性，减少依赖冲突问题。
在这里插入图片描述

2. 安装

1. 安装 WSL 2

打开 PowerShell（管理员权限）：

方法一：使用 Cortana 搜索栏（Windows 10）：在任务栏的 Cortana 搜索框中输入
“PowerShell”，在搜索结果中右键单击 “Windows PowerShell”，选择 “以管理员身份运行”。
方法二：按下 Win+R 键打开运行对话框，输入 “powershell” 后点击 “确定”，此时打开的是普通权限的
PowerShell。若要提升为管理员权限，需在该窗口中输入命令 “Start - Process powershell - Verb
runAs” 并按回车键。
方法三：先打开具有管理员权限的命令行窗口，方法是按下 Win+X 组合键，选择 “命令提示符（管理员）”，在打开的命令提示符中输入 “powershell” 并回车，即可打开具有管理员权限的 PowerShell。另外，更新至 Windows 10 创意者版本后，按下 Windows+X 组合键，直接点击 “Windows PowerShell（管理员）” 也可打开。

打开之后运行下面命令，启用 WSL 功能：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

在这里插入图片描述

解释：

/all：在所有用户上启用该功能
/norestart：启用功能后不会立即重启

启用虚拟机平台功能，输入命令：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

在这里插入图片描述
将 WSL 默认版本设置为 WSL2（视系统型号而定）

wsl --set-default-version 2

Windows 11 默认已安装 WSL2，不需要执行该命令。
Windows 10 用户需要执行此命令，否则默认使用 WSL1。

为了保证以上命令执行完成后，请重启电脑，以确保所有更改生效。

2. 安装 Ubuntu-20.04

在安装之前先创建文件夹，保证后续的迁移路径：
D盘创建 WSL 文件夹，并在该文件夹下创建 Ubuntu-20.04 文件夹。
在这里插入图片描述

在安装 Ubuntu-20.04 之前首先得查看可用的 WSL 发行版，打开 PowerShell（管理员权限），运行下面命令：

wsl --list --online

在这里插入图片描述

安装 Ubuntu-20.04：

wsl --install -d Ubuntu-20.04

如果在这一步显示操作超时，大概率是没打开 Windows 虚拟机监控程序平台，可以在控制面板–>程序和功能里面打开
在这里插入图片描述

打开后重启再次安装就可以了，这一步稍微有点慢，需要等待一会，等待安装成功后界面如下：

等待启动完成后，会弹出 Ubuntu 界面并要求你创建新用户，安装要求输入用户名和密码然后按 Ctrl + D 退出即可：
在这里插入图片描述
然后导出 Ubuntu-20.04 为 .tar 文件：

wsl --export Ubuntu-20.04 D:\WSL\Ubuntu-20.04\Ubuntu-20.04.tar

这会下载 Ubuntu-20.04 并将其导出到 D:\WSL\Ubuntu-20.04\Ubuntu-20.04.tar，然后可以执行ls D:\WSL\Ubuntu-20.04查看Ubuntu-20.04.tar已经成功导出。
在这里插入图片描述
取消注册原有的 Ubuntu-20.04，如果你已经安装了 Ubuntu-20.04（默认在 C 盘），可以将其从 WSL 注销：：

wsl --unregister Ubuntu-20.04

在这里插入图片描述
等待注销完成后我们就可以导入 Ubuntu-20.04 到 D 盘：

wsl --import Ubuntu-20.04 D:\WSL\Ubuntu-20.04 D:\WSL\Ubuntu-20.04\Ubuntu-20.04.tar --version 2

安装成功后，会在 D:\WSL\Ubuntu-20.04 目录下，WSL2 发行版的文件存储在一个虚拟磁盘映像文件（ext4.vhdx）中，该文件用于存储整个 Ubuntu-20.04 文件系统，如下图所示：
在这里插入图片描述
导入完成后，你可以输入一下命令启动 WSL：

wsl -d Ubuntu-20.04

但是这一般有个问题，就是启动后显示为root权限：
在这里插入图片描述
这是因为 WSL 手动导入的 Ubuntu 不会自动创建普通用户，需要我们手动创建，创建新用户，在 WSL 终端（默认 root）下运行：

adduser yourusername # yourusername用自己想创建的名字

在创建好用户之后我们在给它赋上权限即可：

usermod -aG sudo yourusername # yourusername用自己创建的名字

在上述操作完成后我们需要更改默认登录用户，设置为刚设置的普通用户，这里要记得是重新打开 PowerShell（管理员权限）然后输入：

ubuntu2004 config --default-user yourusername # yourusername用自己创建的名字

再次启动 WSL 测试一下是否设置成功：

wsl -d Ubuntu-20.04

在这里插入图片描述
可以看到以及设置成功了，到这里 Ubuntu-20.04 算是彻底安装成功了。

3. Docker Desktop安装 + 汉化完整指南

Docker Desktop：是 Docker 官方为桌面操作系统（如 Windows 和 macOS）专门开发的一款应用程序。它基于 Docker 核心技术构建，为用户提供了便捷的方式来使用 Docker 的各项特性，接下来我们就来安装 Docker Desktop。

在 Windows 上使用 Docker Desktop 依赖 WSL 2 作为后端运行环境。因此，在安装 Docker Desktop 之前，就需要先安装 WSL 2 并配置至少一个 Linux 发行版（如 Ubuntu），所以这也是我们上面安装 WSL 2 以及 Ubuntu 的原因。

下载

安装 Docker Desktop 首先需要进入官网下载：https://www.docker.com/
点击页面上的“Download for Windows - AMD64”按钮，以下载适用于 Windows 系统的 Docker Desktop 安装文件。
在这里插入图片描述

安装

双击下载的安装文件，开始安装 Docker Desktop。
安装过程如下，这里不过多赘述，建议按一下步骤直接点就可以：
在这里插入图片描述

解释：

使用WSL2代替 Hyper-V (推荐)
允许使用 Windows 容器进行此安装
添加快捷方式到桌面

然后等待安装完成重启即可。
在这里插入图片描述

配置

首次打开时，将出现 Docker 订阅协议，点击 Accept（接受）以继续。
随后，系统将提示用户登录。您可以选择使用 GitHub 账户或 Google 账户登录，若无上述账户，可选择跳过登录步骤。
在这里插入图片描述
接下来，会出现调查问卷，您可以根据个人喜好选择填写，或直接跳过此步骤。

到这一步就算是结束了 Docker Desktop 已经正常启动。

下面是汉化步骤，根据个人情况自取：

汉化

访问 GitHub，下载适用于 Docker Desktop 的中文语言包，链接地址为：https://github.com/asxez/DockerDesktop-CN
在这里插入图片描述
将下载的文件解压至 C:\Program Files\Docker 目录下（即 Docker 的安装根目录）。

然后关闭 Docker Desktop，在Docker安装目录找到 app.asar 文件并将其备份，防止出现意外，Windows下默认为 C:\Program Files\Docker\Docker\frontend\resources：
在这里插入图片描述
将从本仓库下载的asar文件改名为 app.asar 后替换原文件，最后效果如图：