Windows-安装WSL踩坑

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

#WSL #windows

Windows与windows Server

最近在用一台Windows服务器安装linux子系统，在尝试采用常规命令安装Ubun系统时，一直在报错：

正在安装: Ubuntu
安装过程中出现错误。分发名称: ‘Ubuntu’ 错误代码: 0x8000ffff

两个系统存在不同的安装方法，区别很大
在这里插入图片描述
链接

【ubuntu22.04 安装软件报错】
tianyazhichiC的博客
07-10 1200
ubuntu22.04 安装软件报错。
每天学点小知识：WSL安装Ubuntu 22.04 LTS
unravel_tom的博客
05-31 1363
本章教会你在不使用虚拟机下使用linux，但是这里建议还是使用虚拟机，或者装一双系统，wsl使用linux还是有很多问题的。WSL（Windows Subsystem for Linux）是微软为Windows 10及以上版本开发的一项功能，它允许用户在Windows系统上运行Linux操作系统。WSL提供了一个兼容层，使得Linux二进制可执行文件可以在Windows上原生运行，而不需要虚拟机或双重启动。WSL 1：最早版本，通过Linux兼容层在Windows上运行Linux二进制文件。
Ubuntu-20.04：安装Ubuntu 20.04 LTS时要做的事情
02-16
Ubuntu 20.04的安装 文件是一个可执行文件，它将卸载Ubuntu中默认提供的一些讨厌的程序并安装其他程序（它要求您安装或删除每个程序。） 要使其可执行，您必须： chmod +x setup.sh 另外，您还必须以sudo的身份运行文件： sudo ./setup.sh 将会安装： 板 NVDIA驱动程序 信号桌面 Visual Studio程式码 WPS 将删除： 所有Ubuntu和Gnome游戏 自由办公室 雷鸟 贡献 可以随意在“或文件中包括任何程序或软件。 您可以在查看有关如何运行文件（或和的文件）的教程。
用Windows的WSL功能安装Ubuntu过程中出现的问题
最新发布
black_Gh的博客
08-18 711
但这里要说明一点就是，在微软商店下载了Ubuntu后直接点击打开就会出现一开始我贴的那张图的命令行结果，其实是可以在里面直接回车来安装WSL的，但是这个窗口会慢到你怀疑人生，我一个小时才下载百分之28，后来它还自己停止了，然后我就自己重新开了一个PowerShell重新下载，就很快了。还有一个问题就是我的VPN无法与微软商店共存，这个问题不知道是为什么，因为我不是很了解VPN，所以我没办法做出解释，但是如果微软商店出现了无法联网这样的提示，可以选择讲VPN关掉。
【WSL】不存在具有所提供名称的分发。 Error code: Wsl/Service/WSL_E_DISTRO_NOT_FOUND 已退出进程，代码为 4294967295
HEX9CF的技术博客
11-21 5831
在尝试启动某个分发版时遇到问题。错误信息为：“不存在具有所提供名称的分发。”，错误代码为，即分发版未找到。
Win10下安装Ubuntu18.04可能遇到的一些问题总结（1）
Westdream33的博客
11-12 1422
Win10下安装Ubuntu18.04可能遇到的一些问题总结（1） 本人Linux小白一枚，最近的项目需要用到Linux系统，因此在Win10下尝试安装Linux18.04并且安装英伟达显卡驱动。网上教程非常多，但是每个人的电脑环境都不相同，安装过程可能会遇到各种问题，因此本贴想记录一下安装过程中出现的一些错误和教训（不停地找问题真的很费时间），如果大家遇到和我相同的问题可以给你一些参考，节省自己的时间。 前言 网上教程非常多，因为我也是小白，自己写安装教程怕误导各位，因此本帖只记录我安装过程中出现的问题
win10使用wsl2安装Ubuntu过程及报错解决
weixin_43883043的博客
12-13 2417
win10使用wsl2安装Ubuntu过程及报错解决
标签risc-v复现踩坑指南1
08-03
- 建议使用基于 Linux 的环境，如 WSL (Windows Subsystem for Linux) 或虚拟机，因为大部分工具和代码需要在 Linux 环境下运行。 - 小心处理文件换行符和符号链接，避免在不同操作系统之间转换导致问题。 3. **...
服务器系统2022安装wsl2,手把手教你踩坑：老白的Docker for Windows安装初探WSL 2 backend...
weixin_39564527的博客
08-10 3754
手把手教你踩坑：老白的Docker for Windows安装初探WSL 2 backend2020-06-16 13:29:4715点赞63收藏4评论创作立场声明：老白的踩坑记录嗨，大家好！前几日老白对Docker for Windows进行了一个初步的安装测试，总体感觉确实比较慢。在文末也提到了我的新发现，于是一顿神操作卸载再试一波。 看看Docker Desktop WSL 2 backen...
【24年9月亲测可用】Windows11-WSL2-Ubuntu22.04-可视化桌面安装教程（附带CUDA，cuDNN）
Leo9344的博客
09-07 6847
Windows11-WSL2-Ubuntu22.04 安装可视化桌面和CUDA，cuDNN的教程
痛苦的windows WSL2的CUDA安装过程
qq_45505081的博客
08-05 5165
在做深度学的过程中，发现大部分的情况下都是在Linux系统的环境下做的。经过多番查找，发现WSL2，这个虚拟机是可以直接调用CUDA 运算的，而且有人安装成功并跑通了。，本电脑是win10 22H2版本，如果之前有安装过Virtua Box 虚拟机的话会显示叫你卸载Virtualbox 才能升级，我这边明明都卸载了，还显示未卸载，纳闷了很久，找了一波，终于找到了。不要在微软商店安装Ubuntu20.04，会直接安装在C盘上面的，C盘安装虚拟机，真的很炸裂。至此WSL2的Ubuntu虚拟机初步完成安装了。
Deepseek应用技巧-Dify安装和踩坑指南
qq_35991370的博客
05-29 1281
本节介绍了如果安装docker的环境，以及如何使用git进行Dify的部署安装，这一节的技能十分的实用，为后续的AI工作流和智能体的搭建创造了基础。
WSL 安装过程中出现错误。分发名称: ‘Ubuntu 24.04 LTS‘ 错误代码: 0x8000ffff
hello443的博客
06-06 1689
在windows server 2022中安装wsl2的ubuntu分发包(通过该命令执行：wsl --install -d Ubuntu-22.04)，出现下面错误：WSL 安装过程中出现错误。分发名称: 'Ubuntu 24.04 LTS' 错误代码: 0x8000ffff。解决办法：先执行wsl --update， 然后再重新执行wsl --install -d Ubuntu-22.04，如提示重启计算机，重启后再次执行wsl --install -d Ubuntu-22.04即可。
安装: Ubuntu 20.04 LTS 错误代码: 0x80070005
hjhlying的博客
07-05 4340
正在安装: Ubuntu 20.04 LTS安装过程中出现错误。分发名称: ‘Ubuntu 20.04 LTS’ 错误代码: 0x80070005。
手动安装Ubuntu子系统
qq_41017399的博客
04-25 1350
手动安装Ubuntu子系统 Windows的应用商店在重装系统后显示无法联网，按照微软官网上的几种方法都试了一些，还是没有解决。 所以就不能从应用商店下载Ubuntu的子系统来安装了（并且一些命令也不能用，比如lxrun什么的，因为是最新版的win10），只能手动去官网下载安装包自己安装，下载地址为https://docs.microsoft.com/en-us/windows/wsl/insta...
Ubuntu20.04.4 LTS正确安装方案及问题解决
新生代农民工Steven
11-16 5724
Ubuntu 20.04.4 LTS 报错解决方案
0x8000FFFF 错误的解决方式
热门推荐
GetcharZp的博客
03-06 2万+
问题描述： 在F盘新建文件夹或文件的时候提示0x8000FFFF灾难性错误； 解决方法： 1、在F盘的位置，右击选择属性 2、在弹出的窗口中选择工具，点击检查 3、根据系统提示进行响应的驱动扫描与修复，就酱紫咯 ...
win11中wsl安装Ubuntu20.04运行base出现报错
drwyan的博客
02-20 535
do这些错误提示表明你的脚本文件包含 Windows 风格的换行符（\r\n），而在 Unix/Linux 系统中，脚本通常使用 Unix 风格的换行符（\n\r（回车符）在 Unix/Linux 系统中被视为一个普通字符，当 Bash 解析脚本时，它会把\r当作命令的一部分，从而导致错误。解决方法。
windows paperless-ngx安装
06-06
<think>嗯，用户想要在Windows上安装和配置paperless-ngx，这有点特殊，因为官方主要支持Docker部署。用户可能是普通家庭用户或小型办公用户，想搭建个人文档管理系统。ta明确提到了Windows环境，但paperless-ngx的官方文档主要针对Linux/Docker，这说明用户需要的是Windows兼容方案。从引用看，用户已经接触到一些安装资料，但都是基于Linux的脚本或DockerCompose。用户现在卡在如何适配Windows的问题上，深层需求可能是想实现类似Linux一键脚本的便捷安装体验。技术难点在于：1Windows原生不支持shell脚本，直接运行install-paperless-ngx.sh不可行2DockerDesktop虽能运行容器，但官方安装脚本依赖Linux环境3用户可能需要图形界面操作指引我可以拆解为两种解决方案：纯Docker方式和WSL2方式。优先推荐DockerDesktop方案，因为更符合Windows用户习惯。需要特别注意Windows下的目录映射规范（反斜杠路径问题），这是常见踩坑点。另外要强调OCR语言包的安装步骤，很多用户会忽略这个。用户可能没意识到持久化存储的重要性，需要提醒volumes的配置。还要预判后续的远程访问需求，所以补充内网穿透方案。固定公网地址的部分引用自用户提供的资料[^3][^4]，保持信息一致性。</think> 在 Windows 系统上安装 Paperless-ngx 的核心是**通过 Docker Desktop 部署容器**。以下是详细步骤： --- ### 📦 **安装前准备** 1. **安装 Docker Desktop** - 访问 [Docker 官网](https://www.docker.com/products/docker-desktop/) 下载安装包 - 安装时勾选 *Use WSL 2 instead of Hyper-V*（需启用 Windows 的 WSL2 功能） - 安装完成后重启系统 2. **配置资源（可选）** - 右键系统托盘 Docker 图标 → *Settings* → *Resources* - 建议分配：**CPU≥2核 | 内存≥4GB | Swap≥1GB**（处理大量文档时需更高配置） --- ### 🚀 **安装 Paperless-ngx** #### 方法一：使用 Docker Compose（推荐） 1. **创建 `docker-compose.yml` 文件** 新建目录（如 `C:\paperless`），创建 `docker-compose.yml` 文件并粘贴以下内容： ```yaml version: "3.4" services: broker: image: docker.io/library/redis:7 restart: unless-stopped volumes: - redisdata:/data db: image: docker.io/library/postgres:13 restart: unless-stopped volumes: - pgdata:/var/lib/postgresql/data environment: POSTGRES_DB: paperless POSTGRES_USER: paperless POSTGRES_PASSWORD: paperless webserver: image: ghcr.io/paperless-ngx/paperless-ngx:latest restart: unless-stopped depends_on: - db - broker volumes: - data:/usr/src/paperless/data - media:/usr/src/paperless/media - ./export:/usr/src/paperless/export - ./consume:/usr/src/paperless/consume environment: PAPERLESS_REDIS: redis://broker:6379 PAPERLESS_DBHOST: db PAPERLESS_DBNAME: paperless PAPERLESS_DBUSER: paperless PAPERLESS_DBPASS: paperless ports: - "8000:8000" volumes: data: media: redisdata: pgdata: ``` 2. **启动容器** 在 `C:\paperless` 目录打开 PowerShell 或 CMD，执行： ```bash docker compose up -d ``` --- #### 方法二：直接运行容器 ```bash docker run -d \ -p 8000:8000 \ -v C:/paperless/data:/usr/src/paperless/data \ -v C:/paperless/media:/usr/src/paperless/media \ -v C:/paperless/export:/usr/src/paperless/export \ -v C:/paperless/consume:/usr/src/paperless/consume \ ghcr.io/paperless-ngx/paperless-ngx:latest ``` --- ### ⚙️ **初始配置** 1. **访问管理后台** 浏览器打开 `http://localhost:8000` - 初始账号：`admin` - 初始密码：`admin`（首次登录需修改） 2. **配置 OCR 语言** 在容器内执行命令安装中文 OCR 包： ```bash docker exec -it <容器名> /usr/src/paperless/manage.py document_install_languages zh-hans ``` 3. **设置文档消费目录** - 将待扫描文档放入 `C:\paperless\consume` - 系统会自动处理（OCR、分类、存储） --- ### 🌐 **远程访问（可选）** 参考引用 [^3][^4] 使用 **cpolar** 或 **frp** 实现公网访问： 1. 安装内网穿透工具（如 cpolar） 2. 创建 HTTP 隧道映射本地 `8000` 端口 3. 通过生成的公网地址远程访问 > ⚠️ **注意：暴露到公网需配置强密码并启用 HTTPS（可通过 Nginx 反向代理实现）** --- ### 🛠️ **故障排查** | 问题现象 | 解决方案 | |---------------------------|------------------------------| | 启动时报端口冲突 | 修改 `docker-compose.yml` 中的 `8000:8000` 为其他端口 | | OCR 中文识别失败 | 检查是否已安装 `zh-hans` 语言包 | | 上传文档未自动处理 | 确认 `consume` 目录映射正确，且文件权限为可读 | --- **总结关键路径**： ```mermaid graph LR A[安装 Docker Desktop] --> B[创建 docker-compose.yml] B --> C[启动容器] C --> D[访问 localhost:8000 配置] D --> E[安装中文 OCR] E --> F[放入文档到 consume 目录] ``` 💡 提示：定期备份 `C:\paperless` 下的 `data`、`media`、`export` 目录可防止数据丢失[^4]。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

云朵不吃雨

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值