【Docker】X-DOC：使用WSL在Windows中体验Linux发行版&安装桌面版Docker

最新推荐文章于 2025-08-07 14:02:50 发布
原创 最新推荐文章于 2025-08-07 14:02:50 发布 · 1.5k 阅读 · 10 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#docker #容器 #运维 #服务器

【Docker】X-DOC：使用WSL在Windows中体验Linux发行版&安装桌面版Docker

一、系统设置

1、系统虚拟化

不必使用VM虚拟机安装CentOS等Linux发行版，来搭建Docker运行环境，可以直接在Windows系统中，使用WSL来安装桌面端Docker。

1.1、启动虚拟化

任务管理器(CTRL+Shift+Esc), 选择性能，查看CPU虚拟化，确认是否已启用（默认启用）。

在这里插入图片描述

1.2、启动Hyper-V并开启虚拟任务

快捷键Win+R，输入control，进入控制面板
在这里插入图片描述
找到程序与功能，点击
在这里插入图片描述
点击左侧：启用或关闭Windows功能
在这里插入图片描述
在弹出框中选中以下内容，点击确定，进行安装
在这里插入图片描述
在这里插入图片描述

二、安装WSL

1、WSL简介

Windows Subsystem for Linux（简称WSL）是一个在Windows 10\11上能够运行原生Linux二进制可执行文件（ELF格式）的兼容层。它是由微软与Canonical公司合作开发，开发人员可以在 Windows 计算机上同时访问 Windows 和 Linux 的强大功能。 通过适用于 Linux 的 Windows 子系统 (WSL)，开发人员可以安装 Linux 发行版（例如 Ubuntu、OpenSUSE、Kali、Debian、Arch Linux 等），并直接在 Windows 上使用 Linux 应用程序、实用程序和 Bash 命令行工具，不用进行任何修改，也无需承担传统虚拟机或双启动设置的费用。

2、WSL版本

2022年11月16日，微软 Win11/10 Linux 子系统 WSL 1.0.0 正式版发布。
2023年9月19日，微软win11 Linux 子系统WSL 2.0.0预览版发布，引入了全新的内存回收机制。

功能比较：
在这里插入图片描述
从上面的比较表中可以看出，WSL 2 架构在几个方面优于 WSL 1，但跨 OS 文件系统的性能除外，对于这种情况，可通过将项目文件存储在与处理项目时运行的工具相同的操作系统上进行处理。

3、WSL2安装

3.1、检查Windows系统版本

WSL 2 仅适用于 Windows 11 或 Windows 10、版本 1903、内部版本 18362 或更高版本。在安装前需检查Windows版本，方法如下：

按下"Win+R"组合键打开 Windows 操作系统的“运行”对话框，在运行对话框中输入"winver"，然后按下 Enter 键来执行，查看版本号。可以看到我电脑系统为 Windows11 版本为 24H2。
在这里插入图片描述
在这里插入图片描述

3.2、命令行安装WSL2（及默认Linux发行版-Ubuntu）

按下"Win+R"打开运行对话框，输入"powershell"，然后按"Ctrl+Shift+Enter"组合键，以管理员模式打开 PowerShell。输入wsl --install 命令，运行完成后重新启动计算机。


                

                
                
        

    


  


        

            

                      
                        最低0.47元/天 解锁文章
                          
                      
            

        


    



                



	

		

			

				
					
window下使用linux子系统及基于wsl2安装docker

				
			

			

				

					S_ZaiJiangHu的博客
				

				

					03-13
					
					8385
					
				

			

		

		

			
				
wsl2是linux子系统内核，windows内置了它。
1、下载docker for windows
2、应用程序功能 开启虚拟机和linux子系统
3、安装docker
4、可能提示无法运行，需要升级linux内核，https://docs.microsoft.com/zh-cn/windows/wsl/install-manual#step-4—download-the-linux-kernel-update-package下载下就好

...

			
		

	



                

            
              



	

		

			

				
					
