跳到主要内容

3.12.4 设备连接默认值

设备连接区域控制全局的设备接入策略与默认值。这些设置影响所有已添加设备的行为,与单台设备的连接信息(IP、凭据等)独立。

主要设置项

设置项默认值说明
自动重连开启设备失联后是否自动尝试重连
连接超时30 秒SSH 建立连接的超时时间
同设备 SSH 并发上限8 路单台设备最多同时建立的 SSH 连接数
Mesh 局域网 Agent关闭是否启用 Agent Mesh 多机协作
心跳频率(活跃设备)30 秒后台心跳探测的频率

自动重连

开启后,Studio 检测到设备失联(连续 3 次心跳失败)时会进入低频探测模式,每 5 分钟尝试一次重连。设备恢复后自动切回高频探测,无需手动操作。

关闭这一选项的场景较少,主要适用于"明确知道某些设备会长期离线,希望减少日志噪音"的场景。

连接超时

SSH 建立连接时的等待时间。默认 30 秒适合大多数场景。

调高(如 60 秒)适合:

  • 板端启动较慢,30 秒内 SSH 服务还未启动
  • 网络延迟较高(跨地域访问、VPN 隧道等)

调低(如 10 秒)适合:

  • 已知板端响应应该很快,希望快速失败便于排查
  • 自动化脚本中希望快速失败便于重试

同设备 SSH 并发上限

Studio 给同一台设备的 SSH 并发数设有上限(默认 8 路)。这是为了避免长任务挤占所有 SSH 通道、阻塞所有探测。

调高(如 16 路)适合:

  • 频繁同时使用多个远程终端 + 文件管理 + AI Agent 调用 device_exec 的高强度场景
  • 板端 sshd 配置允许更多并发(默认 MaxSessions 是 10)

环境变量 RDK_DEVICE_EXEC_MAX_CONCURRENT 也可控制此值,优先级低于 GUI 设置。

Mesh 局域网 Agent

实验性功能,关闭状态下完全无影响。开启后允许同一局域网内的多个 Studio 实例发现彼此,实现 Agent 协作(例如一个 Studio 帮另一个 Studio 处理任务)。

适用场景较少,仅在团队内部署多机器人 + 多开发者的协同实验时使用。详细机制见相关技术文档。

心跳频率

后台对设备的心跳探测频率。默认 30 秒,可在 配置中心 → 设备连接 中调整。

调高频率(如 10 秒)适合:

  • 需要快速感知设备状态变化的关键场景
  • 测试设备频繁上下线的环境

调低频率(如 60 秒)适合:

  • 设备数量较多,希望降低 PC 端的心跳总开销
  • 网络带宽紧张