如何用NyaTerm实现远程文件传输零卡顿：SFTP文件浏览器与自动上传完全指南

在远程服务器上搬运文件，是不是还停留在"开个窗口敲 scp、再开个窗口看日志"的阶段？开源项目NyaTerm（A modern remote terminal workspace）把SFTP 文件浏览器、传输队列和本地编辑后自动上传整合进了同一个终端工作区：连接 SSH 会话后，左侧直接浏览远端目录，拖拽即可上传，保存即自动回传，传输速度、进度、暂停续传一目了然。这篇指南将带你从零配置到进阶技巧，快速掌握 NyaTerm 远程文件传输的完整玩法。

一、为什么用 NyaTerm 传文件更顺畅？

传统方式下，SSH 终端、文件传输、进度查看分散在多个工具里：路径对不上、断点没得续、同名文件覆盖全凭手速。NyaTerm 的远程文件能力全部构建在 SSH 会话之上，文件浏览器、SFTP 传输、本地编辑后回传共享同一条连接与同一套 SFTP 后端，带来三个直观变化：

• 🎯路径不再迷路：文件浏览器与终端工作目录双向同步
• 📊过程全程可见：上传/下载统一进入传输队列，实时显示速度与进度
• 🔄编辑即回传：远端文件下载到本地编辑，保存后自动提示上传

💡 提示：文件浏览器仅对SSH 会话可用，本地终端、Telnet、串口不会显示这套能力。

二、SFTP 文件浏览器：像本地资源管理器一样浏览远端

连接 SSH 会话后，文件浏览器面板自动进入远端用户主目录，界面与本地文件管理器几乎没有区别：

日常高频操作：

文件列表支持单击选择、Ctrl/Cmd多选、Shift范围选择、Ctrl/Cmd + A全选，批量下载、批量删除对选中项直接生效。更多细节可见 文件传输官方文档，核心组件实现在 FileExplorer.tsx。

三、上传文件三种姿势：一个都不掉

上传是运维场景的最高频动作。NyaTerm 提供三种方式，统一汇入传输队列：

1️⃣ 工具栏上传（最稳妥）在 文件浏览器工具栏 点击"上传文件"或"上传文件夹"：

• 一次可多选本地文件
• 上传文件夹时完整保留目录结构
• 适合同步脚本、配置文件、发布包或整组静态资源

2️⃣ 外部拖拽上传（最顺手）把系统文件管理器里的文件或文件夹直接拖进文件浏览器列表区域，出现拖拽覆盖层后松手，NyaTerm 自动开始上传（拖拽逻辑见 useExternalFileDrop.ts）。

⚠️ 注意：只有拖到文件列表区域才触发上传；个别拖拽来源若未暴露真实本地路径，会提示你改用"上传文件 / 上传文件夹"。

3️⃣ 本地编辑后自动回传（最智能）这是 NyaTerm 最适合真实运维场景的能力，第六节单独展开。

四、下载文件：两种模式各取所需

• 固定下载目录：设置一次，后续直接落到默认位置，适合高频使用
• 每次询问保存位置：适合临时排障或按任务分类归档

远端目录下载同样支持，整个目录会完整落到你选择的本地目标目录中。配合多选功能，勾住十几个文件一次传完，不必逐个点击。

五、传输队列：进度、速度、断点续传全都有

所有上传 / 下载任务统一进入传输队列（FileTransfer.tsx），你可以看到：

• 当前进度与实时传输速度
• 成功、暂停、取消、失败等状态
• 多个任务同时进行的情况

单个任务支持：暂停 / 继续 / 取消 / 失败后重试 / 完成后移除。面板顶部提供批量操作：全部暂停、全部继续、全部取消、清理已完成项。

同名文件冲突怎么办？

上传或下载遇到同名文件时，会弹出重复目标对话框（策略实现见 transferDuplicateResolution.ts）：

批量同步同一类目录时，建议在设置 → 传输中调整默认冲突策略，从此告别反复确认。

六、杀手锏：本地编辑后自动上传回远端

修改远端配置文件最怕什么？改完忘了传回去，或者来回复制粘贴改错地方。NyaTerm 的工作方式非常干净：

1. 在文件浏览器中对远程文件执行打开
2. NyaTerm 先把文件下载到本地临时目录
3. 同时启动文件监听
4. 你在本地编辑器里保存后，弹出上传提示窗口

上传提示有三个选择：

• 上传一次：仅回传当前这次修改
• 始终上传：当前会话内后续每次保存都直接回传，不再询问
• 取消：放弃本次修改

关键在于内容指纹判断：只有文件内容真正变化才触发回传。编辑器只更新了修改时间、或采用"写临时文件再重命名"的原子保存方式，都不会造成重复上传。改远程配置、调部署脚本、本地分析日志后回传——都是它的拿手好戏（文档与编辑流程见 RemoteFileEditorPage.tsx）。

七、设置里这 4 项，决定传输卡不卡

打开设置 → 传输，重点关注这几项（配置项与 TransferTab.tsx 对应）：

另外还有：是否保留时间戳、默认文件权限、默认下载路径、是否每次询问保存位置等。

后端层面 NyaTerm 还会自动限制单条 SSH 连接上的并发 SFTP 通道数，并在通道打开遇到临时失败时自动退避重试——同一主机上并行做多项文件操作也不容易因瞬时资源不足报错，这部分无需任何手动配置。

补充：Zmodem（rz / sz）也支持

远端执行rz/sz时，NyaTerm 会自动接管：选本地文件上传、选保存目录下载，任务同样带实时进度进入传输队列。只是 Zmodem 项不支持暂停 / 续传 / 重试，结束后只能从列表移除——由终端两端直接驱动的协议特性所致。

八、进阶技巧：让文件浏览器跟着终端走

在终端里cd /deploy/v2部署新版时，点一下同步按钮（或开启自动同步），文件浏览器立刻跳到同一目录；需要继续敲命令时，再把当前路径发送到终端输入区。边跑命令边查文件，两个面板永远保持在同一个位置。

如果某会话无法稳定报告工作目录变化，同步入口会置灰，属正常保护行为。

总结：一套工作区搞定远程文件搬运

从"敲 scp 的玄学等待"到"拖进去就完事"，NyaTerm 的 SFTP 文件浏览器 + 传输队列 + 自动回传，把远程文件传输变成了和整理本地文件夹一样顺手的事情。现在就可以打开你的 SSH 会话，试试把第一个文件拖进去。🚀