通过阿里云Workbench在浏览器内直接管理ECS实例文件,无需安装和配置FTP/SSH客户端,即可进行文件上传下载、在线编辑及基础管理,满足轻量化配置修改、日志查看等日常运维操作场景。
适用范围
支持的连接方式:文件管理功能仅支持通过Workbench终端连接方式登录的实例。
如果使用会话管理(SSM)方式连接,将无法使用此功能,因为该连接方式基于纯终端协议,未集成文件传输通道。
权限要求:需要使用
root(Linux)、Administrator(Windows)或拥有目标文件及目录相应读写权限的普通用户登录实例。
管理Linux实例文件
对于Linux实例,Workbench提供了与本地文件管理器体验相似的侧边栏文件树,操作直观高效。
上传与下载文件
Workbench目前有两个版本,使用Workbench 登录时,左上角显示图标,为Workbench 2.0,显示WORKBENCH字样,则为Workbench 1.0。如需切换Workbench版本,可单击右上角的体验新版(进入2.0)或返回旧版(回到1.0)。
Workbench 2.0
登录ECS实例。
访问ECS控制台-实例。在页面左侧顶部,选择目标资源所在的资源组和地域。
进入目标实例详情页,单击远程连接,选择通过Workbench远程连接。根据页面提示登录,进入终端页面。
请使用root或拥有待下载文件访问权限的用户登录实例,否则可能因为权限问题无法上传下载文件。
传输文件。
在左侧菜单栏,单击文件管理图标
,进入文件管理页面,单击目标实例展开文件树,双击需要上传/下载文件所在的文件夹。上传:在右侧界面单击上传文件或将文件拖入,或者在左侧文件树中右键单击需要上传文件的文件夹,选择上传,选择需要上传的文件。
下载:在右侧界面,单击待下载文件操作列下的,或者在左侧文件树中右键单击需要下载的文件,选择下载。
查看文件传输进度。
上传下载文件后,页面右下角会显示文件上传任务进度。
Workbench 1.0
登录ECS实例。
访问ECS控制台-实例。在页面左侧顶部,选择目标资源所在的资源组和地域。
进入目标实例详情页,单击远程连接,选择通过Workbench远程连接。根据页面提示登录,进入终端页面。
请使用root或拥有待下载文件访问权限的用户登录实例,否则可能因为权限问题无法上传下载文件。
传输文件。
在顶部菜单栏左上角处,选择文件 > 打开新文件树。
上传:在文件树中,右键单击需要上传文件的位置,在菜单中单击上传文件,选择待上传的目标文件。
如果单个文件上传失败,可选择重试或删除文件。如果多个文件上传失败,可单击重新上传所有失败项目。
下载:在文件树中,右键单击需要下载的文件,在菜单中单击下载文件。
查看文件传输进度。
上传下载文件后,页面右下角会显示文件上传任务进度。
创建、编辑与删除文件
Workbench 2.0
登录ECS实例。
访问ECS控制台-实例。在页面左侧顶部,选择目标资源所在的资源组和地域。
进入目标实例详情页,单击远程连接,选择通过Workbench远程连接。根据页面提示登录,进入终端页面。
请使用root或拥有待下载文件访问权限的用户登录实例,否则可能因为权限问题无法操作文件。
执行文件操作。
在左侧菜单栏,单击
,进入文件管理页面,单击目标实例展开文件树,双击需要操作文件所在的文件夹。创建文件或目录:在右侧界面单击新建,选择新建文件或新建文件夹,或者在左侧文件树中,右键单击目标位置,选择新建文件或新建文件夹。
编辑文件:在右侧界面,单击目标文件操作列下的,或者双击文件即可在右侧编辑器中打开。编辑完成后,按
Ctrl+S(Windows)或Command+S(Mac)保存。删除与重命名:在右侧界面,单击待下载文件操作列下的
,选择删除或重命名,或者在左侧文件树中右键单击目标文件,选择删除或重命名。警告删除前请确认文件已无业务用途或系统依赖,避免影响业务运行。
Workbench 1.0
登录ECS实例。
访问ECS控制台-实例。在页面左侧顶部,选择目标资源所在的资源组和地域。
进入目标实例详情页,单击远程连接,选择通过Workbench远程连接。根据页面提示登录,进入终端页面。
请使用root或拥有待下载文件访问权限的用户登录实例,否则可能因为权限问题无法操作文件。
执行文件操作。
在顶部菜单栏,选择。
创建文件或目录:在界面左侧的文件树中,右键单击目标文件夹,选择新建文件或新建文件夹。
编辑文件:在界面左侧的文件树中,双击目标文件,即可在右侧编辑器中打开。编辑完成后,单击界面右上角保存图标
进行保存。删除与重命名:在界面左侧的文件树中,右键单击目标文件,选择删除或重命名。
警告删除前请确认文件已无业务用途或系统依赖,避免影响业务运行。
管理Windows实例文件
对于Windows实例,Workbench通过在实例内创建一个名为xxx@上的workbench的临时网络驱动器来实现文件传输。当断开Workbench连接时,这个驱动器及其中的所有文件将被自动永久删除。
上传与下载文件
登录ECS实例。
访问ECS控制台-实例。在页面左侧顶部,选择目标资源所在的资源组和地域。
进入目标实例详情页,单击远程连接,选择通过Workbench远程连接。选择连接方式为终端连接,输入账号和密码,登录图形化终端页面。
在搜索框中搜索并打开此电脑。
如果搜索不到此电脑,可以打开文件资源管理器,然后在左侧导航栏点击此电脑。
双击重定向的驱动程序和文件夹区域的xxx@上的workbench驱动盘。

