上传下载
本文介绍如何使用 XTerminal 进行文件上传和下载操作。
上传文件
XTerminal 提供多种方式上传文件到远程服务器。
拖拽上传
最直观的上传方式是直接拖拽：
- 从本地文件管理器选择文件或文件夹
- 拖拽到 XTerminal 的文件浏览器区域
- 在弹出的确认对话框中确认目标路径
- 点击确认开始上传
拖拽时，目标文件夹会高亮显示。悬停在文件夹上超过 1 秒会自动展开该文件夹。
按钮上传
通过工具栏按钮上传：
- 在文件浏览器中导航到目标目录
- 点击工具栏的上传按钮
- 选择上传文件或上传文件夹
- 在系统文件选择器中选择要上传的内容
- 确认后开始上传
右键菜单上传
- 在目标目录上右键
- 选择上传 > 上传文件或上传文件夹
- 选择要上传的内容
剪贴板粘贴上传
支持从系统剪贴板粘贴文件：
- 在本地文件管理器中复制文件（Ctrl/Cmd + C）
- 在 XTerminal 文件浏览器中按 Ctrl/Cmd + V
- 确认目标路径后开始上传
此方式支持同时粘贴多个文件和文件夹。
下载文件
单个文件下载
- 在文件浏览器中找到目标文件
- 右键点击选择下载
- 文件开始下载到本地
批量下载
选中多个文件后进行下载：
- 使用 Ctrl/Cmd + 点击 或 Shift + 点击选中多个文件
- 右键选择下载
- 所有选中文件开始下载
目录下载
支持下载整个目录：
- 右键点击目标目录
- 选择下载
- 目录及其所有内容将递归下载
传输管理面板
传输管理面板显示所有上传和下载任务的状态。
打开传输面板
点击右侧边栏的传输管理图标打开面板。
面板功能
任务筛选：
| 筛选项 | 说明 |
|---|---|
| 全部 | 显示所有传输任务 |
| 上传 | 仅显示上传任务 |
| 下载 | 仅显示下载任务 |
| 进行中 | 仅显示正在传输的任务 |
| 已完成 | 仅显示已完成的任务 |
任务信息：
每个传输任务显示以下信息：
- 文件名和类型图标
- 源路径和目标路径
- 传输方向（上传/下载）
- 进度条
- 传输速度
- 剩余时间（传输中）
- 完成状态
任务操作：
| 操作 | 说明 |
|---|---|
| 暂停 | 暂停正在进行的传输 |
| 继续 | 恢复已暂停的传输 |
| 重试 | 重新开始失败的传输 |
| 打开文件夹 | 打开下载文件所在目录 |
| 删除 | 从列表中移除任务 |
传输状态
| 状态 | 说明 |
|---|---|
| 等待中 | 任务已创建，等待开始 |
| 传输中 | 正在进行文件传输 |
| 已暂停 | 传输被用户暂停 |
| 已完成 | 传输成功完成 |
| 失败 | 传输过程中发生错误 |
批量操作
面板顶部提供批量操作按钮：
- 清空已完成：移除所有已完成的任务
- 清空全部：清空整个传输列表
传输设置
可以在设置中配置传输相关选项：
打开设置 > SSH 服务 > 上传下载：
| 设置项 | 说明 |
|---|---|
| 启用文件夹压缩传输 | 传输文件夹时使用 tar 压缩，减少传输量 |
| 文件覆盖行为 | 目标文件已存在时的处理方式（每次询问/覆盖/跳过） |
| 下载完成后自动从列表移除 | 下载完成的任务自动从传输列表中移除 |
| 上传完成后自动从列表移除 | 上传完成的任务自动从传输列表中移除 |
| 下载文件按服务器进行分组 | 下载时按服务器名称创建子目录 |
| 下载地址添加时间信息 | 下载路径中包含时间戳，避免文件名冲突 |
| 下载保存目录 | 选择使用默认目录或每次询问 |
| 默认下载地址 | 设置默认的下载保存位置 |
文件夹压缩传输
启用文件夹压缩传输后，上传或下载文件夹时会自动进行压缩：
工作原理：
- 传输前在源端使用 tar 打包压缩
- 传输压缩后的单个文件
- 在目标端自动解压
优势：
- 减少网络传输量
- 提高传输速度
- 保持目录结构完整
要求：
- 服务器需要支持 tar 命令
文件覆盖处理
当目标位置已存在同名文件时，根据设置进行处理：
| 选项 | 行为 |
|---|---|
| 每次询问 | 弹出对话框让用户选择 |
| 覆盖 | 直接覆盖已存在的文件 |
| 跳过 | 跳过已存在的文件 |
传输进度
传输过程中可以查看详细进度：
- 进度条：显示当前文件的传输进度
- 已传输/总大小：如
16.4MiB / 16.4MiB - 传输速度：实时显示传输速率
- 状态标签：显示当前状态（传输中/已完成等）
分片传输机制
XTerminal 采用 1MB 分片传输机制处理文件传输：
- 大文件会自动分割成 1MB 的数据块进行传输
- 每个分片传输完成后实时更新进度
- 分片机制可以更准确地显示传输进度
- 网络波动时单个分片失败不会影响整体传输
备注
分片大小（1MB）为系统内置值，不可自定义配置。
取消传输
取消正在进行的传输：
- 打开传输管理面板
- 找到要取消的任务
- 点击删除按钮
或者先暂停任务，再删除。
传输重试
当传输中断或失败时，可以通过重试功能重新传输：
- 在传输列表中找到失败的任务
- 点击重试按钮
- 文件将从头开始重新传输
备注
当前版本的重试功能会从头开始传输，而非从断点继续。对于大文件传输，建议：
- 确保网络稳定后再进行传输
- 考虑使用「文件夹压缩传输」功能减少传输时间
- 对于特别大的文件，可以先在服务器上分割后再传输
常见问题
上传速度慢
- 检查网络连接质量
- 考虑启用文件夹压缩传输
- 大文件建议使用稳定的网络环境
下载文件找不到
- 检查下载保存目录设置
- 如果启用了按服务器分组，文件会在服务器名称子目录下
- 使用传输面板的"打开文件夹"功能定位
传输失败
- 检查目标目录是否有写入权限
- 确认磁盘空间充足
- 查看错误信息了解具体原因