Jelinvisor 设备代理

Jelinvisor 是运行在每台 JelinaOS 设备上的管理组件，也是设备与 JelinaCloud 云端平台之间的桥梁。设备之所以能够“注册即上云、更新不掉线、远程可运维”，背后的执行者正是 Jelinvisor。

它做什么

职责	说明
设备接入	设备首次启动后自动向云端完成注册，并维持在线状态
状态上报	持续上报设备的运行状态：系统版本、网络地址、资源占用、运行温度、应用状态等
更新执行	接收并执行云端下发的系统、内核、应用与增量更新，处理更新确认与回退
应用管理	管理容器应用与非容器应用（ProgramSet）的完整生命周期：启动、停止、重启、升级
本地接口	提供设备本地管理接口，支持现场查询状态、操作服务、控制设备
远程通道	在云端无法直连设备时，通过安全通道中转管理请求，保证远程可达

四种运行模式

Jelinvisor 按部署环境提供多种运行模式，适应不同的网络与管理条件：

模式	适用场景	行为
云管模式	接入 JelinaCloud 的标准场景	完整注册、上报、接收云端指令
本地管理模式	无云端的内网/隔离环境	通过本地接口下发与管理应用
离线模式	临时断网的现场	保留云端配置，暂停联网行为，恢复后自动续连
独立模式	完全不上云的部署	设备本地自管理，不依赖任何云端组件

无论哪种模式，设备本地能力（应用运行、系统管理、看门狗）都完整可用。

与云端如何协同

┌────────────────┐        ① 注册 / 状态上报        ┌────────────────┐
│  边缘设备      │ ──────────────────────────────▶ │                │
│ ┌────────────┐ │                                  │  JelinaCloud   │
│ │ Jelinvisor │ │ ◀────────────────────────────── │   云端平台     │
│ └────────────┘ │    ② 更新 / 配置 / 指令下发     │                │
│  JelinaOS      │                                  │                │
└────────────────┘       ③ 远程运维安全通道        └────────────────┘

上行：设备状态、日志、告警持续上报，云端实时可视；
下行：系统更新、应用发布、运行策略统一编排下发；
双向：远程 SSH、远程桌面、服务操作经安全通道直达设备。

为现场安全而设计

本地更新确认：关键更新可配置为“到达设备后等待现场确认”，确认后才执行安装——现场人员拥有最终决定权；
访问鉴权：设备本地接口采用密钥鉴权，未授权请求一律拒绝，密钥支持按需重新生成；
生产模式：设备仅对云端开放访问，局域网内也不可直连设备，攻击面最小化；
断线自愈：网络恢复后自动重新建立连接，无需人工干预。

本地接口

设备代理在本机提供管理接口，供现场运维与脚本集成使用：

本地地址：localhost:48484（端口可由配置调整）；
常用接口：进程就绪检查、版本查询、更新状态查询、目标状态预检查、更新确认等；
日常操作优先使用设备端命令（jelina-local-ota），它会自动处理配置与敏感信息；确需直接调用接口时，请通过本机回环地址访问。

健康检查

jelina-info --get jelinvisor --json        # 设备代理状态与版本
systemctl status jelina-jelinvisor          # 服务状态
journalctl -u jelina-jelinvisor -n 100      # 代理日志

更新自己，也更新系统

Jelinvisor 本身也支持在线更新，与系统、内核、应用更新一起由云端统一编排。设备代理保持最新版本，是设备安全与功能演进的基础保障。

技术底蕴

Jelinvisor 基于业界成熟的设备管理架构构建，融合了大规模设备集群管理领域的多年实践，为大规模工业部署提供了经过验证的可靠基础。