使用指南
August 29, 2026 · View on GitHub
本文面向 SimAdminHub 日常使用者，说明当前已经开放的页面、数据关系和常见业务规则。
使用前提
网络接入或由 USB 网络接管的完整设备应运行最新版 SimAdmin。Hub 依赖 SimAdmin 内置的 Hub Agent、接入接口和通信协议；旧版可能提示“请求的接口不存在”或始终无法上线。未安装 SimAdmin 的完整蜂窝设备和普通模组可以由 Host Agent 按实际硬件能力接入。Hub 直接安装在完整 Linux 蜂窝设备本机时，正式安装包会按硬件检测结果启动本机 Device Service。
页面导航
| 页面 | 用途 |
|---|---|
| 总览 | 查看设备数量、设备卡片、信号、温度和链路状态 |
| 设备 | 检索、筛选、分组、标签、编辑、删除和进入完整设备面板 |
| 短信 | 按设备和会话查看、搜索、发送及批量删除短信 |
| 通知 | 管理转发日志、转发规则、转发通道和失败重试 |
| 自动化 | 管理自动化任务、设备范围、手动运行和执行日志 |
| 系统设置 | 管理连接参数、数据保留、存储、备份恢复和版本检查 |
总览
总览中的每张设备卡片显示：
- 设备名称、运营商和网络制式。
- 手机号、信号百分比和 dBm。
- 接入方式、运行时长和最低/最高温度。
- 硬件、控制、SIM 和蜂窝注册四项链路状态。
点击设备卡片会打开设备上下文侧窗，点击页面空白区域或关闭按钮可收起。侧窗的状态页汇总 SIM 卡、设备信息和系统资源；功能页提供完整面板、同步、查看短信、发送短信、重启基带和重启设备。
设备
设备列表支持按名称、IMEI、状态、分组、标签和接入方式筛选。列表展示设备与 IMEI、分组与标签、接入方式、链路状态、手机号、运营商与网络、信号、最高温、运行时长、版本和最近上报时间。
接入方式
- 网络接入：设备通过普通 IP 网络连接 Hub，通常由设备内的 SimAdmin Agent 执行操作。
- 本机设备：Hub 与 Device Service 运行在同一台完整 Linux 蜂窝设备上，由本机 SimAdmin Agent 提供蜂窝设备能力，设备级备份和升级归 Hub 管理。
- 宿主机直连：设备通过 USB、PCIe 或 M.2 连接 Hub 宿主机。已安装 SimAdmin 的完整设备仍由设备内 Agent 执行，Host Agent 只观察物理连接；其他设备由 Host Agent 按探测到的能力执行。
接入方式只说明设备从哪里连接，不代表由谁执行操作。完整设备、普通模组和待识别设备也分别记录为不同设备形态，页面功能最终由设备上报的能力清单决定。
自动发现按需运行：打开“添加设备”时，Hub 才开始局域网 mDNS 浏览并要求 Host Agent 枚举新模组；关闭窗口后自动停止。已经接入的设备仍会继续上报状态和执行命令。Host Agent 会优先识别稳定的 /dev/serial/by-id 路径，并结合 ModemManager 全量枚举和只读 AT 探测判断控制端点。当前版本不提供手动填写宿主机串口路径，自动发现不到时请检查容器或服务的硬件权限以及宿主机驱动。
设备状态
- 在线：Agent 连接有效，设备可以正常上报和接收支持的命令。
- 离线：超过离线阈值没有心跳，或 Host Agent 已无法访问对应模组。
- 身份待确认：检测到同一身份的并发所有者、槽位更换硬件或硬件指纹冲突，需要用户核对设备和绑定关系。
局部能力异常不会简单显示成含义模糊的“降级”。设备仍在线时，具体异常会显示在硬件、控制、SIM 和蜂窝注册四项链路状态中。
身份待确认期间，除解除绑定外的控制操作会被阻止。请核对 IMEI、硬件指纹、USB 槽位和当前 Agent，再确认正确设备。
分组与标签
分组和标签用于：
- 整理和筛选设备。
- 指定通知规则作用范围。
- 指定自动化任务作用范围。
它们不代表客户、租户或权限边界，也不会把设备数据混合保存。
完整设备面板
网络 SimAdmin 与直连 SimAdmin 由设备自身的 Agent 控制，提供状态、SIM 卡、动态 eSIM、WiFi Calling、蜂窝网络、设备网络、备份与恢复、设备设置和 OTA 等页签。具体页签仍取决于标准版或增强版 SimAdmin 的实际能力与功能开关，OTA 支持设备本地在线更新和上传更新包。
Hub 本机设备虽然复用 SimAdmin 后端和前端组件，但其数据、安装和升级均归 Hub 管理，因此不显示“备份与恢复”和“OTA”页签。本机 Device Service 自动探测平台蜂窝硬件，不提供用户启停开关；未检测到硬件时不启动常驻进程。
由 Host Agent 控制的完整设备或普通模组使用动态模组面板，只显示真实探测到的设备信息、SIM、短信、蜂窝网络、数据连接、APN、模组温度、绑定网卡和 eUICC 信息，不会为了界面完整而显示宿主机 CPU、内存、磁盘、设备 OTA、备份恢复或不可执行操作。直连模式只在成功选择 eUICC 管理应用后显示 eSIM；对应 QMI、MBIM 或 AT lpac 驱动可用时进一步开放 Profile 查询、启用、停用和删除。
| 能力 | 网络 SimAdmin | Hub 本机设备 | 普通直连模组 | 直连 SimAdmin |
|---|---|---|---|---|
| 状态、SIM、短信、蜂窝网络 | 完整 | 完整 | 按探测能力显示 | 完整 |
| 数据连接与设备网络 | 完整 | 完整 | 按后端与网卡能力显示 | 完整 |
| eSIM | 动态显示 | 动态显示 | APDU 与 eUICC 可用时显示 | 动态显示 |
| WiFi Calling | 增强版启用时显示 | 启用时显示 | Provider 可用且启用时显示 | 增强版启用时显示 |
| 设备设置 | 完整 | 仅显示本机相关设置 | 仅显示可执行控制 | 完整 |
| 备份与恢复 | 显示 | 隐藏 | 隐藏 | 显示 |
| OTA | 显示 | 隐藏 | 隐藏 | 显示 |
具备 QMI、MBIM 或 AT USIM 鉴权能力的直连设备会在 SIM 卡页面显示 WiFi Calling 功能开关。开启后才显示 WiFi Calling 页签并启动该设备的运行实例；关闭功能、设备离线或鉴权端点失效后实例自动停止。页签分别显示 SIM、接入网络、隧道、IMS 和短信链路状态，只有全部就绪时才显示 WiFi Calling 徽章。是否能够连接还取决于宿主机互联网、模组、SIM、运营商和套餐，页面显示开关不代表运营商网络一定接受注册。
删除设备
删除在线 SimAdmin 设备时，Hub 会自动通知设备解除绑定，成功后再删除 Hub 中的设备和集中数据，不需要先登录设备操作。
解除失败或超时时，Hub 会保留设备并显示错误。离线设备无法接收解除命令，Hub 会直接删除本地记录；设备以后重新连接时需要重新接入。
短信
短信页面由设备列表、会话列表和消息内容三部分组成：
- 设备列表顶部的“全部设备”用于跨设备搜索。
- 选择具体设备后，可以查看该设备的会话和收发统计。
- 接收短信靠左显示，发送短信靠右显示。
- 支持新建对话、搜索、选择整个会话、选择单条短信、全选和批量删除。
设备第一次连接某个 Hub 时，会将本地历史短信完整同步一份。以后连接同一个 Hub 只同步新增和变化数据；切换到另一个 Hub 后会重新执行一次完整同步。
设备数据库和 Hub 数据库相互独立。在 Hub 删除短信不会删除设备本地短信，在设备删除也不会自动删除 Hub 中已经保存的副本。
通知
通知中心包含：
- 转发日志：查看规则、通道、来源设备和投递结果。
- 转发规则：按事件、条件和设备范围决定是否通知。
- 转发通道：配置 Webhook、Bark、PushPlus、企业微信、钉钉、飞书、Telegram、电子邮件和 Server酱等通道。
- 失败重试：查看异步投递失败原因，手动重试或删除队列项。
设备范围支持全部设备、多个分组或多台指定设备。
Hub 和设备本地的通知配置相互独立：
- Hub 有启用规则命中事件并进入可用通道时，由 Hub 负责发送，设备不重复通知。
- 没有 Hub 规则接管时，如果设备允许本地兜底，则使用设备自己的通知配置。
- Hub 已接管但通道发送失败时，由 Hub 重试，不再让设备重复发送。
发送测试后，页面会显示成功或失败结果。通道密钥保存后不会再次明文返回。
自动化
自动化任务可以作用于全部设备、多个分组或多台指定设备。当前支持：
- 重启基带。
- 重启设备。
- 发送短信，短信内容可插入时间和随机字符串变量。
新建任务默认启用，Hub 任务始终由 Hub 集中调度，不会复制到设备。SimAdmin 设备自己的自动化规则保持独立，并由设备端“Hub 离线时使用设备本地规则”开关控制离线接管。
每个任务卡片显示设备范围。发送短信任务还会显示收件号码和短信内容。运行日志记录每台目标设备的执行结果。
设备备份不属于 Hub 自动化动作。网络 SimAdmin 或直连 SimAdmin 可进入设备完整面板执行设备自己的备份；Hub 本机设备和普通直连模组的数据随 Hub 系统备份统一处理。
敏感信息
顶部状态栏的全局按钮控制以下信息是否明文显示：
- ICCID。
- 设备手机号。
- 短信中心号码。
- IMEI。
默认模糊隐藏。短信会话中的联系人号码不受该开关影响，避免无法识别会话。
该功能只是页面显示保护，不能替代访问认证。Hub 数据库中仍保存业务所需的原始值。
系统设置
概览
概览显示 Hub 版本、架构、运行状态、存储占用和数据路径。完整 systemd 安装和标准 Docker 安装都会显示“本机 Host Agent”开关：默认关闭且不启动 Host Agent 进程；只有需要管理与 Hub 同机直连的蜂窝模组时才启用。仅安装 Hub 或直接运行单个二进制时，该开关不可用；标准 Docker 安装已经预授予所需硬件访问权限。
连接设置
默认每 30 秒心跳一次，90 秒未收到心跳后判断离线。心跳间隔可设置为 5 至 300 秒，离线时间至少为心跳间隔的两倍，最大 1800 秒。
设备授权可以选择自动授权或人工确认。修改心跳设置后，现有 Agent 会重新连接并获取新配置。
数据保留
默认策略：
| 数据 | 保留时间 | 每设备最多记录 | 默认启用 |
|---|---|---|---|
| 短信 | 365 天 | 不限制 | 否 |
| 通知日志 | 180 天 | 10000 | 是 |
| 自动化日志 | 180 天 | 5000 | 是 |
| 命令历史 | 90 天 | 5000 | 是 |
保存规则不会立即清空全部历史。后台维护会定期执行，也可以在系统设置中手动清理指定组件或优化数据库。
Hub 备份与恢复
Hub 备份可以选择：
- Hub 配置。
- 设备与分组。
- 短信。
- 通知配置和通知记录。
- 自动化配置和自动化记录。
- 命令历史。
自动备份默认关闭。启用后的默认计划为每天 02:00，最多保留 10 份。
恢复前系统会检查文件哈希、数据库完整性和版本兼容性，并显示可恢复组件。组件恢复采用合并方式，未选择的数据保持不变。恢复设备信息后，在线状态会等待 Agent 实际重连后重新建立。
Hub 备份只包含 Hub 自己的数据，不会远程备份每台设备的本地数据库。当前页面只能恢复本机备份目录中已经登记的备份，不支持上传下载到其他位置的备份文件；用于整机灾备时应选择全部组件，并按安装与部署中的人工恢复步骤操作。
当前未开放
- 顶层批量 OTA。
- 日志中心。
- 多用户、角色、租户和细粒度权限模型；当前仅支持单管理员密码。
直连 eSIM Profile 与 WiFi Calling 已按能力开放，但不同 QMI、MBIM、AT 模组、eUICC、运营商和套餐组合仍需按真机兼容矩阵验证；未通过探测的能力不会显示。
通知投递日志和自动化执行记录属于业务功能，当前仍正常保存并在对应模块中查看。
安装、接入、升级和卸载见安装与部署。