裝置註冊與連線
裝置註冊是使用 JelinaOS 雲端能力的前提。註冊體系提供兩條路線，按部署環境選擇：
| 路線 | 適用環境 | 方式 |
|---|---|---|
| 雲端註冊 | 可聯網，接入 JelinaCloud | 燒錄帶設定的映像，裝置啟動後自動註冊 |
| License 註冊 | 斷網 / 內部網路 / 需要本機授權 | 手工註冊、區域網路註冊伺服器或離線批次授權 |
雲端註冊（推薦）
Section titled “雲端註冊（推薦）”適用於可聯網並接入 JelinaCloud 的部署。裝置聯網後自動完成註冊，通常 30 秒內上線。
雲端準備（在 JelinaCloud 完成）
Section titled “雲端準備（在 JelinaCloud 完成）”- 建立（或選擇）裝置所屬的艦隊；
- 進入艦隊，選擇“新增裝置”，選擇與硬體匹配的裝置型別，並選擇 OS 版本；
- 下載系統映像與裝置設定檔案（每臺裝置唯一）。
注意：裝置型別一經選擇不可更改，請確認與硬體一致；裝置型別建議與艦隊預設型別保持一致，否則裝置可能無法跟隨艦隊進行系統更新。
雲端操作的具體步驟，請參閱 JelinaCloud 裝置註冊上雲 操作指引。
裝置側：燒錄與自動註冊
Section titled “裝置側：燒錄與自動註冊”- 使用 JelinaFlasher 選擇“燒錄系統 + 設定”，將映像與設定檔案寫入啟動介質；
- 裝置從啟動介質啟動，完成系統安裝；
- 裝置聯網後，根據內建設定自動註冊到 JelinaCloud——通常不超過 30 秒。
註冊完成後，可在 JelinaCloud 裝置清單中確認裝置已上線，進入裝置詳情頁檢視裝置狀態、執行服務與記錄。
重新註冊（雲端）
Section titled “重新註冊（雲端）”註冊金鑰僅生效一次。如果刪除了已註冊的裝置，再次註冊需要：
- 重新下載設定檔案或系統映像；
- 重新燒錄作業系統；
- 裝置重新註冊上線。
License 註冊（斷網 / 本機）
Section titled “License 註冊（斷網 / 本機）”適用於無法連線公用網路、或需要在本機完成授權管理的部署。裝置透過註冊碼完成授權，不依賴雲端線上註冊。
- 每臺裝置透過註冊碼完成授權，註冊碼繫結裝置唯一標識，防篡改、防遷移；
- 註冊狀態由裝置端註冊服務持續維護，長期未註冊時告警提示；
- 裝置型別與序列號一經註冊不可更改，保障管理邊界清晰。
未隨映像寫入設定的裝置，先透過裝置端工具設定序列號並啟動註冊（序列號由研華提供，為 32 位字母數字）：
jelina-manual-register --check # 檢視註冊狀態（0=已註冊 / 1=未註冊 / 2=註冊中）jelina-manual-register <序列號> # 設定序列號並行起註冊註冊狀態也可透過裝置狀態命令查詢：jelina-info --get registration.status。
區域網路註冊
Section titled “區域網路註冊”在區域網路內部署註冊伺服器，裝置向註冊伺服器請求註冊並完成授權——適用於內部網路部署與批次上線場景。
離線批次註冊與簽章
Section titled “離線批次註冊與簽章”無伺服器環境，支援離線方式完成授權：
| 方式 | 說明 |
|---|---|
| 離線批次註冊 | 透過白名單離線批次完成裝置註冊 |
| 離線簽章 | 在聯網環境預產生註冊簽章，離線應用到裝置 |
License 註冊的裝置在恢復聯網後，可與 JelinaCloud 同步授權資料，繼續獲得雲端管理能力。
裝置支援離線執行模式：保留雲端設定但暫停聯網行為（狀態回報、更新輪詢），適用於臨時斷網或需要嚴格隔離的場景。可透過裝置端命令檢視狀態：
jelina-offline --state # 檢視離線模式狀態切換離線模式會影響雲端管理能力，請在明確需要時操作，並確保瞭解恢復方式。
裝置長時間未上線？ 檢查網路連通性、確認燒錄時寫入了正確的設定檔案、確認裝置型別匹配。
裝置型別選錯了怎麼辦？ 裝置型別註冊後不可更改。請重新下載設定並燒錄，使用正確的裝置型別完成註冊。
斷網環境如何註冊裝置？ 使用 License 註冊路線：手工設定序列號後，透過區域網路註冊伺服器或離線批次方式完成授權。
- 艦隊管理與遠端維運 — 批次管理與執行策略
- 雲端應用程式部署與 OTA — 應用的雲端釋出
- Jelinvisor 裝置代理程式 — 裝置端執行者
- JelinaCloud 裝置註冊上雲 操作指引