前言
在现代软件开发和人工智能应用中,环境的稳定性和可移植性至关重要。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 或更高)。
3. 手动更新 WSL
-
Windows 更新完毕后,以管理员身份运行
PowerShell
执行:wsl --update
-
如果一切正常,然后运行,你会看到如下图所示,说明 WSL 已成功更新!
wsl --version
4. 重新启动 Docker Desktop
-
重新启动 Docker Desktop 后可以看到不再弹出报错