WSL安装桌面环境xfce4

				
			

			

				

					weixin_45921884的博客
				

				

					03-25
					
					2518
					
				

			

		

		

			
				
最近想在WSL2里安装一个可视化图形界面，之前装过vcXsrv这种方案，不过最近打不开了，也是尝试了Vnc server 不过容易灰屏，最后在vcXsrv ，Vnc server和 xrdp这3种方案中最终选择了xrdp这种方案，利用Windows的远程连接来连接xfce4桌面。

			
		

	



              


  
              

                


	

		

			

				
					
Win10安装Linux子系统WSL(ubuntu2204)及图形桌面xfce4

				
			

			

				

					Boone的博客
				

				

					02-21
					
					1万+
					
				

			

		

		

			
				
win10 安装linux子系统及图形桌面

			
		

	





	

		

			

				
					
WSL及其桌面环境的安装

				
			

			

				

					万无引力的博客
				

				

					05-31
					
					8653
					
				

			

		

		

			
				
目前wsl的默认体系结构是wsl1



可使用命令行将 WSL1 的转化为WSL2


wsl --set-version <linux发行版全名> 2

如果要使 WSL 2 成为你的默认体系结构：


wsl --set-default-version 2

也可以把WSL2转化为WSL1，只需要把上述命令中的2换成1即可





正文开始

一、安装kde

（1）更新系统依赖到最新状态：


apt update && apt  full-upgrad -y

...

			
		

	



		

			
		



	

		

			

				
					
基于wsl的Ubuntu20.04上安装桌面环境

				
			

			

				

					weixin_51551506的博客
				

				

					04-07
					
					6927
					
				

			

		

		

			
				
由于Ubuntu默认的软件源在国外，有时候后可能会造成下载软件卡顿，这里我们更换为国内的阿里云源，其他国内源亦可。双击打开Ubuntu20.04 LTS图标，在命令行中输入将原来的内容替换为如下所示，然后按Ctrl + O保存，并按Ctrl + X退出编辑模式。

			
		

	





	

		

			

				
					
WSL Ubuntu安装，配置远程桌面、开发环境 指南（Windows Subsystem for Linux）

				
			

			

				

					键盘的起始页
				

				

					07-29
					
					1194
					
				

			

		

		

			
				
前提： 请更新windows为最新的win10或11。

			
		

	





	

		

			

          精选资源
				
					
Win10 WSL运行docker报错：Cannot connect to the Docker daemon at unix:///var/run/docker.sock.

				
			

			

				

					01-20
				

			

		

		

			
				
在Windows 10中使用Windows Subsystem for Linux (WSL) 运行Docker时，可能会遇到“Cannot connect to the Docker daemon at unix:///var/run/docker.sock.”的错误。这个错误通常意味着Docker守护进程（Docker ...

			
		

	





	

		

			

				
					
穷鬼Docker wsl中的Docker冒险:第一话 -- 安装

				
			

			

				

					FujiwariRyou的博客
				

				

					10-15
					
					355
					
				

			

		

		

			
				
【代码】穷鬼Docker wsl中的Docker冒险:第一话 -- 安装。

			
		

	





	

		

			

          精选资源
				
					
Windows10安装WSL2 Ubuntu20.04并设置docker环境的方法

				
			

			

				

					01-09
				

			

		

		

			
				
在Windows 10上安装WSL 2 (Windows Subsystem for Linux 2) 和Ubuntu 20.04，以及配置Docker环境，是许多开发者为了实现跨平台开发和容器化部署的重要步骤。以下是详细的操作步骤：  首先，确认你的Windows 10版本是...

			
		

	





	

		

			

				
					
在 wsl-ubuntu 里通过 docker 启动 gpu-jupyter

				
			

			

				

					engchina的专栏
				

				

					01-19
					
					1518
					
				

			

		

		

			
				
在 wsl-ubuntu 里通过 docker 启动 gpu-jupyter

			
		

	





	

		

			

				
					
