WinFsp 2.0.23075 中文介绍与使用教程:Windows 上的 FUSE 文件系统框架

WinFsp(Windows File System Proxy,中文常译「Windows 文件系统代理」)是 Windows 上的 FUSE 实现:在 Linux 上,FUSE 让你能以普通用户权限编写自己的文件系统;WinFsp 把同一套思路搬到了 Windows,让文件系统的实现是一个普通的用户态程序,而不需要去写内核驱动。装上它之后,第三方工具就能把远程磁盘、内存文件系统、加密容器、对象存储挂载成 Windows 盘符。

它是很多「挂载类」工具的必备底座——最典型的就是 SSHFS-Win(把远程 Linux 目录挂成盘符)、rclone-win(把云盘挂成盘符)、Dokany 等。没有 WinFsp,这些工具连装都装不上,或者装上也无法挂载。

本文以 WinFsp 2.0.23075(对外名称 WinFsp 2023,2023-03-16 发布)的官方 MSI 安装包 winfsp-2.0.23075.msi 为主线,整理 GitHub Releases 与直链、百度网盘备用链接、2.x 主版本的重大变化、MEMFS 快速开始实操,以及安装与排障要点。

先把渠道说清:官方仓库是 github.com/winfsp/winfsp,安装包直接放在 Releases 里;你给的 github.com/billziss-gh/winfsp/releases 同样有效——那是 GitHub 组织改名后的旧地址,会 301 跳转到现在的 winfsp/winfsp。官网 winfsp.dev/rel/ 上的安装包与 Releases 是同一份。

一、WinFsp 是什么

WinFsp 由两部分组成,理解这个结构,后面的安装选项和目录就都不奇怪了:

组件 说明
内核模式文件系统驱动(FSD) 与 Windows 内核交互,负责把自己呈现为一个文件系统驱动。这是唯一需要内核权限的部分
用户态 DLL 与 FSD 通信,把「打开文件、读、写、设置属性」等请求转发给用户态的文件系统程序

当你在资源管理器里双击一个 WinFsp 盘符里的文件时,链路是:资源管理器 → Windows 文件 API → FSD → 用户态 DLL → 你的文件系统程序 → 真正的存储后端。所有「重活」都发生在普通用户态程序里,这是 WinFsp 相比内核驱动最大的价值:写起来像写普通程序,崩了也不会拖垮系统。

官方对它的定位是「成熟、稳定、自包含、无外部依赖」,并明确表示没有已知的崩溃与资源泄漏问题;性能上官方称在很多场景下与 NTFS 相当,某些场景甚至更快。官网同时列出它被大型软件公司、云服务商与金融机构使用。

二、核心功能特性

特性 说明
用户态文件系统 无需内核编程即可实现自定义文件系统,任何 Windows 应用都能通过标准文件 API 访问
四套 API 原生 WinFsp API、FUSE 2.8 兼容层、FUSE 3.2 兼容层、.NET API,均可用于 C / C++ / .NET
内核模式支持 自 2019.3 起也支持开发内核模式文件系统,官方另有专门文档说明
Shell 集成 提供把用户态文件系统集成进 Windows 外壳(资源管理器)的能力,见「服务架构」文档
多实例部署 2.x 起可并存多个实例,驱动名形如 winfsp+<InstanceID>,程序文件装在独立的 SxS 目录里
自包含 不依赖系统外部组件,装上即可用
广泛使用 开源与商业应用都在用,官方称安装量以百万计(不追踪具体用户数)
跨架构 支持 x86、x64 与 ARM64,Windows 7 至 Windows 11
许可证灵活 GPLv3 + 自由/开源软件例外;同时提供商业许可,闭源分发可单独授权
配套工具 fsptool(文件系统管理)、launcher(服务启动器)、完整的测试套件与 MEMFS 示例
调试符号 单独发布在 github.com/winfsp/winfsp.sym 仓库,便于抓栈分析

三、版本信息与系统要求

