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 基於業界成熟的裝置管理架構建置，融合了大規模裝置叢集管理領域的多年實踐，為大規模工業部署提供了經過驗證的可靠基礎。