让一台 Mac 变成 4G 蜂窝语音网关：插上 QDC507 / EG25-G 4G 模块和 SIM 卡， iPhone 上的任意 SIP 客户端（推荐 YakPhone） 即可用这张 SIM 卡的号码拨打 / 接听 VoLTE 电话、收发短信——走局域网或 Tailscale，人在哪里都能用。
iPhone (YakPhone, SIP/RTP) Mac (本仓库) 4G 模块 (USB)
┌─────────────────────┐ ┌────────────────────────────────┐ ┌──────────────┐
│ 打电话 / 收短信 UI │◄──►│ cellbridge-gateway (SIP 5060) │◄──►│ VoLTE 语音 │
│ CallKit 来电推送 │ │ + 短信引擎 + Web 控制面 │ │ AT 指令 │
└─────────────────────┘ │ voice-audio-bridge (PCM 桥) │ │ UAC 8kHz │
局域网 / Tailscale │ at_pty_bridge (AT→PTY 串口) │ └──────────────┘
└────────────────────────────────┘
致谢：本项目基于 mccding/CellBridge 构建。 网关本体（SIP 服务器、短信引擎、Web 控制面、语音桥接框架）全部来自 CellBridge 上游， 本仓库在其之上做了 macOS + USB 4G 模块的移植与十余处修复（
gateway-patched/）。 没有这个优秀的开源项目，就没有 CellBridge-mac —— 衍生修复以同一 MIT 协议回馈社区。
- Mac（Intel 或 Apple Silicon 均可）
- 4G 模块：BAIWANG QDC507（DJI 定制，VID
0x2CA3/ PID0x4006）或 Quectel EG25-G 系列，经 USB 连接 - SIM 卡：插在模块里，开通 VoLTE，能正常打电话收短信
- iPhone：装 YakPhone（或任意 SIP 客户端）
- 模块侧语音运行时：模块内需已部署 VoLTE PCM 桥（
mavo-pcm-bridge）与语音内核模块。 可用module-tools/voice_runtime.py provision_runtime()在线拉取并校验后经 ADB 部署， 或使用 DJIphone Kit 一键部署。
git clone https://github.com/easonjoo/cellbridge-mac.git
cd cellbridge-mac
./install.sh # 缺什么补什么：依赖检查 → 拉上游源码 → 打补丁 → 编译 → 构建控制台
./install.sh --force # 全部重新编译安装脚本会做这些事（也可手动逐步执行，见 README-mac.md）：
- 检查依赖：Go 1.25+、Python 3 + pyusb、swiftc（Xcode CLT）、adb
- 拉取 mccding/CellBridge 上游源码到
/tmp/CellBridge-main - 用
gateway-patched/覆盖上游并编译出cellbridge-gateway（含 12+ 处 macOS/蜂窝修复） - 编译
voice-audio-bridge（Swift，蜂窝 UAC 音频 ↔ FIFO） - 构建
CellBridge Console.app（原生 AppKit 控制台，可选装到 /Applications） - 打印 YakPhone 需要填写的服务器地址
./start_cellbridge.sh脚本会自动完成：退出占用 USB 的 App → 拉起 AT 串口桥 → 等待串口就绪 → 强制重挂语音路由 → 启动网关（等健康检查 OK，非固定 sleep）→ 探测 Tailscale → 拉起通话后路由自动重挂守护 （rearm）→ 打印当前状态横幅。
登录自启动（推荐）：给 ~/Library/LaunchAgents 加一个 plist 指向本目录的
start_cellbridge.sh（RunAtLoad=true、KeepAlive={SuccessfulExit:false}），重启后自动就绪。
| 设置项 | 值 |
|---|---|
| SIP 服务器 | Mac 的局域网 IP（或 Tailscale IP 100.x.y.z）+ 端口 5060 |
| 用户名 | iphone |
| 密码 | 由 cellbridge.secrets.env 注入（模板见 cellbridge.secrets.env.example）。请改用强随机口令，切勿写进仓库或脚本 |
| 传输 | UDP |
填好后注册成功，即可：
- 打电话：直接在 YakPhone 里拨号（网关经 VoLTE 呼出）；别人打进 SIM 号码，iPhone 弹原生来电
- 收短信：进网关 Web 控制面
http://<Mac IP>:8787查看，或注册的 SIP 客户端接收 - 发短信：Web 控制台 / 控制台 App /
./send-sms.py <号码> <内容> - 锁屏来电：在 YakPhone 里复制 PushKit token，跑
./set-push-token.sh写入网关 （否则后台/锁屏状态下来电不振铃，这是唯一还需要手动配的项）
随时体检：./doctor.sh（只读，8 节报告，末尾直接给出 YakPhone 该填的地址）。
├── install.sh # 一键安装（依赖 → 拉上游 → 打补丁 → 编译 → 构建 App）
├── start_cellbridge.sh # 一键启动全套服务（就绪探测 + 守护拉起）
├── doctor.sh # 只读体检：进程/AT/SIP 注册/推送/短信/通话/重挂链路
├── remote-check.sh # 远程使用四项速查（Tailscale/SIP/push token）
├── tailnet-setup.sh # Tailscale 组网与 Serve 配置
├── gateway-patched/ # 上游 CellBridge 源码 + macOS/蜂窝补丁（含单测）
├── rebuild-gateway.sh # 重新拉上游 + 打补丁 + go test + 编译网关
├── at_pty_bridge.py # 模块 USB AT 通道 → PTY 串口桥
├── voice_audio_bridge.swift # 蜂窝 UAC 音频 ↔ FIFO（编译为 voice-audio-bridge）
├── mavo-route.sh # 模块侧 VoLTE 路由会话重挂
├── route-rearm.sh # 通话结束后自动重挂守护（每通电话都跑在新会话上）
├── tests/route-rearm-harness.sh# rearm 状态机离线回归（5 场景，无需真机）
├── send-sms.py / set-push-token.sh / test-push.sh
├── verify_cs_route.py # 端到端 CS 语音路由验证（FIFO PCM 统计）
├── module-tools/ # 模块侧工具：语音运行时部署 / UAC 音频开关 / tinyalsa 混音器
└── README-mac.md # 详细文档：配置、排障、12+ 处上游修复清单
先跑 ./doctor.sh，然后看 README-mac.md 的「排障」章节——里面有一张
症状速查表（接不通/没声音/第二通哑/推送不响/短信失败）和 12+ 处已修复的上游缺陷清单
（含每处的根因分析），多数问题都能对号入座。
- mccding/CellBridge —— 本项目的根基。
网关、短信引擎、语音桥接框架、控制面均来自上游；本仓库的
gateway-patched/只是 在其上的移植层与缺陷修复。感谢上游作者的出色工作。 - YakPhone —— iPhone 端 SIP 客户端。
- Tailscale —— 异地组网，让蜂窝网关跟着你走。
- bkerler/edl —— 模块刷机/救援工具链（未随仓库分发）。
本项目以 MIT 协议开源，与上游 CellBridge 一致。