首页 前端知识 一篇就够!Windows上Docker Desktop安装 汉化完整指南(包含解决wsl更新失败方案)

一篇就够!Windows上Docker Desktop安装 汉化完整指南(包含解决wsl更新失败方案)

2025-03-19 11:03:50 前端知识 前端哥 312 506 我要收藏

前言

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

本教程将详细介绍在 WindowsDocker 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版本 为是 21H2WSL2 需要至少满足 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 后可以看到不再弹出报错

    在这里插入图片描述

转载请注明出处或者链接地址:https://www.qianduange.cn//article/24123.html
标签
评论
发布的文章

dify安装

2025-03-19 11:03:51

Docker

2025-03-19 11:03:46

大家推荐的文章
会员中心 联系我 留言建议 回顶部
复制成功!