VoCat 支持 652 家全球运营商的秘密:Apple Carrier Bundle 自动同步机制全解析
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 自动同步」机制的工作原理、安全设计与手动导入方法。
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。
自动同步管道:从 Apple Bundle 到一份 JSON
同步逻辑实现于 cmd/sync_carrier_bundles/main.go,整个流程只有五步:
- 下载归档:默认拉取 Apple 运营商 Bundle 的
latest.tar.gz开源归档(可用-url或-file指向本地副本); - 扫描 Bundle:逐个遍历
*.bundle目录,只保留carrier.plist与Overrides*.plist,跳过签名等无关文件; - 转换规则:调用 carrier_ipcc.go 中的转换核心,把 Apple 的选择器映射成 VoCat 的匹配条件;
- 去重校验:按自动生成的 ID(形如
ipcc-ee-23430)去重,并做 schema 校验,无有效 VoWiFi 选择器的 Bundle 直接跳过; - 原子写出:带
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」状态背后的底气。

