使用Workbench向Linux服务器传输文件

更新时间:
复制 MD 格式

通过Workbench远程连接轻量应用服务器后,可以在文件管理面板中可视化地上传本地文件到服务器、下载服务器文件到本地。可操作的文件范围取决于所使用的登录方式和登录用户身份。

适用范围

  • 服务器已创建且处于运行中状态。

  • 服务器实例卡片左下角显示远程连接按钮(基础型 / 智能体专用型服务器)。

    说明

    应用型服务器(如 WordPress、宝塔面板等镜像,卡片左下角显示登录云服务器)不适用本文流程,请参见应用型服务器相关文档。

  • 若需要向系统目录(如 /etc/root/var/www 等)上传或下载文件,需已通过控制台的设置密码功能为服务器设置了 root 密码。

说明

Windows 系统的轻量应用服务器暂不支持通过 Workbench 文件管理功能上传或下载文件。如需在 Windows 系统间传输文件,请使用 MSTSC 远程桌面连接,具体操作请参见MSTSC 传输文件到 Windows 服务器

选择合适的登录方式

在开始上传/下载文件前,需要先选择合适的登录方式。不同登录方式对应的登录用户不同,可操作的文件范围也不同:

登录方式

登录用户

可上传/下载的范围

典型用途

Workbench 一键连接(默认)

admin

仅 admin 用户拥有权限的目录,如 /home/admin/tmp

快速传输业务/项目相关文件到用户目录。

Workbench 密码登录

root(超级用户)

服务器上的所有目录,包括系统目录(如 /etc/root/var/www)。

部署 Web 站点、修改系统配置、管理日志文件等。

说明

若仅需向 /home/admin(用户家目录)或 /tmp 上传或下载文件,使用一键连接即可。若需要向系统目录上传或下载文件,请使用密码登录,否则会遇到目录权限不足的错误。

上传文件

  1. 轻量应用服务器控制台,在对应服务器卡片的左下角单击远程连接,然后在弹出的对话框中根据待上传目标选择登录方式:

    • 目标位于 admin 用户家目录(/home/admin)或 /tmp:在Workbench一键连接下单击立即登录(以 admin 用户身份登录)。

    • 目标位于系统目录(如 /etc/root/var/www 等):展开使用其他方式登录,在Workbench密码登录下输入 root 密码后,单击立即登录(以 root 用户身份登录)。

  2. Workbench左侧边栏中,单击文件管理图标,打开文件树。

  3. 在文件树中双击进入目标目录,然后通过以下任一方式上传:

    • 方式一(推荐):单击文件列表页顶部的上传文件按钮,选择待上传的本地文件。

    • 方式二:在文件树中右键单击目标目录,然后在菜单中单击上传,选择待上传的本地文件。

    说明

    单次上传文件的体积不能大于 1200 MB。

    上传功能仅支持单文件。如需上传文件夹或多个文件,请先压缩为单个压缩包再上传,完成后在服务器端解压。

    文件上传功能依赖服务器已安装 curl 命令工具,并使用 Workbench 提供的 OSS 作为临时中转存储。

  4. 文件任务中心弹窗的上传任务页签中查看上传进度和结果。当任务出现绿色对勾且进度为 100% 时,表示上传完成。

    说明

    上传完成后,可在文件列表中对已上传的目标文件进行编辑、下载、重命名、删除等操作。

    重要

    如果文件上传失败:

    • 单个失败:单击任务旁的重试(重新上传)或删除(仅删除任务记录,不影响本地文件)。

    • 多个失败:单击重新上传所有失败项目,一键重新上传全部失败项。

    常见失败原因

    • 目录权限不足(错误提示"目录权限不足,无法上传文件"):当前登录用户对该目录无写权限。解决方法:使用 root 用户重新登录(Workbench 密码登录),或选择当前用户有写权限的目录(如 /home/admin/tmp)。

下载文件

  1. 轻量应用服务器控制台,在对应服务器卡片的左下角单击远程连接,然后在弹出的对话框中根据待下载文件的位置选择登录方式:

    • 目标文件位于 admin 用户可读的位置(如 /home/admin/tmp,或 /etc/hosts 等全局可读文件):在Workbench一键连接下单击立即登录(以 admin 用户身份登录)。

    • 目标文件位于权限受限位置(如 /root//etc/shadow 等仅 root 可读的文件):展开使用其他方式登录,在Workbench密码登录下输入 root 密码后,单击立即登录(以 root 用户身份登录)。

  2. Workbench左侧边栏中,单击文件管理图标,打开文件树。

  3. 在文件树中双击进入目标文件所在目录,然后在右侧文件列表中,单击目标文件所在行末尾的操作菜单(⋮),选择下载

    说明

    文件管理仅支持下载单个文件。如需下载整个文件夹,请先在终端中使用 tar 命令打包目录(例如 tar -czf archive.tar.gz folder/),然后回到文件树刷新,再下载生成的压缩包。

  4. 文件任务中心弹窗的下载任务页签中查看下载进度和结果。当任务出现绿色对勾且进度为 100% 时,表示下载完成。下载的文件通过浏览器保存至本地默认下载目录,可在浏览器的下载记录中查看和定位已下载的文件。

    重要

    如果文件下载失败:

    • 单个失败:单击任务旁的重试删除(仅删除任务记录)。

    • 多个失败:单击重新下载所有失败项目,一键重新下载全部失败项。

    常见失败原因

    • 文件权限不足:使用Workbench 一键连接(admin 用户)下载权限受限的文件时,可能会显示类似网络错误的提示(例如 please check whether the network to https://oss-cn-xxx-internal.aliyuncs.com is reachable),实际原因通常是当前用户对该文件无读权限。解决方法:改用Workbench 密码登录(root 用户)重新下载。