【2】【教程】基于Windows Subsystem for Linux（WSL）安装Ubuntu系统并实现原生图形桌面

					
最新发布

				
			

			

				

					FFFsir的博客
				

				

					08-07
					
					3815
					
				

			

		

		

			
				
手把手喂饭教程：基于Windows Subsystem for Linux（WSL）安装Ubuntu系统并实现原生图形桌面

			
		

	





	

		

			

				
					
wsl 安装桌面（Xfce）并远程连接

				
			

			

				

					qq_38641599的博客
				

				

					05-09
					
					1066
					
				

			

		

		

			
				
在 WSL 中安装一个桌面，并通过 Windows 远程桌面连接。本来打算安装 Gnome 桌面，失败了，改成安装 Xfce 桌面。远程使用 xrdp，可以直接通过 Windows 远程桌面连接。Xfce 太简陋，用不习惯。如果你想尝鲜的话，可以跟着本文操作。

			
		

	





	

		

			

				
					
xfce上安装mysql_wsl如何安装使用xfce桌面环境

				
			

			

				

					weixin_34975747的博客
				

				

					01-20
					
					246
					
				

			

		

		

			
				
前言自从微软推出wsl(Windows Subsystem for Linux)之后，真是让人又爱又恨，爱的是系统自身集成了linux系统，不用再开虚拟机了，而且运行很快，感觉很轻量；恨的是目前可能还不是很完备，使用时会出现很多问题。不过随着其日臻完善，也是越来越稳定好用了。今天心血来潮，试着配置一下wsl的桌面环境，先上图，选用的是ubuntu+xfce4。image.pngStep1 更新软件...

			
		

	





	

		

			

				
					
WSL，Ubuntu-24.04如何添加图形桌面环境（Xfce 4）

				
			

			

				

					2301_76459044的博客
				

				

					04-07
					
					5705
					
				

			

		

		

			
				
本文讲解了在WSL里，Ubuntu24.04环境下如何安装Xfce图形桌面环境

			
		

	





	

		

			

				
					
WSL2 Ubuntu22.04安装KDE桌面

					
热门推荐

				
			

			

				

					qq_30448087的博客
				

				

					12-09
					
					1万+
					
				

			

		

		

			
				
总结了国内安装WSL图形化桌面的博客，写了如何在WSL2的Ubuntu上安装KDE桌面，因为安装KDE遇到的一些问题在安装gnome时也会遇到，所以也顺便提及了一下gnome，

			
		

	





	

		

			

				
					
Windows安装WSL子系统及docker，以及WSL和docker配置、使用及问题解决

				
			

			

				

					sym的博客
				

				

					12-11
					
					8659
					
				

			

		

		

			
				
在Windows操作系统中，Ubuntu子系统（也称为Windows Subsystem for Linux, WSL）为开发者提供了一个在Windows环境下运行Linux环境的平台。然而，有时用户在按照Ubuntu子系统或者使用WSL时，可能会遇到各种问题，下面总结一下解决方式。想要在Windows上安装Docker（实际上是基于Hyper-V或者WSL2这两项虚拟化技术），需要开启虚拟化功能，所以不管是对于系统还是硬件都有一定的要求。

			
		

	





	

		

			

				
					
WSL+Ubuntu环境配置+集成桌面保姆级教程（非远程桌面）

				
			

			

				

					m0_72966213的博客
				

				

					05-14
					
					5636
					
				

			

		

		

			
				
该安装指导默认安装在C盘，请确保C盘有足够的空间（150G），若没有足够空间，可用DiskGenius将C盘后面的盘里内容镜像备份迁移，然后再重新导入。

			
		

	





	

		

			

				
					
[windows]给WSL安装一个桌面gnome版本

				
			

			

				

					FL1623863129的博客
				

				

					01-18
					
					2545
					
				

			

		

		

			
				
