设备注册与连接
设备注册是使用 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 “离线批量注册与签名”无服务器环境，支持离线方式完成授权：
| 方式 | 说明 |
|---|---|
| 离线批量注册 | 通过白名单离线批量完成设备注册 |
| 离线签名 | 在联网环境预生成注册签名，离线应用到设备 |
License 注册的设备在恢复联网后，可与 JelinaCloud 同步授权数据，继续获得云端管理能力。
设备支持离线运行模式：保留云端配置但暂停联网行为（状态上报、更新轮询），适用于临时断网或需要严格隔离的场景。可通过设备端命令查看状态：
jelina-offline --state # 查看离线模式状态切换离线模式会影响云端管理能力，请在明确需要时操作，并确保了解恢复方式。
设备长时间未上线？ 检查网络连通性、确认烧录时写入了正确的配置文件、确认设备类型匹配。
设备类型选错了怎么办？ 设备类型注册后不可更改。请重新下载配置并烧录，使用正确的设备类型完成注册。
断网环境如何注册设备？ 使用 License 注册路线：手工设置序列号后，通过局域网注册服务器或离线批量方式完成授权。
- 舰队管理与远程运维 — 批量管理与运行策略
- 云端应用部署与 OTA — 应用的云端发布
- Jelinvisor 设备代理 — 设备端执行者
- JelinaCloud 设备注册上云 操作指引