# 远程维护
远程维护是IoT边缘网关提供的Web版客户端工具，可帮助您使用SSH协议进行远程访问主机或直接下载edge应用模块日志。
#### 前提条件
- 专业版和基础版边缘节点均支持远程维护功能。
- 节点状态为未安装/升级中/删除中时，无法使用远程登录功能。
- 远程主机安装了SSH服务端程序，并正常监听22端口，仅下载模块日志的话可以忽略这条。
- 节点已经部署$edge_omagent模块且运行正常。
![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/caution_3.0-zh-cn.png)
- 输入的远程主机账号密码错误，则无法登录节点。
- 节点状态是离线时，可能会因无法正常建立通道，导致功能不可用。
- 只支持一个用户在线登录，新用户登录会造成老用户下线。
- 页签切换，会造成客户端通道关闭，需要重新登录。
- 当应用$edge_agent大于1-1-6版本时，不再支持远程SSH功能，如需使用，则需部署$edge_omagent应用1-1-11或以上版本。
 
#### 操作步骤
1. 访问[IoT边缘](https://www.huaweicloud.com/product/iotedge.html)，单击"管理控制台"进入IoT边缘控制台。
2. 选择左侧导航栏"边缘节点 \> 节点管理"进入页面。
3. 选择您的边缘节点，单击"节点名称"进入节点详情页。
4. 选择"远程维护"页签，单击"节点登录"按钮。 
   图1节点登录   
   ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001833177932.png "点击放大")
   
   
5. 弹出登录SSH服务端弹窗，输入远程访问主机的账号密码后单击"确认"，例如：root/123456。 
   图2节点登录   
   ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001150200087.png "点击放大")
   
   
6. 若账户密码正确，则登录成功，界面上回显远程主机登录成功的返回信息。同时可以单击进行目录树展开。 
   图3登录成功   
   ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001267758109.png "点击放大")
   图4目录树展示   
   ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001223118052.png "点击放大")
   
   
7. 界面操作，您可以通过命令行的方式与主机进行交互。 
   示例如下：
   1. 查看系统当前运行状况，执行命令： \> **top**
      图5top回显   
      ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001222958356.png "点击放大") 
   
   2. 查看 /etc 目录下文件和目录，执行命令： \> **ls**
      图6ls回显   
      ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001267598517.png "点击放大") 
    
   
   
8. 文件上传下载功能 
   ![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/caution_3.0-zh-cn.png)
   1. 只允许对文件进行下载。
   
   2. 只允许在文件夹上进行文件的上传，表示将文件上传到远程主机对应的文件夹下。
   
   3. 上传下载的文件大小最大为10M。
   
   4. 文件上传下载所操作的目录受创建节点时所配置的根目录限制，如下图所示。 ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001232262294.png "点击放大")
      
   
   5. 使用文件上传下载功能，需要部署$edge_omagent大于1-1-11的版本。
    
   在指定文件夹或者文件单击鼠标右键，可以展示文件上传下载功能，如下图：
   图7文件文件上传下载功能展示   
   ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001267691133.png "点击放大")
   图8上传文件   
   ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001223331462.png "点击放大")
   图9下载文件   
   ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001267691661.png "点击放大")
   
   
9. 退出节点登录。 
   您可以直接关闭浏览器、刷新界面、单击右上角关闭按钮、或在操作界面输入"exit"命令即可退出节点登录。
   
   
10. 返回"远程维护"页签，单击"下载日志"。 
    图10下载日志   
    ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001833179192.png "点击放大")
    
    
11. 选择日志文件，单击"确认"。 
    图11选择下载文件   
    ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001833020084.png "点击放大")
    图12单击确认下载文件   
    ![](https://support.huaweicloud.com/usermanual-iotedge/figure/zh-cn_image_0000001879979637.png "点击放大")
    
    
12. 浏览器下载远程文件到本地下载目录。
![](https://support.huaweicloud.com/usermanual-iotedge/public_sys-resources/danger_3.0-zh-cn.png)
远程主机需要安装了SSH服务端程序，并正常监听22端口，使用过程中需要输入账号和密码，请用户妥善保存登录信息。