我是让GPT帮我整得,现在使用良好。
Telegram iOS 推送异常排查指南
目前并不一定只有一个原因,更像是两类问题叠加:
APNs(Apple Push Notification Service)链路异常
- 中国大陆网络环境下,iPhone 到 Apple APNs 推送服务器的长连接异常。
- 常见表现:Telegram、X、Instagram、Discord 等多个海外应用同时收不到推送。
Telegram 官方 iOS 客户端自身问题
- Telegram-iOS 项目目前仍存在未关闭的推送相关问题。
- 甚至出现:
官方客户端不推送,而第三方客户端推送正常。
因此,目前没有可靠依据证明苹果正式屏蔽了 Telegram 推送。
一、先给 Quantumult X 配置 APNs 分流
1. 在 [policy] 中添加固定策略
建议不要使用自动测速或故障转移策略,避免 APNs 长连接频繁切换出口。
static = APNs, 华东专线→po0香港, KFC.JPT1-bxjb4qkydb
2. 在 [filter_local] 最前面添加规则
host-suffix, push.apple.com, APNs
ip-cidr, 17.249.0.0/16, APNs
ip-cidr, 17.252.0.0/16, APNs
ip-cidr, 17.57.144.0/22, APNs
ip-cidr, 17.188.128.0/18, APNs
ip-cidr, 17.188.20.0/23, APNs
以上均为 Apple 官方公布的 APNs IPv4 地址段。
APNs 工作机制
- 主要端口:
TCP 5223
- 回退端口:
TCP 443
- 特点:设备需要与 Apple 服务器维持长期连接。
二、必须检查 excluded_routes
检查 [general] 配置:
excluded_routes =
绝对不要包含:
17.0.0.0/8
原因:
excluded_routes 中的流量不会经过 Quantumult X 处理。
如果将整个 17.0.0.0/8 排除:
- 后面的 APNs 分流规则将完全失效;
push.apple.com 规则也无法生效。
修改后建议:
- 保存配置;
- 重启 Quantumult X;
- 最好再重启一次手机。
三、重新建立 APNs 推送连接
按下面顺序操作:
- 关闭 Quantumult X;
- 开启飞行模式约 15 秒;
- 关闭飞行模式;
- 重新开启 Quantumult X;
- 打开 Telegram,停留十几秒;
- 锁屏;
- 用其他账号给自己发送消息测试;
- 分别测试:
四、不要对 APNs 进行 MITM
不要把:
push.apple.com
加入:
[mitm]
hostname =
Apple 明确要求:
APNs 经过代理时必须直接透传,不能进行 TLS 解密。
五、如何判断是哪一种故障
情况一:多个海外 App 都不推送
例如:
- Telegram
- X
- Discord
- Instagram
同时失效,但打开 App 后立即看到消息。
基本判断
✅ 优先考虑 APNs 链路问题。
建议:
- 添加上面的 APNs 域名规则;
- 添加官方 IP 段规则。
情况二:只有 Telegram 官方版不推送
如果:
- X 正常;
- Discord 正常;
- Instagram 正常;
只有 Telegram 官方客户端异常。
基本判断
✅ 更像是 Telegram iOS 客户端自身问题。
近期已有用户反馈:
多台设备均无法收到 Telegram 官方推送;
而以下第三方客户端工作正常:
Nicegram
iMe
Swiftgram
Turrit
六、Telegram 官方客户端故障的处理方法
依次尝试:
1. 重置 Telegram 通知
Telegram → 设置 → 通知与声音 → 重置所有通知
2. 重新授权系统通知
iOS 设置 → 通知 → Telegram
关闭后重新开启:
3. 更新软件
4. 重新安装 Telegram
删除后重新安装,让应用重新申请:
APNs Token
5. 对照测试
可临时安装可信第三方客户端测试。
⚠️ 不建议长期在不信任的第三方客户端中保存敏感账号。
七、圈 X 在蜂窝网络下仍然不推送怎么办?
如果出现:
- ✅ Wi-Fi 下恢复;
- ❌ 4G/5G 下仍无法恢复;
那么很可能是:
系统级 APNs 流量没有进入 Quantumult X 隧道。
而不是:
关于「包括 APNs」
目前 Quantumult X:
❌ 没有独立的「包括 APNs」开关。
社区测试反馈:
开启:
Include APNs
或:
包括 APNs
后,对蜂窝网络场景往往更有效。
但副作用可能包括:
- 个人热点异常;
- CarPlay 异常;
- 部分系统服务兼容性问题。
建议的排查优先级
① 给 QX 添加 APNs 域名规则
↓
② 添加 Apple 官方 IP 段
↓
③ 确认未排除 17.0.0.0/8
↓
④ 重建 APNs 长连接
↓
⑤ 测试 Wi-Fi 与蜂窝网络
↓
⑥ Wi-Fi 正常、蜂窝异常
↓
⑦ 考虑使用支持「包括 APNs」的客户端
一句话总结
多个海外 App 一起不推送 → 优先怀疑 APNs 链路问题。
只有 Telegram 官方版不推送 → 更可能是 Telegram iOS 客户端自身 Bug。