VoCat 支持 652 家全球运营商的秘密:Apple Carrier Bundle 自动同步机制全解析

原创2026-10-16 16:30:561,602 阅读

VoCat 支持 652 家全球运营商的秘密:Apple Carrier Bundle 自动同步机制全解析

为什么 VoCat(面向 Quectel EC20/EC25 蜂窝模组的 Web 控制面板)无需手工为每家运营商编写配置,就能开箱支持 652 家全球运营商的 Wi-Fi Calling?答案藏在一条自动同步管道里:VoCat 直接复用 Apple 公开的运营商 Bundle(Carrier Bundle)数据,将其批量转换成一份内置的 carrier_profiles.json,再靠一套加权匹配引擎按 SIM 属性精确命中。本文将完整拆解这套「Apple Carrier Bundle 自动同步」机制的工作原理、安全设计与手动导入方法。

VoCat 设备管理界面,展示 EC20 模组的 Wi-Fi Calling 状态与 SIM 运营商识别结果

652 家运营商:内置运营商数据库长什么样

VoCat 的运营商能力核心是一份 JSON 数据库 carrier_profiles.json,由 Go 的 //go:embed 直接编译进二进制,离线即可使用。文件头部的 metadata 标明了它的出处:

{
  "metadata": {
    "count": 652,
    "source": "dwilliamsuk/ios-carrier-bundles",
    "generated_at": "2026-08-19T17:12:07Z"
  }
}

每条 profile 只包含「SIM 或网络无法自动发现、必须靠经验给出的互通参数」,字段非常克制:

字段 作用 示例
match.home_plmns 按 MCC+MNC(PLMN)粗匹配 26223
match.iccid_prefixes / gid1_prefixes / spns 精确识别 MVNO / 子品牌 894936
epdg.hostname 运营商的 ePDG 入口域名 epdg.epc.mnc023.mcc262.pub.3gppnetwork.org
ike.proposal IKEv2 加密提议(modern / legacy) modern
ims.* IMS 注册、IPSec 加密等细节 aes-cbc

这套设计的巧妙之处在于:这些参数本来就需要为每部 iPhone 手工调通,Apple 工程师已经替 VoCat 把 ePDG 域名、IKE 提议、GID 识别符都验证好了,VoCat 只需「翻译」成自己的 schema。

VoCat 控制台 Dashboard,实时显示 EC20 模组在线状态与 Wi-Fi Calling 模块

自动同步管道:从 Apple Bundle 到一份 JSON

同步逻辑实现于 cmd/sync_carrier_bundles/main.go,整个流程只有五步:

  1. 下载归档:默认拉取 Apple 运营商 Bundle 的 latest.tar.gz 开源归档(可用 -url 或 -file 指向本地副本);
  2. 扫描 Bundle:逐个遍历 *.bundle 目录,只保留 carrier.plist 与 Overrides*.plist,跳过签名等无关文件;
  3. 转换规则:调用 carrier_ipcc.go 中的转换核心,把 Apple 的选择器映射成 VoCat 的匹配条件;
  4. 去重校验:按自动生成的 ID(形如 ipcc-ee-23430)去重,并做 schema 校验,无有效 VoWiFi 选择器的 Bundle 直接跳过;
  5. 原子写出:带 version 与 generated_at 的 JSON 一次性写入,每次运行结果可复现、可 diff。

转换核心 ImportCarrierBundlePlists()(见 carrier_ipcc.go)做了三件关键的事:

  • 选择器翻译:Apple 的 SupportedSIMs 字符串(如 26223_GID1-0A)被解析为 PLMN + GID/ICCID/SPN 前缀组合;
  • EPDG 提取:从 TechSettings.IKE.RemoteAddress 中提取 ePDG 域名,多设备 Override 之间冲突时宁缺毋滥,放弃该字段并输出警告;
  • IKE 提议归一:DH Group 14 → modern,Group 2 → legacy-sha1-modp1024,未知组一律忽略。

🔒 安全白名单:像 EnableWifiCallingWithoutEntitlement、ValidateRemoteCertificate=false 这类会削弱安全的字段,VoCat 一律拒绝导入并以结构化警告提示(见 carrier_ipcc.go)——这正是「自动同步」不会把坏数据带进生产的关键。

匹配引擎:GID 加权让 MVNO 精准命中

运行时,ResolveCarrierProfile()(carrier_compat.go)读取 SIM 的 ICCID、IMSI、SPN、GID1/GID2,对每条规则打分:

PLMN = 100 分,GID1 = 90 分,GID2 = 85 分,IMSI = 80 分,ICCID = 70 分,SPN = 20 分。多条规则同时命中时取总分最高者。

这个加权表就是 MVNO 精准识别的秘密:一张 giffgaff 卡借用宿主 EE 的 PLMN,宽泛的 EE 规则只得 100 分,而带 GID1+GID2 的 giffgaff 规则可得 180 分——后者胜出,绝不会把 MVNO 当成宿主运营商。若全部未命中,则回落到内置的 standard-3gpp 默认 profile(现代 IKE、EAP-AKA、AES-CBC),并按 3GPP 标准模板从 PLMN 推导 ePDG 主机名。

手动同步与单 Bundle 导入

批量刷新(重新生成数据库):

go run ./cmd/sync_carrier_bundles            # 默认输出 internal/vowifi/carrier_profiles.json
go run ./cmd/sync_carrier_bundles -file /path/to/bundles.tar.gz -output /path/out.json

单个 Bundle 导入(用户拿到的 .ipcc/.zip 归档):

vocat carrier import-ipcc --document-only MyCarrier.ipcc
vocat carrier import-ipcc --bundle AT&T.us.bundle --install MyCarrier.ipcc

命令实现见 cmd/vocat/carrier.go:

  • --document-only:只打印生成的 profile JSON,供人工审阅,不写盘;
  • --install:原子安装到数据库同级的 carrier-profiles.d 目录(临时文件 + rename,且从不覆盖已有 ID);
  • 一个归档含多个 Bundle 时用 --bundle 指定目标。

启动时,main.go 会调用 LoadCarrierProfileDirectory() 加载该目录:与内置 profile 重复 ID 直接报错,宽泛的 PLMN 规则也无法遮蔽更精确的已装 MVNO 规则。详见 docs/CARRIER_IPCC_IMPORT.md。

这套机制带来的实际效果

  • 免维护:Apple 更新 Bundle 归档后,重跑一次同步即可跟进 652 家运营商的参数变更,diff 一目了然;
  • MVNO 不再被误判:GID 加权让 Airalo、Cricket、giffgaff 这类共享宿主网络的 eSIM 精确归位;
  • 安全兜底:无法自动发现的参数回落 3GPP 标准默认值,危险字段永远拒绝导入;
  • 离线可用:数据库随二进制分发,无需运行时访问任何外部服务。

配合 mccmnc.json 离线运营商表(由 scripts/update-carriers.py 从 Android 开源数据刷新),VoCat 在设备详情里能同时显示「运营商名称 + 国家 + 准确的 Wi-Fi Calling 通道参数」——这正是控制台上「Wi-Fi Calling · All Ready」状态背后的底气。

登录后查看全文
VoCat