Windows通过SSH映射Ubuntu目录操作指南（亲测可用）

本文汇总Windows系统通过SSH协议将Ubuntu服务器目录映射为Windows本地盘符的完整操作步骤亲测可用适合新手直接照搬操作。一、映射收益核心优势将Ubuntu目录映射为Windows本地盘符后可大幅提升跨系统操作效率解决Windows与Ubuntu之间文件管理、开发调试的诸多痛点具体核心收益如下便捷对比版本差异可直接使用Beyond Compare等Windows端对比工具读取映射目录中的代码文件快速分析不同版本间的代码差异、文件修改细节无需手动上传下载文件简化版本管控流程提升代码审核效率。无缝跨系统开发无需切换至Ubuntu终端或远程桌面Windows端各类编辑器如VSCode、Notepad、Sublime Text等可直接打开、编辑映射目录中的文件编辑完成后无需额外同步操作文件会自动同步至Ubuntu随后即可在Ubuntu上进行编译、运行实现“Windows编辑、Ubuntu编译”的无缝衔接。编译结果快速访问Ubuntu上的编译产物如可执行文件、日志文件、输出文档等可通过Windows本地映射盘符直接访问、查看、复制无需通过SSH命令下载或其他传输工具节省文件传输时间方便快速排查编译错误、查看运行结果。配置简单且易用性强相较于Samba服务该映射方式配置更简洁无需在Ubuntu上进行复杂的共享权限设置仅需安装两个基础工具、执行一条命令即可完成映射且稳定性更高无需担心Samba服务启动失败、权限冲突等问题上手难度低适合新手及日常开发使用。一、前置条件必看Windows系统本文测试环境Windows 10 版本 10.0.26200.8037已开启PowerShell管理员模式可正常运行。Ubuntu服务器本文测试环境Ubuntu 22.04已开启SSH服务sshd服务正常运行且Windows可通过SSH正常连接Ubuntu可通过ssh 用户名UbuntuIP测试连通性。Windows与Ubuntu处于同一网络局域网/同一网段确保Ubuntu IP本文示例10.10.201.232可被Windows ping通。提前记录Ubuntu相关信息用户名本文示例myir、Ubuntu IP地址、SSH端口默认22本文示例端口22、需映射的Ubuntu目录本文示例/home/myir。二、必备工具安装缺一不可需安装两个免费开源工具用于支持SSH目录映射均默认安装即可无需额外配置。安装WinFsp基础驱动支撑映射功能下载地址https://github.com/winfsp/winfsp/releases/latest下载版本选择对应版本的 x64 后缀 .msi 文件如 winfsp-2.1.25156.msi。安装步骤双击安装包一路点击“下一步”默认安装路径即可安装完成后无需重启后续工具安装完成后统一重启。安装SSHFS-WinSSH映射核心工具下载地址https://github.com/winfsp/sshfs-win/releases/latest下载版本选择对应版本的 x64 后缀 .msi 文件如 sshfs-win-3.7.21011-x64.msi。安装步骤双击安装包一路点击“下一步”默认安装路径即可安装完成后必须重启Windows电脑驱动和工具才能生效。三、核心操作步骤亲测成功直接复制命令重点必须使用PowerShell管理员模式执行命令普通CMD或非管理员模式会报错这是关键避坑点打开PowerShell管理员模式操作按下WinX键在弹出的菜单中选择“Windows PowerShell (管理员)”Win11可能显示“终端(管理员)”打开后切换到PowerShell标签页。验证窗口标题栏显示“管理员: Windows PowerShell”即为正确模式。执行映射命令复制粘贴修改对应参数即可核心命令本文亲测可用net use Z: \\sshfs.r\myir10.10.201.232!22\home\myir参数说明根据自己的Ubuntu信息修改Z: 映射到Windows的本地盘符可自行修改如D:、E:需确保该盘符未被占用。sshfs.r 固定写法解决“系统错误67”“网络名无法找到”的核心关键不可改为sshfs。myir Ubuntu的用户名替换为自己的Ubuntu用户名。10.10.201.232 Ubuntu的IP地址替换为自己的Ubuntu实际IP。!22 SSH端口默认22必须加上若SSH端口修改为其他值替换22即可如!2222。\home\myir 需映射的Ubuntu目录替换为自己需要映射的目录如/root、/home/用户名路径需正确。输入密码完成映射执行命令后会提示输入Ubuntu用户名和密码注意密码输入时不显示直接输入后回车即可。若提示“命令成功完成”则映射成功打开“此电脑”即可看到新增的Z:盘自定义盘符双击即可访问Ubuntu的对应目录操作和本地磁盘完全一致复制、粘贴、编辑、删除均可。四、补充操作可选1. 取消目录映射如需在PowerShell管理员模式中执行命令即可取消映射Plain Textnet use Z: /delete说明Z: 替换为自己映射的盘符执行后提示“命令成功完成”即可在“此电脑”中删除该盘符。2. 无需映射盘符直接访问简化操作若无需固定盘符可直接在Windows文件资源管理器的地址栏输入以下路径回车后输入Ubuntu密码即可直接访问目录Plain Text\\sshfs.r\myir10.10.201.232!22参数说明和映射命令一致可根据自己的信息修改用户名、IP、端口。五、常见问题及解决方案避坑汇总报错信息报错原因解决方案The password is invalid密码无效Ubuntu用户名或密码输入错误或命令中用户名与实际Ubuntu用户名不一致1. 确认Ubuntu用户名和密码正确2. 检查命令中“myirIP”的用户名是否和Ubuntu实际用户名一致System error 67 has occurred. The network name cannot be found.系统错误67网络名无法找到1. 未安装WinFsp或SSHFS-Win2. 命令中写的是sshfs而非sshfs.r3. 未重启电脑4. Ubuntu IP或端口错误1. 确认两个工具均安装完成且已重启电脑2. 将命令中的sshfs改为sshfs.r3. 检查Ubuntu IP和SSH端口是否正确权限不足无法访问目录Ubuntu中被映射的目录当前用户myir无读写权限在Ubuntu中执行命令授权sudo chmod -R 755 /home/myir替换为自己的映射目录映射成功后无法编辑文件Ubuntu目录权限不足或Windows编辑器无权限1. 按上面的命令给Ubuntu目录授权2. 用管理员模式打开Windows编辑器如记事本、VSCode编辑文件六、注意事项映射过程中确保Windows与Ubuntu网络通畅断网后映射会失效重新联网后需重新执行映射命令。若Ubuntu重启需重新执行映射命令或等待网络恢复后系统自动重连。建议映射Ubuntu的用户目录如/home/myir避免映射根目录/防止误操作修改系统文件。若后续更换Ubuntu IP或修改SSH端口需重新执行映射命令修改对应参数即可。七、总结本方法通过“WinFspSSHFS-Win”工具结合PowerShell管理员模式执行指定命令可快速将Ubuntu目录映射为Windows本地盘符操作简单、稳定解决了常见的报错问题。映射后可像操作本地磁盘一样访问、编辑Ubuntu文件适合需要在Windows环境下管理Ubuntu文件的场景如开发、文件传输等。