SFTP 文件传输
SFTP 文件传输基于当前 SSH 连接打开远程文件管理器，用于浏览目录、上传下载文件、编辑 UTF-8 文本文件，以及执行常见文件管理操作。
打开文件管理器
- 先建立一个 SSH 连接。
- 在终端底部状态栏点击“文件管理器”入口。
- 客户端会使用当前连接信息创建 SFTP 会话。
- 连接成功后显示远程目录列表。
目录浏览
文件管理器支持：
- 查看当前远程目录下的文件和文件夹。
- 进入子目录。
- 返回上级目录。
- 刷新当前目录。
- 查看文件名、大小、修改时间和类型等基础信息。
如果目录加载失败，通常与当前用户权限、目录不存在、SFTP 服务不可用或连接超时有关。
上传文件
- 在文件管理器中进入目标远程目录。
- 点击上传入口并选择本地文件。
- 客户端创建上传任务。
- 如果远程存在同名文件，需要确认是否覆盖。
- 上传完成后刷新目录查看结果。
上传时请注意远程目录权限。如果当前 SSH 用户没有写入权限，上传会失败。
下载文件
- 在远程目录中选择要下载的文件。
- 点击下载入口。
- 选择本地保存路径。
- 客户端创建下载任务。
下载任务支持暂停、恢复和取消。下载大文件时可通过任务状态观察进度。
文本文件编辑
文件管理器适合编辑 UTF-8 文本文件：
- 在文件列表中选择文本文件。
- 打开编辑窗口。
- 修改内容。
- 保存后写回远程文件。
二进制文件、超大文件或非 UTF-8 编码文件不建议直接在线编辑。
文件管理操作
文件管理器支持常见操作：
| 操作 | 说明 |
|---|---|
| 新建目录 | 在当前远程路径创建文件夹 |
| 重命名 | 重命名文件或目录 |
| 删除 | 删除文件或目录 |
| 刷新 | 重新加载当前目录 |
删除操作会影响远程服务器文件，请确认路径后再执行。
失败排查
| 现象 | 常见原因 | 处理方式 |
|---|---|---|
| SFTP 连接失败 | SSH 会话已断开、服务器未启用 SFTP | 重新连接 SSH，检查服务器 SFTP 子系统 |
| 目录打不开 | 当前用户没有权限或路径不存在 | 切换目录或调整远程权限 |
| 上传失败 | 远程目录不可写、磁盘满、连接中断 | 检查目录权限、磁盘空间和网络 |
| 下载失败 | 本地路径不可写、连接中断 | 更换保存路径或重新下载 |
| 文本乱码 | 文件不是 UTF-8 编码 | 改用服务器端编辑器或转换编码 |
使用提示
- 编辑文件前建议先确认文件编码和内容用途。
- 删除远程文件前请再次核对路径。
- 需要修改权限或所有者时，建议回到 SSH 终端中使用服务器命令处理。