您可使用远程登录功能,通过SSH协议的网络服务远程访问设备,在设备远程控制台输入设备的指令,进行调试和定位问题。本文介绍远程登录的具体使用方法。

前提条件

设备需满足以下条件:

背景信息

远程连接基于SSH技术实现,方便您远程登录设备进行设备控制和管理,其使用的用户名和密码是设备的用户名与密码。

物联网平台仅为设备建立SSH服务通道,设备远程控制台具体支持的管理能力,需您自己在设备端开发。

使用限制

目前,仅华东2(上海)、华北2(北京)、华南1(深圳)地域支持使用远程登录服务。

使用说明

远程登录设备前,需要设备先与物联网平台建立SSH通道,您可通过以下两种不同的方式让设备建立SSH通道,对应的实现流程如下。

  • 在物联网平台控制台手动开启远程登录功能,实现远程访问和管理设备。手动开启

    使用该方式必须保证设备具备远程登录能力且保持在线状态,设备端才能接收到物联网平台下发的通知,实现与SSH远程通道建连。否则,无法开启远程登录功能。

  • 设备端主动向物联网平台请求SSH远程通道建连信息,获取响应后开启远程登录功能,实现远程访问设备。主动开启

    使用该方式必须保证设备具备主动发送请求SSH通道建连信息的能力,设备端才能通过物联网平台返回的信息,实现与SSH远程通道建连。

    设备离线后,SSH远程通道不会被关闭。建连信息可以在有效期内重复使用,SSH安全通道可以在设备离线时独立建立。您可在设备离线时,继续远程访问和管理设备。例如,实际业务场景中设备的业务功能和运维功能需彼此隔离,在业务功能异常的设备不在线时,可继续远程管理该设备。

    • 设备端开发,请参见设备主动开启远程登录示例
      重要
      • 物联网平台下发的SSH远程通道认证信息有效期为7天。请配置设备周期性(建议一天一次)的向物联网平台请求SSH远程通道建连信息,并使设备通过新下发的认证信息重新与SSH远程通道建连。
      • 建议您以合适的方式持久化保存SSH远程通道的建连信息,以便设备在与SSH远程通道断连时,可以使用保存的建连信息再次与SSH远程通道建连。
    • 开启和使用远程登录的具体操作,请参见设备主动开启远程登录远程登录设备

手动开启远程登录

  1. 登录物联网平台控制台,进入远程登录页面。
    1. 实例概览页面,选择目标地域,找到对应的实例,单击实例进入实例详情页面。
    2. 在左侧导航栏,选择监控运维 > 在线调试
      您也可在目标设备的设备详情页面中在线调试页签,单击前往查看
    3. 在线调试页面,选择目标设备,单击远程登录
  2. 远程登录页签,单击开启
    重要 真实设备不在线时,开启远程登录功能会失败。
    设备接收到物联网平台下发的与SSH远程通道建连的信息,建连成功后,远程登录页签显示登录按钮。

设备主动开启远程登录

设备端完成开发并启动时,向物联网平台请求SSH远程通道建连信息。设备获取到建连信息的响应后,触发该设备完成SSH远程通道的建连。

设备请求获取SSH远程通道信息的Topic和数据格式说明,请参见远程登录的数据格式

设备与SSH远程通道建连成功后,远程登录页签显示登录按钮。

远程登录设备

  1. 远程登录页签,单击登录
  2. 在对话框中,输入设备远程访问的用户名和密码,单击确定
    重要 设备远程访问的用户名和密码,由您在设备端自行设置。
    登录成功后,您将看到如下远程控制台页面。您可根据设备本身功能对设备进行管理。
    重要 登录成功后,若您5分钟内未进行任何操作,则登录连接会被关闭。
    终端窗

分享远程登录权限

在已开启远程访问服务的设备下,您可分享设备的远程访问权限给其他用户。

警告 分享远程登录权限后,如果登录链接和密码被泄露,可能导致数据安全风险或造成资损。请谨慎操作。
  1. 远程登录页签,单击分享
  2. 分享远程服务对话框,单击远程分享开关,开启设备的远程访问权限。
    对话框中显示远程分享的链接和密码,单击复制链接和密码,可将该信息分享给其他用户。
    重要
    • 开启远程分享24小时后,将自动关闭分享,此时被分享远程服务的用户不可再次登录远程服务,但已登录的用户仍然可以继续使用。若要禁止已登录的用户使用远程服务,请关闭远程分享开关。
    • 单击重置密码,系统会重新分配密码。重置密码后,其他人无法通过重置前的密码再次登录远程服务,但已登录的用户仍然可以继续使用,退出登录后则不可使用。
    获取到分享远程终端链接的用户,按如下步骤登录设备,使用远程服务。
    1. 在浏览器中打开分享链接,输入分享密码。
    2. 输入由分享者提供的设备SSH服务的用户名与密码。
    3. 成功登录设备,使用远程服务。

关闭远程登录

远程登录页签,单击关闭。设备端收到SSH远程通道关闭通知,与SSH远程通道断连,关闭远程登录功能。

重要 仅当真实设备在线时,支持该关闭操作。

设备的远程登录功能关闭后,设备若主动请求与SSH远程通道建连,会重新开启远程登录功能。