项目 说明
本文版本 2.0.23075,对外名称 WinFsp 2023,发布于 2023-03-16,对应 GitHub Release 标签 v2.0
2.x 主版本变化 从 1.x 升级到 2.x 属主版本变更,官方说明没有不向后兼容的 API 变更,但变化足够多因此升主版本号
最重要的新特性 支持卸载并重装 WinFsp 而无需重启。今后 winfsp-2.x.y.msi 可直接覆盖升级同代的旧安装包
升级限制 2.x 的安装包不能直接覆盖 1.x 的旧版:必须先卸载 winfsp-1.x.y.msi(可能需要重启),再装 2.x
目录结构变化 可执行文件默认装到 C:\Program Files (x86)\WinFsp\SxS\sxs.<InstanceID>\bin;原来的 C:\Program Files (x86)\WinFsp\bin 现在是一个指向新目录的目录联接(junction)。老脚本里写死旧路径一般仍可用
驱动名变化 驱动不再叫 winfsp,而是 winfsp+<InstanceID> 这类形式。用 sc.exe 管理驱动因此没以前方便,改用 fsptool
工具增强 fsptool 新增 lsdrv、load、unload、ver 四个命令,可从命令行管理驱动
行为变化 此前 WinFsp 驱动除非用户态文件系统主动请求,否则不会卸载卷;从 2.0 起支持由文件系统侧主动卸载
系统要求 支持 Windows 7 至 Windows 11,含 x86 / x64 / ARM64;安装需要管理员权限,运行用户态文件系统通常不需要
安装包体积 winfsp-2.0.23075.msi 为 2,207,744 字节(约 2.1 MB),非常轻量
最新稳定版 2.1.25156(WinFsp 2025),发布于 2025-06-05;另有测试版 2.2.26286(WinFsp 2026 Beta5,2026-10-13)
授权 GPLv3 + 对自由/开源软件的特殊例外;同时提供商业许可(闭源分发需单独授权)

版本号怎么读:2.0.23075 中 2.0 是主次版本(对应「WinFsp 2023」这个对外代号),23075 是构建号。用哪个版本不影响你能不能用 SSHFS-Win——SSHFS-Win 只要求「WinFsp 2020 或更高」,2.0 与 2.1 都完全满足。

四、下载与安装

1. 选对安装包

版本 说明
2.0.23075(本文示例,WinFsp 2023) 与 SSHFS-Win 官方下载页配套的稳定版本,兼容性最好,约 2.1 MB
2.1.25156(WinFsp 2025) 当前官方稳定版,新版特性与修复更多,同样满足 SSHFS-Win 的要求
2.2.26286(WinFsp 2026 Beta5) 测试版本,会变化,适合尝鲜与反馈问题,不建议用于生产环境

2. 安装步骤

  1. 从文末直链或 GitHub Releases 下载 winfsp-2.0.23075.msi,双击运行。
  2. 安装向导第一页会列出几个可选组件,按用途勾选:
    • 安装开发者文件(Developer files):勾上会装上 MEMFS 示例文件系统,以及开发自己的文件系统所需的头文件和库文件。只当普通用户用 SSHFS-Win 的话可以不勾;想跑 MEMFS 体验或做开发则必须勾。
    • 安装 .NET 文件系统支持:用 .NET 写文件系统时需要。
    • 安装 Cygwin FUSE 包:要在已有的 Cygwin 环境里用 SSHFS / FUSEPY 时需要。
  3. 点「下一步 → 安装 → 完成」。安装驱动需要管理员权限,中途可能会弹出驱动签名或兼容性确认。
  4. 装完在「程序和功能」里能看到 WinFsp;命令提示符里执行 fsptool ver 可以确认版本。

3. 什么时候需要重启

这是 2.x 带来的最实用的改进:2.x 版本支持不重启直接卸载和重装。1.x 时代卸载 WinFsp 常常必须重启才能装回来,现在不用了。但有一个例外路径——从 1.x 升级到 2.x 时,必须先卸载旧版 1.x(可能需要重启),再安装 2.x,不能直接覆盖。

五、使用方法(逐项实操)

