VoCat eSIM管理实战:eUICC发现、配置文件切换与下载删除全操作指南 【免费下载链接】VoCatVocat is an open-source web control panel and engineering toolkit for Quectel EC20/EC25-class cellular modems. It combines modem discovery, live radio status, AT and USSD terminals, SMS, WiFi Calling, eSIM management, network selection, proxy routing, notifications, audit logs, and release automation in one self-contained service.项目地址https://gitcode.com/gh_mirrors/vo/VoCat点击查看免费下载VoCat 是一款面向 Quectel EC20/EC25 蜂窝模组的开源 Web 控制面板与工程工具套件内置完整的 eSIM 管理功能eUICC 发现、EID 信息查看、配置文件Profile列表、一键切换/禁用、Profile 下载写卡、改名与删除全部在一个自包含的网页服务中完成无需反复敲 AT 命令。为什么用 VoCat 管理 eSIM传统方式管理蜂窝模组上的 eSIM需要在串口里手工发送ATCSIMAPDU、解析二进制响应还要自己处理 eUICC 逻辑通道的开启与关闭。VoCat 把这些底层细节全部封装在 Web 界面里eUICC 发现自动探测卡片上的 ISD-R 应用含 XeSIM 与 eSTK 多存储卡读取 EID、生产信息与证书元数据Profile 列表实时展示每个配置文件的 ICCID、运营商名称、启用状态切换与禁用一次性确认按钮完成 Profile 切换自动处理 VoWiFi 维护窗口、飞行模式与网络恢复下载与删除按 GSMA SGP.22 流程在线写卡实时显示进度条与剩余空间变化通知处理查看 eUICC 待处理通知并重发响应。 可用功能取决于模组固件、USB 复合设备配置与 SIM/eSIM 能力。详细的能力矩阵见 docs/README.zh-CN.md。进入 eSIM 管理页面启动 Vocat 后登录 Web 控制台默认端口见 internal/config/config.go按以下路径进入左侧导航栏点击Devices在左侧设备列表中选中你的模组如 EC20在设备详情页顶部标签栏中点击eSIM标签。eSIM 标签页由 web/src/components/devices/DeviceEsimTab.tsx 渲染后端接口统一由 internal/server/esim_api.go 中的handleESIM路由处理所有路径形如/devices/{id}/esim/...。如果页面显示未检测到 eUICC说明当前插入的可能是普通 SIM 卡而非 eUICC 卡若提示热插拔后 eSIM 通道未恢复则需要重启模组让基带重新初始化 APDU 通道详见 internal/device/esim.go 中对ErrEUICCChannelStuck的说明。eUICC 发现EID、生产信息与芯片清单打开 eSIM 标签后VoCat 会自动完成发现流程展示项含义EIDeUICC 的唯一标识Electronic Identifier相当于芯片身份证AIDISD-R 应用标识多 eUICC 存储时每块芯片一个生产信息 / 证书元数据芯片厂商、生产日期、根证书指纹等剩余 NVRAM可用于判断还能写入多少 Profile底层实现位于 internal/device/esim.go通过ATCSIM透传通道手工执行 MANAGE CHANNEL / SELECT / STORE DATA且逻辑通道独立于模组自身的基本通道——读取和切换 Profile 不会干扰模组的网络注册。VoCat 同时支持标准 GSMA AID、XeSIM 备用 AID 以及 eSTK 多安全元件卡的多存储探测。配置文件切换与禁用一键 SwitchProfile 列表由 web/src/components/devices/EsimProfileRow.tsx 渲染每行包含状态圆点绿色已启用、运营商名称、ICCID敏感模式下模糊显示和三个操作按钮切换Switch把该 Profile 设为活动号码禁用Disable对已启用 Profile 显示禁用后 eUICC 没有活动号码蜂窝网络、VoWiFi 与短信都会中断直到重新启用或下载新 Profile改名Rename给 Profile 起一个易识别的昵称便于多号卡管理。切换背后发生了什么点击切换并非简单的写操作。VoCat 的切换流程见 internal/server/esim_api.go会进入VoWiFi 维护窗口如 VoWiFi 正在运行则先安静地拆掉 IMS/AKA 会话开启飞行模式RF off在CFUN4下执行 ISD-R 逻辑通道的 PROFILE ENABLE 操作实读 ICCID 校验确认目标 Profile 真正生效后才返回verified: true恢复该 ICCID 对应的卡片策略APN、VoWiFi 状态、飞行模式失败则回滚到安全状态。因此切换过程中蜂窝网络会短暂中断属于正常现象。响应体中的card_policy字段会带回切换后的完整策略方便前端刷新界面。禁用 Profile 的注意事项禁用确认框会明确提示若你的卡片策略设置了禁用即删除eUICC 可能在禁用时直接删除该 Profile。这是 eUICC 的安全策略行为删除后无法找回建议谨慎操作。下载新 Profile在线写卡完整流程当 eUICC 还有剩余空间时可以在下载新 Profile表单中直接写卡。表单web/src/components/devices/EsimDownloadForm.tsx包含四个字段字段必填说明SM-DP 地址✅运营商的 SM-DP 服务器域名例如rsp.truphone.comMatching ID❌用于限定安装哪个 Profile未指定时由服务器选择确认码❌部分运营商要求的短信确认码目标 eUICC❌多 eUICC 存储时选择写入哪块芯片下拉框会显示各芯片可用空间点击开始下载后VoCat 通过 SSEServer-Sent Events流式返回进度条实时展示每一步正在检查 eUICC 剩余空间... 请求 challenge / 获取 EUICC 信息 ES9 双向认证InitiateAuthentication PrepareDownload → GetBoundProfilePackage LoadBoundProfilePackage安装 Profile HandleNotification → 下载完成完整 SGP.22 流程在 internal/device/esim_download.go 中实现整个下载过程持有 eSIM 互斥锁防止并发的列表读取或切换打断写卡。下载失败常见原因速查界面会给出明确的中文错误提示见 web/src/components/devices/DeviceEsimTab.tsx错误码提示处理办法euicc_insufficient_memoryeUICC 空间不足先删除不用的 Profile 再重试euicc_ci_incompatibleSM-DP 证书链不受信任该卡与当前测试服务器不兼容换服务profile_pool_empty公开 Profile 库存耗尽稍后重试或更换服务删除 Profile 与释放空间Profile 行右侧的删除按钮配合 web/src/components/devices/DeleteProfileModal.tsx 的二次确认弹窗会调用DELETE /devices/{id}/esim/profiles/{iccid}接口后端实现在 internal/server/esim_api.go。删除成功后响应会返回spaceDelta本次释放的字节数方便你确认 eUICC 空间确实被回收。若响应带warning字段例如删除后 eUICC 短暂不可用界面会提示等待或重启模组。⚠️删除不可逆Profile 从 eUICC 上移除后只能重新走下载流程写卡。活动号码所在的 Profile 请先切换走再删除。查看与重发 eSIM 通知eUICC 会记录运营商下发的待处理通知如远程删除指令的应答请求。VoCat 提供通知列表与重试上报功能后端接口GET /devices/{id}/esim/notifications、POST .../notifications/{seq}/actions/retry通知中心弹窗web/src/components/devices/EsimNotificationsModal.tsx设备层通知处理internal/device/esim_notifications.go。点击重试后通知会重新上报给运营商并从 eUICC 待处理列表中移除返回通知已上报运营商的确认信息。安全与合规提醒Vocat不会绕过运营商鉴权、网络策略、硬件安全或 eSIM 信任要求接口能发起请求不代表运营商一定会放行eSIM 下载、删除、重命名属于敏感操作界面上均使用一次性确认按钮自动化机器人不暴露这些命令见 docs/README.zh-CN.md 安全章节所有操作都会记入审计日志可在 Live Logs 页面追溯。相关源码导航想深入了解 eSIM 管理的实现可以从以下模块入手模块路径eUICC / LPA 访问层SGP.22internal/device/esim.goProfile 下载写卡internal/device/esim_download.goProfile 删除internal/device/esim_delete.goProfile 改名internal/device/esim_rename.goES9 认证协议internal/device/es9p.goHTTP API 路由internal/server/esim_api.go前端 eSIM 标签页web/src/components/devices/DeviceEsimTab.tsx设备总页面web/src/pages/DevicesPage.tsx按照本指南你可以在几分钟内完成从 eUICC 发现到 Profile 切换、下载、删除的全流程操作——把 Vocat 部署在 Linux 主机上插上 Quectel EC20/EC25 模组eSIM 管理从此不再需要碰串口。赞分享【免费下载链接】VoCatVocat is an open-source web control panel and engineering toolkit for Quectel EC20/EC25-class cellular modems. It combines modem discovery, live radio status, AT and USSD terminals, SMS, WiFi Calling, eSIM management, network selection, proxy routing, notifications, audit logs, and release automation in one self-contained service.项目地址https://gitcode.com/gh_mirrors/vo/VoCat点击查看免费下载相关推荐Amaze文件管理器文件操作原理揭秘Android文件管理的底层实现机制Amaze文件管理器文件操作原理揭秘Android文件管理的底层实现机制 Amaze文件管理器是一款基于Material Design设计的Android开源移动开发EasyLPAC一站式eSIM管理工具让eUICC操作变得简单高效EasyLPAC一站式eSIM管理工具让eUICC操作变得简单高效 还在为复杂的eSIM配置而烦恼吗EasyLPAC正是你需要的解决方案这个基于lpac的桌面应用Nexa SDK模型管理完全指南下载、缓存、删除操作详解Nexa SDK模型管理完全指南下载、缓存、删除操作详解 想要高效使用Nexa SDK进行AI应用开发掌握模型管理是关键Nexa SDK提供了一套完整的模人工智能大模型推理引擎本地部署多模态上一篇30亿激活参数撬动280亿能力ERNIE-4.5-VL如何重塑多模态AI经济学下一篇Sunshine 游戏串流主机快速上手指南5 步搭好免费自托管的 Moonlight 服务端创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考