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 端的心跳总开销
- 网络带宽紧张