本仓库用于发布基于 3899/SimAdmin 构建的安装脚本与分发资产
SimAdmin 是一套面向 Debian 蜂窝 CPE、随身 WiFi、软路由类设备的 SIM/eSIM、蜂窝网络、短信、WiFi Calling(VoWiFi)、DDNS 和系统状态管理系统。
💡 核心亮点 —— 支持 WiFi Calling (VoWiFi)：原生实现 IKEv2/IPsec 全链路能力，无第三方程序依赖；依托 SIM 硬件鉴权搭建加密隧道，无蜂窝信号、飞行模式下仍可通过无线网络完成 IMS 注册与加密短信收发。
当前项目由 Rust 后端和 React 前端组成：
- 后端：Rust + Axum + zbus，主要通过 ModemManager D-Bus 接口管理 modem，并在部分场景使用
mmcli、qmicli或 AT 直连兜底。 - 前端：React + Vite + Material UI，提供仪表盘、SIM 卡管理、蜂窝网络、设备网络、短信管理、通知中心、自动化中心和 OTA 更新页面。
- 部署形态：后端二进制同进程托管前端 SPA，默认安装到
/opt/simadmin，通过 systemd 运行。
健康检查整体按支持 ModemManager 的 Linux 蜂窝设备组织，不同 modem 固件、内核、ModemManager 版本暴露的能力不同，具体功能以实际设备为准。
- 🚀 安装与部署指南：设备一键安装/卸载、后台默认访问地址及首次管理员密码设置。
- 📜 版本更新记录：历史版本详细的更新说明日志。
- ⚙️ 运行环境与系统管理：目标设备硬件与依赖指令要求、默认安装路径、eSIM/VoWiFi 管理机制、systemd 服务维护及数据持久化。
本项目会直接操作蜂窝 modem、SIM 注册、数据拨号、APN、频段、飞行模式、NetworkManager、systemd 服务、系统重启和 OTA 文件替换；iptables/ip6tables 仅用于只读网络诊断，不会自动清空宿主机防火墙规则。
请仅在你拥有控制权的设备上使用。错误配置可能导致断网、无法注册网络、SIM 漫游计费、设备需要手动恢复，甚至 OTA 后服务无法启动。任何使用本项目造成的后果由使用者自行承担。
部分接口受硬件和 ModemManager 能力限制：
- 频段锁定依赖 ModemManager 暴露的
SupportedBands/CurrentBands/SetCurrentBands。 - 小区锁定当前为后端内存态展示，不会下发真实硬件锁小区命令。
本仓库是基于上游项目 3899/SimAdmin 的二次分发资产仓库，发布的安装脚本、文档和构建产物遵循上游项目的 GNU General Public License v3.0 (GPLv3) 许可证条款。
本仓库不是项目官方仓库。如需查看原项目、版权信息和完整许可文本，请参考 3899/SimAdmin。
| 页面 | 路由 | 说明 |
|---|---|---|
| 登录认证 | /login |
首次设置管理员密码、登录后台 |
| 仪表盘 | / |
包含在线状态、运营商、信号、网络延迟、数据/漫游/飞行模式快捷开关、系统资源、温度、流量，以及设备信息 |
| SIM 卡管理 | /sim |
全面展示卡状态、标识信息、解锁次数及存储路径，支持号码与短信中心行内修改；在 eSIM 模式下集成管理与写卡功能，在开启 WiFi Calling 时提供连接状态与耗时时序图诊断看板 |
| 蜂窝网络 | /network |
网络注册、服务小区和邻区、运营商扫描、APN、射频模式、频段锁定、小区锁定状态 |
| 设备网络 | /device-network |
WLAN 客户端联网、无线网络扫描和连接、DDNS 动态解析配置和同步日志 |
| 短信管理 | /sms |
接收短信、发送短信、短信列表、会话、统计、删除对话、删除短信 |
| 通知中心 | /notifications |
转发日志、转发规则、转发通道、多通道测试发送 |
| 自动化中心 | /automation |
管理自动化任务，以及检索、筛选和清理任务执行日志 |
| 系统配置 | /config |
基本系统配置，包含设备运行模式设置、数据连接、漫游、飞行模式等 |
| 安全性设置 | /config/security |
管理员密码修改、密码策略、登录保护及会话超时等安全配置 |
| OTA 更新 | /ota |
上传 OTA 包、在线获取 Release、验证、应用或取消更新 |
- 单管理员密码登录，支持首次设置、会话 Cookie、受保护 API 拦截和 SSH 本机恢复。
- 设备信息、SIM 信息、网络注册信息读取。
- 数据连接开关和漫游策略持久化。
- 飞行模式控制。
- 基带重启流程和进度查询。
- 数据连接 watchdog，每 15 秒检查连接状态、iptables 规则数量和 modem 可用性；检测到宿主机防火墙规则时仅记录诊断日志，不自动清空规则。
- ModemManager 丢失时触发
mmcli --scan-modems，连续失败后重启 ModemManager。 - 安装脚本自动安装并启用 ModemManager 与 NetworkManager，并清理历史
wwan*unmanaged 配置，恢复 WLAN 与蜂窝数据管理能力。 - 设备侧 WLAN 客户端连接管理，通过 NetworkManager/nmcli 扫描和连接无线局域网，WLAN 在线时优先作为设备默认出口。
- 原生 DDNS 同步，支持腾讯云 DNSPod、阿里云 AliDNS 和 Cloudflare，支持 IPv4/IPv6 独立配置、API/网卡取 IP 和变更/失败事件通知；默认通过网卡取 IP，可切换为内置多接口 API fallback。
- 短信发送、接收监听、SQLite 持久化和多渠道通知转发。
- 自动化中心双轨任务调度引擎：支持在后台并行执行自动化任务，提供
定点定时（周几 + 具体时间，如每周二 03:00）和间隔周期（按分钟/小时/天，如每 180 天）调度模式。 - 多种自动化动作支持：支持
重启基带、安全重启系统（支持延时）和发送短信（支持随机延迟、自动生成随机字符防止拦截、发送失败自动重试）。 - 自动化事件通知与运行日志管理：任务执行后写入本地 SQLite 日志表（支持关键词检索、日期筛选、手动/自动清理策略），并可将执行结果（成功/失败）作为事件实时推送至通知通道。
- APN 列表读取和 APN 修改。
- 运营商列表、扫描、手动注册、自动注册。
- eSIM 模式下按需调用
lpac管理实体 eUICC SIM 卡 Profiles；普通 SIM 模式下不调用 eSIM 能力。 - ARM64 / x86_64 分别发布为
simadmin-arm64.tar.gz和simadmin-amd64.tar.gz；安装与 OTA 自动匹配架构，并准备对应的私有lpac。 - OTA 上传、在线下载、校验、替换二进制和前端资源。
- 实现用户态 IKEv2 协议协商与 IPsec/ESP 安全报文加解密，提供零外部依赖的 VoWiFi 运行环境。
- 集成 QMI UIM D-Bus 接口直连硬件，利用实体/eSIM卡的物理硬件鉴权能力，支持 3GPP 规范的 EAP-AKA 鉴权。
- 支持 3GPP 动态运营商配置预设生成，自动解析 MCC/MNC 推导 ePDG 网关并原生支持大部分标准网络运营商。
- 落地用户态虚拟 TUN 路由转发与 IMS 注册，集成 SMS over IPsec 安全短信收发机制。
- 细化的 VoWiFi 错误诊断系统与连接状态时序图，支持连接中断后智能退避重试与自动恢复。