1. 三十秒体验:跑一个内存文件系统 MEMFS

如果安装时勾选了开发者文件,系统里就带了一个示例文件系统 MEMFS(内存文件系统),可以直接拿它验证 WinFsp 是否工作正常。

图形方式:

  1. 打开「此电脑」→ 右键 →「映射网络驱动器」。
  2. 文件夹填 \\memfs64\share(64 位系统)或 \\memfs32\share(32 位系统)。
  3. 完成后会打开一个新的资源管理器窗口,里面就是这块内存盘;新建文件、重命名、删除都是真实可用的。
  4. 用完右键盘符 →「断开连接」即可。

命令行方式(官方 Quick Start 给的用法):

cd C:\Program Files (x86)\WinFsp\bin
memfs-x64 -u \memfs64\share2 -m *

这条命令在 64 位系统上运行 MEMFS 并把共享目录挂到 *(表示自动分配盘符)。另开一个非管理员的命令提示符,切换到新出现的盘符即可读写。按 Ctrl+C 可以结束第一个窗口里的 MEMFS 进程。

2. fsptool:命令行管理驱动

2.0 起驱动名带实例 ID,用 sc.exe 不再方便,官方推荐用 fsptool:

命令 作用
fsptool ver 查看已安装的 WinFsp 版本
fsptool lsdrv 列出已加载的 WinFsp 驱动实例
fsptool load 加载驱动
fsptool unload 卸载驱动

官方说明这几个命令「很少需要用到,但在排查问题时可能有用」——平时不用管,真遇到「盘符突然消失、卸载不掉」时才是排障利器。

3. 作为 SSHFS-Win 的前置依赖安装

这是最常见的实际用途。顺序不能错:

  1. 先装 WinFsp(本文的 winfsp-2.0.23075.msi 即可),保持默认安装选项。
  2. 再装 SSHFS-Win,官方下载页 winfsp.dev/rel/ 的「Additional Downloads」里直接提供 sshfs-win-3.5.20357-x64.msi 与 x86 版。
  3. 装完在资源管理器里「映射网络驱动器」,文件夹填 \\sshfs\用户名@服务器地址,即可把远程 Linux 目录挂成本地盘符。

详细用法(含 UNC 语法、密钥认证、跳板机)见 SSHFS-Win 3.5.20357 中文介绍与教程。

4. 给 Cygwin 安装 FUSE 包

WinFsp 自带 FUSE for Cygwin,可以在已有的 Cygwin 里装上,从而几乎不用改代码就能跑 SSHFS、FUSEPY 这类程序。

$ cd opt/cygfuse/       <1>
$ sh ./install.sh       <2>

1 是进入 WinFsp 安装目录下的 Cygwin FUSE 包目录;2 是执行安装脚本,会把 FUSE 运行时与开发文件装好。

如果是在 已有的 Cygwin 环境里装,用这条命令(它会从注册表读出 WinFsp 的安装目录):

$ sh "$(cat /proc/registry32/HKEY_LOCAL_MACHINE/SOFTWARE/WinFsp/InstallDir | tr -d '\0')"/opt/cygfuse/install.sh
FUSE for Cygwin installed.

卸载则执行 sh ./uninstall.sh。

5. 开发者视角:用 API 写自己的文件系统

如果你要基于 WinFsp 开发文件系统,官方文档给了一条清晰路径:

  • Tutorial:用 C/C++ 写一个简单但完整的文件系统;
  • API Reference:原生 winfsp.h 接口说明;
  • Native API vs FUSE:该选原生 API 还是 FUSE 兼容层的取舍文档;
  • Design / IPC / Queued Events:设计与进程间通信机制、底层同步原语;
  • Service Architecture:把文件系统作为 Windows 服务集成的架构说明;
  • SSHFS Port Case Study:WinFsp 的 FUSE 兼容层是怎么做出来的,兼作移植实战参考;
  • Compatibility / Performance / Testing:与 NTFS 的兼容性、性能测试、测试策略。

