# 如何浏览和传输远端文件？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：远程连接。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/sftp_files/

在 **设置 → 连接与高级 → 远程连接** 中找到主机，点击 **浏览文件**。复用同一份 SSH 地址、登录凭据和主机指纹；目标主机需要开启 SFTP。

点击文件夹整行即可进入；路径栏可前往指定目录，旁边可返回上一级或刷新。点击文件行下载，点击 **上传** 选择本机文件，文件夹加号用于新建目录。

标题栏搜索用于筛选当前目录。系统返回先返回上级目录，顶部关闭按钮直接退出文件页。认证失败时可修正凭据后点击 **重新连接文件**；通过 Cube 随行返回时，可按需要重新连接到上次目录。

手机通过 **浏览 / 传输** 切换；宽屏同时展示文件和传输记录。传输可取消，失败或取消后可 **从头重试**。替换远端同名文件必须重新核对并确认，不继承聊天命令的“始终允许”。

普通聊天附件面板的 **本地文件** 从手机选取；**远端文件** 从主机下载，完成后选择 **加入聊天**，不会自动发送。下载也可以 **另存为**；清除传输记录不会删除已经另存或加入聊天的副本。

聊天中的 **远端文件** 工具可以浏览、新建、上传和下载；直接新建文本最多 16 MiB（按 UTF-8 字节计算）。附件及生成的 Excel、PDF、图片等可原样上传，单文件最多 256 MiB，不覆盖远端同名文件。确认面板可选 **允许一次** 或 **始终允许**。始终允许按操作分开保存：在浏览或下载时确认只放开 **浏览与下载**，在新建或上传时确认只放开 **新建与上传**。它保存在本设备，重启后仍有效，适用于所有会话中已启用的远端文件工具和已配置、已核验的服务器；可在 **设置 → 工具服务 → 授权 → 远端文件（SFTP）** 按操作查看和撤销。它与 SSH 命令的按主机授权独立，主机身份和对话文件范围仍逐次检查。

离开页面不会主动取消传输，长时间后台运行取决于系统。重启后不会自动重传，也不提供断点续传。