确认systemctl能用，出来一堆log，失败的话会是System has not been booted with systemd as init system (PID 1). Can't operate.请对应自己系统版本号，如果是22.04则输入wsl --set-version Ubuntu-22.04 2。输入ip地址:3390或者localhost:3390，用户名输入你的用户名（比如：我的是u）安装完systemd之后，退回windows终端（直接叉掉这个终端就行），务必输入。

			
		

	





	

		

			

				
					
windows10安装docker的步骤，为了在vscode中使用kkfileview预览功能

				
			

			

				

					06-12
				

			

		

		

			
				
<think>我们在回答用户的问题时，需要分为两个部分：1.Windows10安装Docker的详细步骤2.在VSCode中配置使用kkfileview实现文件预览的教程由于用户提到要在VSCode中使用kkfileview，而kkfileview是一个基于Java的文件预览开源项目，通常需要运行在服务端。因此，我们安装Docker后，需要拉取kkfileview的Docker镜像并运行容器。然后在VSCode中配置使用该服务。注意：在Windows10上安装Docker，需要确保系统满足要求（64位操作系统，Windows101903或更高版本，支持Hyper-V和WSL2.0）。如果用户系统版本较低，可能需要升级。步骤：第一部分：安装Docker1.确保系统满足要求：Windows101903（Build18362）或更高版本，并且启用Hyper-V和WSL2。如果未启用，请参考步骤2。2.启用Hyper-V和WSL2：在“控制面板”->“程序”->“启用或关闭Windows功能”中勾选“Hyper-V”和“适用于Linux的Windows子系统”，然后重启电脑。3.下载DockerDesktop：从Docker官网下载DockerDesktopforWindows安装程序。4.安装DockerDesktop：双击安装程序，按照向导完成安装。5.启动DockerDesktop：安装完成后，从开始菜单启动DockerDesktop。等待Docker启动完成（系统托盘出现Docker图标）。6.验证安装：打开命令提示符（CMD）或PowerShell，运行命令`docker--version`和`dockerrunhello-world`验证安装是否成功。第二部分：在Docker中运行kkfileview1.拉取kkfileview的Docker镜像：在命令提示符或PowerShell中运行`dockerpullkeking/kkfileview`2.运行kkfileview容器：`dockerrun-d-p8012:8012--namekkfileviewkeking/kkfileview`-参数说明：-d表示后台运行，-p指定端口映射（主机端口8012映射到容器端口8012），--name指定容器名称。3.验证容器运行：`dockerps`查看运行中的容器。然后在浏览器中访问http://localhost:8012应该可以看到kkfileview的演示页面。第三部分：在VSCode中配置使用kkfileview预览文件kkfileview是一个服务，它提供HTTP接口来预览文件。在VSCode中，我们可以通过安装支持http文件预览的插件，或者通过配置自定义预览来实现。但是，目前并没有直接集成kkfileview的VSCode插件。因此，我们可以通过以下方法实现：方法1：使用现有的文件预览插件，如“ViewInBrowser”插件，但这种方式主要针对网页文件。对于其他文件类型（如office文档），kkfileview提供的是在线预览的URL，因此我们可以在VSCode中通过打开浏览器来预览。方法2：自行编写VSCode扩展，但考虑到用户可能只需要简单的预览功能，我们可以推荐使用在浏览器中预览的方式。配置步骤（方法1）：1.在VSCode中安装扩展“ViewInBrowser”：在扩展商店搜索并安装“ViewInBrowser”。2.打开一个文件（例如一个PDF文档），右键选择“在浏览器中打开”或使用快捷键（Ctrl+F1）。注意：此时默认打开的地址是本地文件路径（file:///C:/...），但kkfileview需要将文件上传或通过URL访问。3.因此，我们需要先将文件通过HTTP方式暴露出来，比如使用本地HTTP服务器（例如使用Python的SimpleHTTPServer模块），然后生成该文件的URL，再拼接到kkfileview的预览接口。然而，这种方法需要多个步骤，略显复杂。更简便的方法是，我们可以通过一个简单的脚本来实现：在本地启动一个HTTP服务器，并自动生成kkfileview的预览链接在浏览器中打开。考虑到用户操作的便捷性，我们可以提供一个Python脚本（或Node.js脚本）作为辅助。但这里为了简化，我们使用一个更直接的方式：使用kkfileview提供的接口，手动上传文件。但是，kkfileview也支持直接通过URL预览，所以如果我们能将文件放在一个可访问的URL下，就可以用如下链接预览：http://localhost:8012/onlinePreview?url=文件的URL因此，我们需要一个本地HTTP服务器来提供文件。我们可以使用VSCode的扩展“LiveServer”来快速启动一个本地服务器，然后获取文件的URL，再使用上述格式的链接进行预览。实际步骤（使用LiveServer和浏览器）：1.在VSCode中安装“LiveServer”扩展（由RitwickDey提供）。2.在文件资源管理器中右键单击你要预览的文件，选择“OpenwithLiveServer”。此时会打开浏览器，显示该文件（如果是网页文件，会直接显示；如果是下载文件，浏览器可能会直接下载，所以我们需要复制URL）。3.复制该文件的URL（例如：http://127.0.0.1:5500/example.docx）。4.然后打开一个新的浏览器标签页，输入：http://localhost:8012/onlinePreview?url=http://127.0.0.1:5500/example.docx这样即可预览文件。不过，每次都要手动拼接URL比较麻烦。我们可以写一个VSCode的脚本扩展来自动完成，或者使用一个简单的VSCode扩展。但目前没有现成的扩展，所以这里介绍手动方式。另一种方式是使用kkfileview的本地文件预览功能：启动容器时挂载本地目录，这样可以通过kkfileview的接口直接访问本地文件。但是kkfileview的Docker镜像默认不支持直接读取本地文件（因为安全考虑）。所以我们需要在启动容器时挂载本地目录，然后通过kkfileview的file参数传递本地文件路径（在容器内部路径）。启动容器命令修改为：dockerrun-d-p8012:8012-v/c/Users/yourusername:/home/file--namekkfileviewkeking/kkfileview注意：在Windows下，路径映射需要遵循Docker的规则。例如，Windows的C盘映射为/c。然后，在浏览器中访问：http://localhost:8012/onlinePreview?filePath=/home/file/test.docx但是，这种方法需要将文件放在挂载的目录下。考虑到用户的使用便利性，我们推荐第一种使用URL的方式，因为这样更通用。而挂载目录的方式可能在文件更新后还需要刷新等问题。因此，总结在VSCode中预览的步骤（使用LiveServer）：步骤1：在VSCode中打开文件所在的工作区。步骤2：使用LiveServer启动该工作区的服务器（在资源管理器右键文件夹选择“OpenwithLiveServer”）。记下根地址，比如http://127.0.0.1:5500。步骤3：在VSCode中右键点击要预览的文件，选择“OpenwithLiveServer”，此时该文件会在浏览器中打开（如果浏览器直接下载，则复制地址栏的URL，注意这可能是该文件的下载地址，直接使用即可）。步骤4：然后使用这个URL，构造如下预览链接：http://localhost:8012/onlinePreview?url=步骤3中复制的URL步骤5：在浏览器中打开步骤4的链接，即可预览。注意：kkfileview支持预览的格式包括：doc,docx,ppt,pptx,xls,xlsx,pdf等。最后，我们提供相关问题和回答的结构。注意：用户的问题中提到了“参考站内引用”，但我们的回答中并没有现成的引用，所以我们按照实际情况写。如果有引用，我们会添加引用标识。由于这是技术指导，我们不需要添加引用标识，因为内容都是常规步骤。下面按照用户的要求，生成相关问题。</think>
### Windows 10 安装 Docker 及 VSCode 配置 kkFileView 教程