上传:将目标文件从本地拖动至Download目录,然后将目标文件从该目录拖动到C盘或者其他盘。
下载:将目标文件从C盘或其他盘拖动到Download目录,即可将文件下载到本地。
不支持下载 0 字节的空白文件。
配额与限制
限制项 | 限制说明 | 解决方案与建议 |
文件上传大小 |
|
|
传输性能 | 在网络高峰期,传输速度可能较慢。 文件传输基于HTTPS协议,不支持断点续传。 | 对于大于500 MB的文件或在网络不稳定的情况下,建议使用 |
常见问题
如何判断当前使用的Workbench版本是1.0还是2.0?如何切换到2.0?
可通过界面样式判断Workbench的版本。Workbench 2.0的左上角会显示Workbench图标
,而1.0则显示WORKBENCH字样,左侧菜单栏也有所差别。
Workbench 2.0 | Workbench 1.0 |
|
|
如需切换Workbench版本,可单击右上角的体验新版(进入2.0)或返回旧版(回到1.0)。
文件管理页面选择实例提示“该实例当前登录方式不支持文件管理”?
问题现象:
出现如图所示提示,且实例名称后方出现ssm(会话管理)标识。

问题原因:
使用会话管理连接实例时不支持该功能。
解决方案:
方案一:使用Workbench终端连接方式登录实例后,重试文件传输操作。
方案二:在控制台实例详情页上传/下载文件。
顶部菜单栏不显示?
问题现象:在Workbench界面顶部找不到菜单栏,找不到文件按钮。
问题原因:顶部菜单栏被隐藏
解决方案:右键终端界面,单击显示/隐藏菜单栏。
连接Linux实例后找不到“打开新文件树”功能?
问题现象:

问题原因:
可能正在使用会话管理连接实例,而通过会话管理连接实例时不支持该功能。
如果不是通过会话管理连接实例时,出现该现象,可以尝试刷新页面或重新连接实例。
解决方案:
方案一:使用Workbench终端连接方式登录实例后,重试文件传输操作。
方案二:在控制台实例详情页上传/下载文件。
上传文件到 Linux 实例时提示 Permission Denied 怎么办?
问题现象:

问题原因:
当前使用的实例登录用户可能没有目标目录的写权限,导致文件上传失败。比如使用
ecs-user用户登录实例后上传文件到/opt目录时会出现该错误。解决方案:
使用root用户登录实例后上传文件。
请使用root用户重新登录实例后上传文件。
如果创建实例时选择的登录名为ecs-user,需要先设置root用户的密码后才能使用root登录实例,具体操作,请参见方式一:通过控制台在线重置实例密码。
将文件上传到当前用户的家目录。
例如使用ecs-user登录实例时,可以将文件上传到ecs-user的家目录,即
/home/ecs-user目录中。
为什么单击文件管理图标后提示“该实例当前登录方式不支持文件管理”?
问题现象:
出现如图所示提示,且实例名称后方出现ssm(会话管理)标识。

问题原因:
使用会话管理连接实例时不支持该功能。
解决方案:
方案一:使用Workbench终端连接方式登录实例后,重试文件传输操作。
方案二:在控制台实例详情页上传/下载文件。





