FCMFix ColorOS

修复 ColorOS 16 / 17(国行) 拦截 Google FCM 推送的 LSPosed 模块,需要 Root + LSPosed。

应用划掉后台或被系统停止后收不到推送、要等亮屏或打开应用才收到,多数是 ColorOS 的后台限制把消息拦在了 GMS 和应用之间。本模块解除这一段的限制,并阻止 ColorOS 切断 Google 核心服务的网络和唤醒。

基于上游 kooritea/fcmfix 53 版,13.0 起使用独立的版本号(此前形如 53-coloros-12.1)。

安装

  1. 确认手机已 Root,并安装可正常工作的 LSPosed(libxposed API 100 及以上)。
  2. 安装 Release 中的 APK。
  3. 在 LSPosed 中启用模块,作用域同时勾选“系统框架”和“电池(com.oplus.battery)”。
  4. 重启手机。
  5. 打开 FCMFix ColorOS,在“应用”页打开确实需要 FCM 后台推送的应用的开关,或开启“自动放行包含 FCM 的应用”, 并确认这些应用的通知权限已开启。
  6. “状态”页应显示“一切正常”,并逐项检查作用域、Hook 和 FCM 连接;收不到推送时,“应用”页会标出通知被关闭等问题, 并显示每个放行应用最近一次收到推送的时间。

从旧包名版本迁移时不能覆盖安装:先停用并卸载旧版,再安装新版并重新配置。不要同时启用两个 FCMFix。

它能解决什么

  • 应用划掉后台、被系统清理或处于“已停止”状态时,FCM 仍能唤醒它并显示通知;
  • 推送到达后,应用不会马上被 ColorOS 再次冻结或断网,能及时拉取消息内容;
  • ColorOS 不再把 GMS、Play 商店等 Google 核心服务设为禁止联网(包括开机解锁后的自动禁网);
  • 熄屏、Doze 以及“睡眠待机优化”按应用断网期间,GMS 保持联网;网络恢复后自动重连。

它不能解决什么

  • GMS 连不上 FCM 服务器:国内 mtalk.google.com 的解析常被污染,部分网络封锁 5228–5230 端口。 FCM Diagnostics 亮屏时也一直 disconnected,需要自行解决 DNS、hosts 或代理; “状态”页的“FCM 连接”会显示是否已连接、连接是否无响应,以及开机以来的重连和断线次数;
  • 应用本身不使用 FCM、服务器没有发送消息,或通知权限已关闭;
  • 系统整机断网(例如深度睡眠直接关闭 Wi-Fi / 移动数据)。

验证情况

一加 15 国行(PLK110)ColorOS 16 16.0.10.500 严格实机验证;ColorOS 17 17.0.0.102(CN01) 按全量包核对 Hook 点, 维护者日常使用正常。其他 ColorOS 16/17 机型可能可用,但未经同等级验证。

权限与风险

  • APK 不申请 INTERNET 权限,不通过开发者服务器中转推送;导出的报告只保存在本机,由你决定是否分享;
  • ACCESS_NETWORK_STATE(安装时自动授予,不能联网)用于在“时间线”中记录网络切换;QUERY_ALL_PACKAGES 仅用于扫描包含 FCM 的应用;
  • 这是 system_server 级别的 Hook,安装前请保留进入安全模式或禁用 LSPosed 模块的恢复手段。

更多

Releases

13.2

Stable

10/22/2026, 3:07:58 PM

13.2 正式版:全新界面(状态 / 应用 / 时间线三页),安装包从 7.5 MB 降到 2.8 MB,并包含 13.1 测试版的 ColorOS 16 适配和 FCM 连接检测改进。可直接覆盖 13.0 安装,安装后请重启。

  • 作用域:同时勾选“系统框架”和“电池(com.oplus.battery)”
  • 新界面(Material 3,跟随深色模式和壁纸取色):“状态”页即原来的自查;“应用”页可搜索、筛选“需要注意”,通知被关闭等问题直接标在列表中,点开应用可查看通知状态和推送次数;“时间线”可按类型筛选;原菜单中的选项移到设置
  • 放行改用每行右侧的开关,点击应用本身改为打开详情;配置沿用,升级后不用重新勾选
  • Release 启用 R8:Hook 部分代码保持原样,只压缩界面和依赖库
  • ColorOS 16 适配:深度睡眠联网白名单、深度睡眠恢复后强制停止 GMS;固件中本来没有的限制显示“不适用”,不再算作失配
  • FCM 连接:识别连接还在但没有响应的“假连接”,认出走 443 端口的 FCM 连接,注明所在网络
  • 自动放行的应用关闭通知不再算作问题;导出报告新增“GMS 的 FCM 连接”一节

完整说明:https://github.com/Artifical0/fcmfix-coloros/releases/tag/v13.2

SHA-256:84C6AF0DA7CC3CD097A429F326E95848D098150430BC5E2C97AEF91F5BEE5E2B

Assets

1

13.0

Stable

10/11/2026, 9:59:16 AM