#### **一、Windows 10 安装 Docker 步骤**  
1. **系统要求验证**  
   - 确认系统版本为 Windows 10 Build 19044+（Win+R输入`winver`检查）
   - 开启 Hyper-V 和 WSL 2：  
     ```powershell
     dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart
     wsl --install
     ```
     重启计算机（需 BIOS 启用虚拟化支持）

2. **下载 Docker Desktop**  
   - 访问 [Docker 官网](https://www.docker.com/products/docker-desktop) 下载 Windows 版本安装包

3. **安装与配置**  
   - 双击安装包 → 勾选 **`Enable WSL 2 Features`** → 完成安装
   - 启动 Docker Desktop → 右托盘图标 > Settings > Resources > WSL Integration → 启用 WSL 2
   - 验证安装：
     ```powershell
     docker --version  # 显示版本如 Docker version 24.0.7
     docker run hello-world  # 运行测试容器
     ```

#### **二、配置 kkFileView 文件预览服务**  
1. **启动 kkFileView 容器**  
   ```powershell
   docker run -d -p 8012:8012 --name kkfileview keking/kkfileview
   ```
   - `-d`：后台运行容器  
   - `-p 8012:8012`：主机端口映射容器端口[^1]

2. **验证服务**  
   - 浏览器访问 `http://localhost:8012`，看到文档预览界面即成功
   - 查看日志：`docker logs kkfileview`

#### **三、VSCode 集成配置**  
1. **安装必备扩展**  
   - 安装官方扩展：**Remote - Containers**
   - 可选扩展：**REST Client**（用于测试接口）

2. **配置文件预览**  
   - 在 VSCode 中创建测试文件 `test.http`：
     ```
     GET http://localhost:8012/onlinePreview?url=http://example.com/sample.docx
     ```
   - 右键发送请求 → 返回预览页面 URL  
   - **实际应用**：  
     将本地文件上传至服务端（如通过 Python HTTP 服务提供文件 URL）

#### **四、常见问题解决**  
- **端口冲突**：修改 `-p 新端口:8012`  
- **文件无法访问**：  
  - 添加目录挂载：`-v C:/files:/opt/kkFileView-4.1.0/file`  
  - 访问 `?filePath=/opt/.../file/sample.docx`
- **WSL 错误**：更新内核包：[WSL2 Linux 内核更新](https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package)

---

### 📚 相关问题
1. 如何优化 Docker 容器性能避免 VSCode 卡顿？  
2. kkFileView 支持哪些文件格式的预览？如何处理不支持的格式？  
3. 如何在局域网中共享 kkFileView 服务供其他设备访问？  
4. 如何通过 Docker Compose 管理 kkFileView 及其依赖服务？  

[^1]: 关于端口映射原理详见 Docker 文档 [网络配置](https://docs.docker.com/config/containers/container-networking/)

			
		

	



              




          




        



    





    



      

      

        
      

      





	

		评论	
	

  
	




  

    

      添加红包
      
    

    

      

        
        

          
          
        

        
请填写红包祝福语或标题

      

      

        
        

          
          个
        

        
红包个数最小为10个

      

      

        
        

          
          元
        

        
红包金额最低5元

      

      

        
        

          当前余额3.43元
          前往充值 >
        

      

      

        

          需支付：10.00元
        

        
        
      

    

  





  

    
    
  

  

    
    
  








  

    

      

        

          

            
            
成就一亿技术人!

          

          

        

        

          

          

            领取后你会自动成为博主和红包主的粉丝
            规则
          

        

      

      

        

          

            
              
            
            

              
hope_wisdom
 发出的红包
            

          

        

        

          

          

          

        

      

    

    

  



      
      

      
实付元

      
使用余额支付

      

        

          

            
            点击重新获取
          

        

        
扫码支付

      

      

        
          
            
          
          
        
      

      

        
        钱包余额
          0
          

            
            

              

                
抵扣说明：

                
 1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
 2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

              

            

          

      

      余额充值