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. 安装步骤
- 从文末直链或 GitHub Releases 下载
winfsp-2.0.23075.msi,双击运行。 - 安装向导第一页会列出几个可选组件,按用途勾选:
- 安装开发者文件(Developer files):勾上会装上 MEMFS 示例文件系统,以及开发自己的文件系统所需的头文件和库文件。只当普通用户用 SSHFS-Win 的话可以不勾;想跑 MEMFS 体验或做开发则必须勾。
- 安装 .NET 文件系统支持:用 .NET 写文件系统时需要。
- 安装 Cygwin FUSE 包:要在已有的 Cygwin 环境里用 SSHFS / FUSEPY 时需要。
- 点「下一步 → 安装 → 完成」。安装驱动需要管理员权限,中途可能会弹出驱动签名或兼容性确认。
- 装完在「程序和功能」里能看到 WinFsp;命令提示符里执行
fsptool ver可以确认版本。
3. 什么时候需要重启
这是 2.x 带来的最实用的改进:2.x 版本支持不重启直接卸载和重装。1.x 时代卸载 WinFsp 常常必须重启才能装回来,现在不用了。但有一个例外路径——从 1.x 升级到 2.x 时,必须先卸载旧版 1.x(可能需要重启),再安装 2.x,不能直接覆盖。
五、使用方法(逐项实操)
1. 三十秒体验:跑一个内存文件系统 MEMFS
如果安装时勾选了开发者文件,系统里就带了一个示例文件系统 MEMFS(内存文件系统),可以直接拿它验证 WinFsp 是否工作正常。
图形方式:
- 打开「此电脑」→ 右键 →「映射网络驱动器」。
- 文件夹填
\\memfs64\share(64 位系统)或\\memfs32\share(32 位系统)。 - 完成后会打开一个新的资源管理器窗口,里面就是这块内存盘;新建文件、重命名、删除都是真实可用的。
- 用完右键盘符 →「断开连接」即可。
命令行方式(官方 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 的前置依赖安装
这是最常见的实际用途。顺序不能错:
- 先装 WinFsp(本文的
winfsp-2.0.23075.msi即可),保持默认安装选项。 - 再装 SSHFS-Win,官方下载页
winfsp.dev/rel/的「Additional Downloads」里直接提供sshfs-win-3.5.20357-x64.msi与x86版。 - 装完在资源管理器里「映射网络驱动器」,文件夹填
\\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 下载地址
- 官方网站:https://winfsp.dev/ | 官方下载页:https://winfsp.dev/rel/(含 SSHFS-Win 附加下载)
- 官方 GitHub Releases(本文指定的官方入口):https://github.com/winfsp/winfsp/releases | https://github.com/billziss-gh/winfsp/releases(旧地址,会自动跳转到上面的官方仓库)
- 官方仓库首页:https://github.com/winfsp/winfsp | 本版本 Release 页面:releases/tag/v2.0
- winfsp-2.0.23075.msi 官方直链:https://github.com/winfsp/winfsp/releases/download/v2.0/winfsp-2.0.23075.msi(约 2.1 MB)
- 最新稳定版 2.1.25156:winfsp-2.1.25156.msi | 测试版 2.2.26286:winfsp-2.2.26286.msi
- 官方文档:项目 Wiki | 官方常见问题 | 更新日志 | 许可证全文 | 调试符号仓库
- 百度网盘备用下载:https://pan.baidu.com/s/1YGLm-WxaKOwr45KEV0D9ig 提取码:
4kyk
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 这类真正干活的工具。