13.0 正式版:电池作用域 Hook 真正生效、重启后不漏推送,新增自动放行和自查与导出报告。可直接覆盖 53-coloros-12.1 安装,安装后请重启。

  • 作用域:同时勾选“系统框架”和“电池(com.oplus.battery)”
  • 版本号改为独立的 13.0(此前形如 53-coloros-12.1),仍基于上游 fcmfix 53
  • 修正:电池组件与 Athena 共用 com.oplus.athena 进程,以前的版本从未在电池组件中挂上 Hook,现在 4 项都会生效
  • 修正:首次解锁后不再等待 1 分钟才放行 FCM,重启期间积压的消息不再被丢弃
  • 新增“自动放行包含 FCM 的应用”(默认关闭),新安装的应用也会自动放行,可在列表中排除
  • 新增自查与导出报告(不需要 Root):概览(作用域、Hook、GMS 联网策略、FCM 连接)、应用(通知状态、最近推送)、时间线(断线/重连、网络切换、Doze、推送);有 Root 时可导出完整报告
  • 顶部状态卡片、深色模式、新图标;应用列表后台加载
  • 新增 ACCESS_NETWORK_STATE 权限(用于时间线记录网络切换),仍不申请联网权限

完整说明:https://github.com/Artifical0/fcmfix-coloros/releases/tag/v13.0

SHA-256:23B0D2E869DC922E5D61887A49174892DE2987F32F85202A8CF8BDA33E75C569

Assets

1

10/7/2026, 9:22:19 AM

修复 ColorOS 17 国行夜间深度睡眠后、开机解锁后 FCM 断开不恢复的问题。可直接覆盖 53-coloros-11 安装,安装后请重启。

  • 作用域:同时勾选“系统框架”和“电池(com.oplus.battery)”
  • 深度睡眠:在系统框架中把 GMS 加入夜间联网白名单,恢复联网后自动重连,不再强制停止 GMS
  • 开机解锁后一直未连接(ERR_CLOSE_BY_USER_UNLOCKED):电池服务探测 Google 失败时的禁网规则在系统框架中丢弃,不依赖电池作用域(仅在电池组件声明 IgnoreGmsUserSet=true、流量管理隐藏 Google 联网开关时生效,否则保留用户手动设置)
  • Google 受限广播在系统框架入口清除,GMS 闹钟不降级、不进入 RARE 待机分组
  • Doze 白名单补入 GMS / GSF / Play 商店的位置加固,不受编译内联影响

完整说明:https://github.com/Artifical0/fcmfix-coloros/releases/tag/53-coloros-12.1

SHA-256:03A8DA65D9E5E7E57D930C8FF10E969EA56A3E851040BFF4C10573964DA33730

Assets

1

10/1/2026, 5:28:33 AM

全面覆盖 ColorOS 17 对 GMS / FCM 限制的正式版,同时继续支持 ColorOS 16。可直接覆盖 53-coloros-10 安装,安装后请重启。

  • 作用域:同时勾选“系统框架”和“电池(com.oplus.battery)”
  • ColorOS 17 流量管理隐藏 Google 联网开关时,清除旧的禁止联网状态
  • 深度睡眠(睡眠待机优化)期间 GMS 保持联网;熄屏弱信号时不对 GMS 断网
  • 系统始终视 GMS 为不受限:唤醒锁、OGuard 耗电管控、前台唤醒 GMS 不再受限
  • 对核验过的 FCM 放行冷启动拦截、云控“恶意应用”名单和关联启动限制
  • FCM 投递窗口内不拦截目标应用的后台作业(Gmail 等)
  • 应用内显示模块激活状态与缺少的作用域,应用列表支持搜索和筛选
  • 问题报告脚本改为读取 ColorOS 联网控制服务中的 Google 联网策略

完整说明:https://github.com/Artifical0/fcmfix-coloros/releases/tag/53-coloros-11

SHA-256:43AEB22AB2CD5AA8C6191ED08FA8CECF614B63650165615076B8C9E63579A76B

Assets

1

9/30/2026, 2:23:18 AM

支持 ColorOS 17(Android 17)的正式版,同时继续支持 ColorOS 16。可直接覆盖 53-coloros-8 安装,安装后请重启。

完整说明:https://github.com/Artifical0/fcmfix-coloros/releases/tag/53-coloros-10

SHA-256:577300815545F80D71716B5E3BF04A2379B60C1DA5B4C0ADD0981217B66ADE86

Assets

1

9/4/2026, 10:30:49 AM

首次提交 LSPosed 官方模块仓库。

  • 最终包名:io.github.artifical0.fcmfix.coloros
  • 支持 LSPosed Modern Xposed API
  • 推荐作用域:系统框架、com.oplus.battery
  • 修复 ColorOS 16 的 FCM 后台唤醒、广播投递、Hans 冻结和 Google 核心联网策略限制

SHA-256:BAD4541CD9C5DFFB96F4AF2ABC256DE2CC64319B1B7C98EDCDDA012F03A7E8A0

Assets

1