SSHFS-Win 是 SSHFS(SSH File System)到 Windows 的移植版:装好之后,远程 Linux 服务器上的目录会变成一个 Windows 网络驱动器,资源管理器、Office、VS Code、压缩软件都能像访问本地磁盘一样读写它。它不是「只能传文件的客户端」,而是真正的文件系统挂载——打开一个远程目录后,双击里面的文件、另存为、改完直接保存,都会实时走 SSH 通道回到服务器。
本文以官方 SSHFS-Win 3.5.20357(内部代号 SSHFS-Win 2021,2020-12-22 发布)的 64 位安装包 sshfs-win-3.5.20357-x64.msi 为主线,整理官方 GitHub Releases 与直链、百度网盘备用链接、安装顺序、完整 UNC 语法、挂载与认证实操,以及最常踩的坑。
先把渠道说清楚,避免白找:官方仓库是 github.com/winfsp/sshfs-win,安装包直接放在 Releases 里(x64 / x86 两个 MSI)。你给的 github.com/billziss-gh/sshfs-win/releases 同样能打开——那是 GitHub 组织改名后的旧地址,会 301 跳到现在的 winfsp/sshfs-win,两个地址都有效。另外它必须先装 WinFsp,WinFsp 的官方下载页在 winfsp.dev/rel/,安装包同样在 GitHub Releases 上。
一、SSHFS-Win 是什么
先理清三个组件的关系,懂了这条链路,后面所有设置都好理解:
| 组件 | 作用 |
|---|---|
| SSHFS(Linux 版) | 开源项目,把 SSH 的 SFTP 通道包装成一个文件系统。SSHFS-Win 是它的移植精简版,源码同为 GPLv2+ |
| Cygwin | 提供 POSIX 运行环境(SSHFS 原本依赖 Linux 的 POSIX 语义) |
| WinFsp(Windows File System Proxy) | Windows 上的 FUSE 实现,负责把用户态文件系统挂载成盘符。没有它 SSHFS-Win 装不上也用不了 |
对普通用户来说,WinFsp 就是「地基」,SSHFS-Win 是「房子」。这也是为什么官方下载页把 SSHFS-Win 列在 WinFsp 安装包的「Additional Downloads(附加下载)」里。
它的典型用途是:
- 把远程 Linux 服务器的目录挂成本地盘符,直接用 Excel 打开服务器上的表格、用记事本改配置文件;
- 在没有图形化 SFTP 客户端的机器上,用最「原生」的方式访问远程文件;
- 配合 Windows 的凭据管理器保存密码,做到开机后自动重连;
- 作为开发/运维环境,把容器、虚拟机、边缘设备上的目录直接拖进本地工具链。
先分清场景:如果只是想「把文件从服务器下载到本地」或「上传覆盖」,用 WinSCP 这类 SFTP 客户端更省事,图形界面、上传下载队列、断点续传都有。SSHFS-Win 的价值在于「把远程目录当本地盘用」,需要频繁读写、大量小文件、或让别的软件直接打开远程文件时才更合适。
二、核心功能特性
| 特性 | 说明 |
|---|---|
| 盘符挂载 | 通过 UNC 路径 \\sshfs\用户@主机 映射为任意盘符(X:、Y: 皆可),支持挂载远程根目录或指定子目录 |
| 两种挂载方式 | 资源管理器「映射网络驱动器」图形操作,或命令行 net use;两者等价 |
| 四种协议前缀 | \\sshfs(远程家目录)、\\sshfs.r(远程根目录)、\\sshfs.k(家目录 + 密钥认证)、\\sshfs.kr(根目录 + 密钥认证) |
| 认证方式 | 用户名 + 密码;或用 SSH 私钥(.ssh/id_rsa,或在 ssh config 里为该主机指定 IdentityFile) |
| 凭据保存 | 首次映射时输入的账号密码可存入 Windows 凭据管理器,之后不再重复提示 |
| 自定义端口 | UNC 路径支持 主机!端口 语法,非 22 端口的 SSH 服务器也能挂 |
| 本地用户映射 | 支持 LOCUSER= 前缀指定发起连接的本地 Windows 账户,多用户共享机器上做隔离 |
| 超时与权限调优 | 可通过注册表补丁给 sshfs 传 ServerAliveInterval(防空闲断连)、create_file_umask / create_dir_umask(放宽新建文件权限) |
| 命令行高级用法 | sshfs-win.exe cmd 与 sshfs-win.exe svc 可直接启动 sshfs 进程 / 以 Windows 服务方式挂载 |
| 现成 GUI 前端 | 官方 README 推荐四个:SiriKali、SSHFS-Win-Manager、NEO SSH-Win Manager、sshfs-win-tray |
| 跳板机 | SSHFS-Win 自身不支持隧道,但可借 Windows 自带 OpenSSH 做端口转发实现(见第五章) |
三、版本信息与系统要求
| 项目 | 说明 |
|---|---|
| 当前版本 | 3.5.20357,GitHub Release 名称为 SSHFS-Win 2021,发布于 2020-12-22 |
| 本版更新 | 安装包已签名;新增 \\sshfs.kr 前缀(密钥认证 + 远程根目录);修复用户名含非 ASCII 字符的问题;支持 Mount Manager 挂载点(\\.\X: 形式,需管理员权限,需 WinFsp 2021 Beta1 及以上) |
| 硬性依赖 | WinFsp 2020 或更高版本。官方 Release 说明第一句就是这个要求,必须先装 WinFsp |
| 系统要求 | Windows 7 及以上(32 位 / 64 位均可,ARM64 需配合对应的 WinFsp);安装 WinFsp 与 SSHFS-Win 都需要管理员权限 |
| 安装包 | x64 版 sshfs-win-3.5.20357-x64.msi 约 4.86 MB(5,091,328 字节);x86 版 sshfs-win-3.5.20357-x86.msi 约 4.74 MB(4,972,544 字节) |
| 授权 | SSHFS-Win 沿用 SSHFS 的 GPLv2+;WinFsp 为 GPLv3 + 自由/开源软件例外(另提供商业许可);内置 Cygwin 为 LGPLv3、GLib2 为 LGPLv2、SSH 组件为 BSD 类许可 |
| 上游版本 | 该仓库还有更新的 3.5.21011 / 3.7.21011 Beta 版本可选;若只想用官网主推版本,取 3.5.20357 即可 |
版本号里的
20357是构建日期号:2020-12-22 编号 20357。所以3.5.20357-x64的读法是「3.5 版本的 2020 年第 20357 号构建,64 位」,不是「3.5.20357 号更新」。
四、下载与安装
1. 先装 WinFsp(必做的前置步骤)
SSHFS-Win 缺少 WinFsp 就完全无法工作。WinFsp 本身也是免费开源软件,官方下载页 winfsp.dev/rel/ 上的安装包与 GitHub Releases 是同一份。装 WinFsp 时如果只是要用 SSHFS-Win,保持默认选项即可;想用它自带的示例文件系统(MEMFS)或做开发,再勾选安装「开发者文件」。
WinFsp 2.0.23075 的官方安装包直链是 github.com/winfsp/winfsp/releases/download/v2.0/winfsp-2.0.23075.msi;如果想用更新的稳定版 2.1.25156,把路径里的 v2.0/winfsp-2.0.23075.msi 换成 v2.1/winfsp-2.1.25156.msi 即可。WinFsp 的详细介绍见 WinFsp 2.0.23075 中文介绍与教程。
2. 再装 SSHFS-Win
下载 sshfs-win-3.5.20357-x64.msi(64 位系统选这个;32 位系统选 x86 版)。双击安装,过程与普通软件一致:同意协议 → 选择安装目录(默认 C:\Program Files\SSHFS-Win)→ 完成。
装完后确认这两个目录存在:
C:\Program Files\SSHFS-Win\bin:sshfs-win.exe与sshfs.exe,命令行高级用法靠它们C:\Program Files (x86)\WinFsp\bin:WinFsp 的工具与运行时
3. 也可以用 winget 一条命令装
winget install SSHFS-Win.SSHFS-Win
官方 README 明确给出了这个包 ID。不过要注意:winget 装的是仓库里最新的 Release,不保证正好是 3.5.20357;想锁定本文这个版本,就用上面的直链下载对应 MSI。
五、使用方法(逐项实操)
1. 先看懂 UNC 语法(最重要)
SSHFS-Win 的所有操作都围绕一条 UNC 路径展开,完整语法是:
\\sshfs\[LOCUSER=]REMUSER@HOST[!PORT][\PATH] \\sshfs.r\[LOCUSER=]REMUSER@HOST[!PORT][\PATH] \\sshfs.k\[LOCUSER=]REMUSER@HOST[!PORT][\PATH] \\sshfs.kr\[LOCUSER=]REMUSER@HOST[!PORT][\PATH]
| 片段 | 含义 |
|---|---|
REMUSER |
远程用户,也就是你登录 SSH 服务器用的那个账号 |
HOST |
远程主机地址,可以是 IP 或域名 |
!PORT |
远程端口,可选,默认 22。例如 user@192.168.1.10!2222 |
\PATH |
远程路径,可选 |
LOCUSER= |
发起连接的本地 Windows 账户,可选,格式 用户名 或 域+用户名。官方说明「很少需要用到」 |
\\sshfs\ |
映射到 HOST:~REMUSER/PATH,即远程用户的家目录 |
\\sshfs.r\ |
映射到 HOST:/PATH,即远程根目录 |
\\sshfs.k\ |
映射到 HOST:~REMUSER/PATH,并使用 %USERPROFILE%\.ssh\id_rsa 私钥认证 |
\\sshfs.kr\ |
映射到 HOST:/PATH,并使用 %USERPROFILE%\.ssh\id_rsa 私钥认证 |
注意 .r = root(根目录)、.k = key(密钥),这两组字母是叠加的,所以有四种组合。
2. 图形方式:在资源管理器里映射网络驱动器
- 打开「此电脑」→ 顶部工具栏点「映射网络驱动器」。
- 「驱动器」选一个空闲盘符,比如
X:;「文件夹」填 UNC 路径,例如\\sshfs\root@192.168.1.10(家目录)或\\sshfs.r\root@192.168.1.10\data(远程根目录下的 data 子目录)。 - 点「完成」,系统会弹出 SSHFS 的账号密码框:输入 REMUSER 和密码。
- 勾选「记住我的凭据」即可把账号密码存进 Windows 凭据管理器,以后挂载同一路径不再重复输入。
- 双击新出现的盘符就能看到远程文件。取消挂载:右键盘符 →「断开连接」。
3. 命令行方式:net use
> net use X: \\sshfs\billziss@mac2018.local The password is invalid for \\sshfs\billziss@mac2018.local. Enter the user name for 'sshfs': billziss Enter the password for sshfs: The command completed successfully. > net use New connections will be remembered. Status Local Remote Network ------------------------------------------------------------------------------ X: \\sshfs\billziss@mac2018.local WinFsp.Np The command completed successfully. > net use X: /delete X: was deleted successfully.
net use 输出的 Network 列显示为 WinFsp.Np,这是 WinFsp 网络提供程序的名字,看到它就说明挂载成功、由 WinFsp 在接管。
4. 用私钥认证(免输密码)
如果服务器只认密钥不认密码,就用 \\sshfs.k\ 或 \\sshfs.kr\ 前缀:
net use X: \\sshfs.k\root@192.168.1.10 net use Y: \\sshfs.kr\root@192.168.1.10\data
默认读取 %USERPROFILE%\.ssh\id_rsa。要用别的私钥,在 C:\Users\你的用户名\.ssh\config 里给该主机配一个别名并指定密钥:
Host myserver
HostName 192.168.1.10
User root
IdentityFile C:\Users\你的用户名\.ssh\mykey
IdentitesOnly yes
然后用别名挂载:net use X: \\sshfs.k\root@myserver。
关键限制:官方 README 特意标注「只支持没有口令(pass phrase)的私钥」。带口令的私钥在挂载时无法交互输入口令,会直接认证失败。解决办法是用
ssh-agent加载并解锁密钥,或者干脆改用密码认证。
5. 通过跳板机访问内网服务器
SSHFS-Win 本身不支持 SSH 隧道,但 Windows 10/11 自带 OpenSSH 客户端,可以做端口转发来绕过去。先在 C:\Users\你的用户名\.ssh\config 里配好跳板机与目标机:
Host jumpserver
HostName 跳板机公网IP
User jumpuser
IdentityFile C:\Users\你的用户名\.ssh\jumpkey
IdentitesOnly yes
Host targetserver
HostName 10.0.0.5
User root
IdentityFile C:\Users\你的用户名\.ssh\id_rsa
IdentitesOnly yes
ProxyJump jumpserver
或者用命令行做一次本地端口转发(-L 把本地 2222 端口转发到目标机的 22 端口):
ssh -N -L 2222:10.0.0.5:22 jumpserver
然后把 SSHFS 指向本地转发端口(注意 UNC 语法里端口用 ! 分隔):
net use X: \\sshfs\root@localhost!2222
6. 通过注册表给 sshfs 传参数
用资源管理器或 net use 挂载时没法直接给 sshfs 加选项,但可以打注册表补丁,让后台挂载时自动带上。官方仓库提供了两个现成补丁:
- 防空闲断连:传
-o ServerAliveInterval=30,每 30 秒发一次保活请求,避免几分钟不传输就掉线;对应ServerAliveInterval.reg。 - 放宽新建文件权限:传
-o create_file_umask=0117,create_dir_umask=0007,让新建的文件/目录对同组可读写;对应GroupReadWrite.reg。
补丁在仓库的 patch/ 目录里,下载后双击导入,重启资源管理器或注销重登即可生效。
7. 命令行高级用法
安装目录 C:\Program Files\SSHFS-Win\bin 下有两个可执行文件:
sshfs-win cmd SSHFS_COMMAND_LINE # 从 cmd 启动 sshfs 进程 sshfs-win svc PREFIX X: [LOCUSER] [SSHFS_OPTIONS] # 由 WinFsp Launcher 以服务方式挂载
例如手动以服务方式把远程家目录挂到 X::
sshfs-win svc \\sshfs\root@192.168.1.10 X:
sshfs.exe 也可以在已有的 Cygwin 环境里直接用,但需要先给该 Cygwin 安装 FUSE 包(WinFsp 自带):
sh "$(cat /proc/registry32/HKEY_LOCAL_MACHINE/SOFTWARE/WinFsp/InstallDir | tr -d '\0')"/opt/cygfuse/install.sh
sshfs-win.exe不要在 Cygwin 里调用,官方明确说明它只能在 cmd / PowerShell 等原生 Windows 环境使用。
8. 不想用命令行?选一个 GUI 前端
| 工具 | 特点 |
|---|---|
| SiriKali | 功能最全的图形前端,支持密码认证、公钥认证、Key Agent 与 KeePass 2 |
| SSHFS-Win-Manager | 专门为 SSHFS-Win 做的轻量前端,界面简洁,可缩到系统托盘,支持密码与公钥认证 |
| NEO SSH-Win Manager | Python + PyQt6 现代界面,一键挂载成盘符、多账户与加密凭据存储、内置 SSH 终端 |
| sshfs-win-tray | Rust 写的单文件便携工具,约 600 KB,免安装,密码用 Windows DPAPI 加密,支持开机自启与自动重连 |
六、常见问题与排查
| 现象 | 排查方向 |
|---|---|
| 映射时提示找不到路径 / 网络提供程序错误 | 99% 是没装 WinFsp或装错架构。先确认「程序和功能」里有 WinFsp,再确认 SSHFS-Win 的 x64 / x86 与系统位数一致 |
| 提示「密码无效」但密码明明没错 | 服务器若禁用了密码登录(只允许密钥),改用 \\sshfs.k\ 前缀;也可能是服务器禁止了 root 直接登录,换普通账号试试 |
| 用了密钥认证却一直失败 | 官方明确:只支持无口令私钥。有口令就先 ssh-add 到 agent,或换无口令密钥 |
| 挂载成功但打开文件很慢 / 大文件卡住 | SSH 通道对高延迟网络不友好;先在服务器上打包再下载更划算。同时确认没开 ServerAliveInterval 导致频繁重连 |
| 闲置几分钟后盘符断开 | 导入官方的 ServerAliveInterval.reg 补丁,传 -o ServerAliveInterval=30 保活 |
| 新建的文件别人读不了 | 默认 umask 对新建文件偏严,用 GroupReadWrite.reg 补丁传 create_file_umask=0117,create_dir_umask=0007 |
| 远程路径写相对还是绝对? | 记住规则:\\sshfs\ 与 \\sshfs.k\ 映射到家目录,\\sshfs.r\ 与 \\sshfs.kr\ 映射到根目录。想访问 /var/log 这类绝对路径,用 .r / .kr |
| 端口不是 22 怎么写 | 用 ! 分隔:\\sshfs\root@192.168.1.10!2222。注意 UNC 路径里的反斜杠只有一个 |
| 服务器在内网,SSH 要跳板机 | SSHFS-Win 无隧道能力,用 Windows 自带 OpenSSH 做 ssh -L 端口转发,再连 localhost!端口 |
| 提示「驱动器已挂载」但盘符打不开 | 先 net use 列出全部映射确认盘符,再 net use X: /delete 清理残留后重挂 |
| Excel 打开远程表格卡在「正在计算」 | 远程文件系统对随机读写和文件锁的支持不如本地盘,大文件建议先下载到本地再处理 |
| 杀毒软件 / 安全软件拦截挂载 | WinFsp 是内核驱动类软件,部分安全软件会阻止其驱动加载,把 WinFsp 与 SSHFS-Win 加入信任列表,或检查组策略是否禁止加载未签名驱动 |
| 32 位系统装错包 | 32 位系统必须用 sshfs-win-3.5.20357-x86.msi,且 WinFsp 也要装 32 位版本 |
七、相关工具
同场景的其它工具这里也有中文教程:WinFsp 2.0.23075 介绍与教程 是 SSHFS-Win 必备的前置组件;WinSCP 使用教程 是图形化 SFTP 客户端的上位替代;PuTTY 连接教程 用来手动登录服务器排障;SecureCRT 介绍 是另一款多平台 SSH 终端;服务器端 scp 命令用法见 Linux scp 命令教程。
八、SSHFS-Win 3.5.20357 下载地址
- 官方 GitHub Releases(本文指定的官方入口):https://github.com/winfsp/sshfs-win/releases | https://github.com/billziss-gh/sshfs-win/releases(旧地址,会自动跳转到上面的官方仓库)
- 官方仓库首页:https://github.com/winfsp/sshfs-win | 本版本 Release 页面:releases/tag/v3.5.20357
- sshfs-win-3.5.20357-x64.msi 官方直链:https://github.com/winfsp/sshfs-win/releases/download/v3.5.20357/sshfs-win-3.5.20357-x64.msi(64 位,约 4.86 MB)
- 32 位版本官方直链:sshfs-win-3.5.20357-x86.msi(32 位,约 4.74 MB)
- 前置依赖 WinFsp 官方下载:https://winfsp.dev/rel/ | github.com/winfsp/winfsp/releases | 2.0.23075 直链:winfsp-2.0.23075.msi
- 官方使用说明:SSHFS-Win README(含 UNC 语法、注册表补丁与 GUI 前端清单)
- 百度网盘备用下载:https://pan.baidu.com/s/1RVvVeTrti8FW7_s1SPvsUA 提取码:
s6vm
GitHub Releases 页面上所有版本、所有架构的安装包都在,不需要额外找第三方站。网盘备用链接是为了下载不畅时应急,官方渠道始终优先。安装顺序不能颠倒:先 WinFsp,后 SSHFS-Win。
小结
SSHFS-Win 的价值一句话讲清:把远程 Linux 目录变成 Windows 上的一个盘符。它本身只有 4.8 MB,依赖清晰(WinFsp + Cygwin + SSHFS),配置也只有一条 UNC 路径,学会了 \\sshfs\用户@主机 这条语法,家目录、根目录、密钥认证、非标端口就都能覆盖。但要清楚它的边界:它走的是 SSH 通道,大文件频繁读写不如本地盘;私钥必须无口令;跳板机要靠 OpenSSH 端口转发自己绕。用它之前先想清楚一件事——你要的是「远程文件当本地用」,还是只是「传个文件」。前者用它,后者用 WinSCP。











