6.2 KiB
sidebar_position
| sidebar_position |
|---|
| 2 |
SFTP 文件传输
Dragonfly 的远程文件能力建立在 SSH 会话之上。也就是说，文件浏览器、SFTP 传输、远程文件本地编辑后回传 都只在 SSH 会话中可用；本地终端、Telnet、串口不会显示这一套能力。
文件浏览器
连接 SSH 会话后，文件浏览器面板可以直接浏览远程目录。
你会得到这些基础能力：
- 自动进入远端用户主目录
- 进入文件夹、返回上级、刷新当前目录
- 点击路径栏直接编辑并跳转到目标路径
- 与终端当前工作目录同步
- 在不支持路径跟踪的会话中关闭自动同步
- 复制当前目录路径，或把路径直接发送到终端输入区
路径栏支持 ~ 和 ~/subdir 形式的输入，适合快速跳转到主目录或常用子目录。
常见文件操作
在文件列表、工具栏或右键菜单中，你可以执行：
| 操作 | 说明 |
|---|---|
| 打开 | 下载到本地临时目录后，用默认编辑器打开 |
| 上传文件 | 选择一个或多个本地文件上传到当前目录 |
| 上传文件夹 | 整个目录上传到当前远端路径 |
| 下载 | 下载单个文件、多个已选文件，或整个目录 |
| 重命名 | 修改远端名称 |
| 移动 | 把文件或目录移动到新路径 |
| 删除 | 删除单个文件，或批量删除当前选中的多个条目 |
| 属性 | 查看大小、时间、UID/GID、权限等信息 |
| 新建文件 / 文件夹 / 符号链接 | 在当前目录中直接创建 |
其中“打开”并不只是只读预览，而是为后续本地修改后回传做准备。
选择、多选与批量操作
当前文件浏览器已经支持更接近日常文件管理器的选择方式：
- 单击选择单个条目
Ctrl / Cmd多选Shift范围选择Ctrl / Cmd + A全选当前目录条目Delete删除当前选中条目
当你选中了多个条目后，工具栏中的下载和删除会直接对当前选择生效；如果在多选状态下对某个已选条目打开右键菜单，相关批量操作也会作用于整组选中项。
上传与下载
上传
可通过工具栏、右键菜单或拖拽把本地内容上传到当前目录。
- 上传文件时可一次选择多个本地文件
- 上传目录时会保留目录结构
- 上传目录与上传文件会统一进入传输队列
- 适合用来同步脚本、配置文件、发布包或整组静态资源
Windows 外部拖拽上传
在 Windows 上，文件浏览器支持把资源管理器中的文件或文件夹直接拖到 Dragonfly 文件浏览器区域进行上传。
典型流程：
- 打开一个 SSH 会话并进入文件浏览器
- 把本地文件或文件夹拖到文件列表区域
- 出现拖拽覆盖层后松手
- Dragonfly 自动把它们加入上传流程
需要注意：
- 这是当前的 Windows 平台特性
- 只有拖到文件浏览器列表区域才会触发上传
- 某些拖拽来源如果没有暴露本机真实路径，Dragonfly 无法直接解析，这时会提示你改用 上传文件 或 上传文件夹
下载
下载时有两种常见工作方式：
- 使用默认下载目录，直接保存到固定位置
- 每次都询问保存位置，适合临时排障或按任务分类归档
目录下载与文件下载都支持，远端目录会落到你选择的本地目标目录中。
传输面板与传输设置
Dragonfly 会把上传 / 下载任务统一放进传输队列中，便于你查看：
- 当前进度
- 成功、暂停、取消与失败状态
- 同时进行中的任务
- 当前下载目录
单个传输项支持：
- 暂停
- 继续
- 取消
- 失败后重试
- 完成后从列表移除
面板顶部还提供批量操作：
- 全部暂停
- 全部继续
- 全部取消
- 清理已完成项
在 设置 → 传输 中还可以按需调整：
- 上传 / 下载线程数
- 冲突时的处理策略
- 最大重试次数
- 传输缓冲区大小
- 是否保留时间戳
- 是否继续断点传输
- 默认文件权限
- 默认下载路径
- 是否每次询问保存位置
- 默认打开远程文件所使用的本地编辑器
与终端路径同步
文件浏览器可以和当前 SSH 终端的工作目录配合使用：
- 手动同步：点击同步按钮，把浏览器直接跳到终端当前路径
- 自动同步：开启自动同步后，终端
cd到新目录时，文件浏览器自动跟随 - 发送到终端：把当前目录路径或某个文件路径直接发到终端输入区，便于继续补命令
这对边跑命令边查文件非常有用，例如你在终端里进入某个发布目录后，文件浏览器会更容易保持在同一位置。
如果当前会话没有可用的终端路径跟踪能力，手动 / 自动同步入口会变为不可用状态；这通常意味着该会话暂时不能向后端稳定报告 cwd 变化。
本地编辑后自动回传
这是 Dragonfly 很适合真实运维场景的一项能力。
工作方式
- 在 SSH 文件浏览器中对远程文件执行 打开
- Dragonfly 先把文件下载到本地临时目录
- 同时启动文件监听
- 你在本地编辑器里保存后，应用会弹出上传提示窗口
上传提示窗口
文件被修改后，你可以选择：
- 上传一次
- 始终上传
- 取消
如果你对某个文件选择了“始终上传”，那么在当前会话内后续再次保存时会直接回传，不再重复询问。
适合的使用场景
- 修改远程配置文件
- 调整部署脚本
- 打开日志或状态文件做本地分析
- 为文档准备“编辑后回传”的演示截图
文件属性与权限
在 属性 中可以查看：
- 文件大小
- 修改时间、访问时间
- 所有者和组
- UID / GID
- 权限的八进制表示
如果你的流程需要先核对权限再替换文件，这里会比单纯依赖 ls -l 更直观。
:::tip 截图建议
- 推荐图片路径：
/img/docs/file-transfer/remote-file-browser.png - 建议连接一个 SSH 会话后，在文件浏览器中展示目录树、工具栏与右键菜单
- 另一个推荐图片路径：
/img/docs/file-transfer/auto-upload-dialog.png - 建议先打开一个远程文本文件，再在本地编辑器中保存一次以触发自动上传提示 :::