代码仓库里还提供了 passthrough(透传)、memfs(内存)、ntptfs(NTFS 透传)等示例,以及完整测试套件。

六、常见问题与排查

现象 排查方向
Windows 7 上装完驱动显示未签名 官方 FAQ 说明:Win 7 缺少 SHA-2 代码签名支持,把系统完整更新到最新补丁即可
无法以管理员身份运行 WinFsp 盘里的程序(如 regedit.exe) Windows 对「以管理员身份运行的程序」要求承载它的文件系统名为 NTFS。用 memfs-x64.exe -i -F NTFS -m X: 启动 MEMFS 即可
断开(取消映射)网络驱动器失败 多半是装了 Dokany,它自带的 Network Provider DLL 会干扰 WinFsp。解决:调整系统的「网络提供程序」顺序,把 WinFsp Network Provider 排到 Dokany 之前
为什么 DLL 没装到 Windows 系统目录 这是官方刻意的设计:非操作系统自带的软件不应往系统目录塞组件。官方推荐把 WinFsp DLL 标记为「延迟加载」并在进程初始化时用 FspLoad 动态加载
要调试符号 符号单独发布在 github.com/winfsp/winfsp.sym 仓库,配置符号路径即可下栈
能同时挂多少个文件系统 没有硬性上限,但 FSD 内部有一张以进程 PID 为键的哈希表,官方建议一般不超过 50 个进程各自创建文件系统
支持哪个 FUSE 版本 同时支持 FUSE 2.8 与 FUSE 3.2 两套 API,源码仓库的 src/dll/fuse/ 与 src/dll/fuse3/ 分别对应
从 1.x 升级到 2.x 失败 2.x 安装包不能覆盖 1.x。必须先卸载旧版(可能需重启),再装 2.x
找不到 C:\Program Files (x86)\WinFsp\bin 2.x 起真正的文件在 SxS\sxs.<InstanceID>\bin,旧路径是 junction 指向它。脚本写旧路径一般仍可用,但直接访问具体文件请用新路径
安装时杀毒软件拦截 WinFsp 含内核驱动,部分安全软件会阻止驱动加载。把安装包与 WinFsp 加入信任列表,并检查组策略是否禁止加载该驱动
装完 SSHFS-Win 仍然无法挂载 先确认 WinFsp 已安装且位数匹配(x64 系统装 x64 版),再确认 SSHFS-Win 与系统位数一致;用 fsptool ver 和 fsptool lsdrv 看驱动是否正常
映射的盘符图标不正常 / 无法断开 同上,多半是网络提供程序顺序或残留映射问题,先 fsptool lsdrv 看状态

七、相关工具

WinFsp 最常见的搭档是 SSHFS-Win 3.5.20357 中文介绍与教程,它把远程 Linux 目录挂成 Windows 盘符;需要图形化传文件则用 WinSCP 使用教程;要手动登录服务器排障用 PuTTY 连接教程;服务器端传文件的 scp 用法见 Linux scp 命令教程。

八、WinFsp 2.0.23075 下载地址

WinFsp 是完全免费的开源软件,安装包体积只有 2 MB 左右。GitHub Releases 页面同时提供全部历史版本与各架构包,网盘链接只作下载不畅时的应急。安装顺序务必是先 WinFsp、后 SSHFS-Win。

小结

WinFsp 本身只有 2 MB,用户看到的往往只是它的副产品——SSHFS-Win 能把远程 Linux 目录挂成盘符、rclone 能把云盘挂成盘符,背后都是它在托底。它的价值在于把「写文件系统」这件事从内核编程降级成写一个普通用户态程序,开发门槛和崩溃风险都低得多。2.0 这个版本尤其值得记一笔:卸载重装不再需要重启,这在 1.x 时代是很多人升级时最大的麻烦。对普通用户来说,选 2.0.23075 或当前稳定版 2.1.25156 都完全够用;唯一需要记住的是——它是「前置依赖」,装完还得装 SSHFS-Win 这类真正干活的工具。


© 版权声明
THE END
喜欢就支持一下吧
点赞13 分享