PlayIntegrityFix 快速安装指南:4 步让 Root 设备通过 Play Integrity 验证
【免费下载链接】PlayIntegrityFixFix Play Integrity (and SafetyNet) verdicts.项目地址: https://gitcode.com/GitHub_Trending/pl/PlayIntegrityFix
Root 之后,不少 App 会卡在 Play Integrity 验证不通过上,功能直接受限。本文带你完整走一遍 PlayIntegrityFix 的安装:启用 Zygisk、装模块、查配置、测验证结果,每一步都有可核对的预期输出,最后附常见报错对照表。
PlayIntegrityFix 是什么:30 秒理解它的作用
PlayIntegrityFix 是一个运行在 Magisk / KernelSU / APatch 上的 Root 模块,用来修复被 Google Play Integrity(设备完整性在线验证,前身是 SafetyNet)判为不通过的设备。它的原理是:在 Google Play 服务进程启动时,把设备指纹(型号、构建号、安全补丁等)替换成一台官方认证过的 Pixel,并修正一批暴露 Root 特征的系统属性。
安装前置条件检查清单
| 项目 | 要求 | 检查方式 |
|---|---|---|
| Android 版本 | 8.0(API 26)及以上,模块支持 8-15 | 设置 → 关于手机 |
| Root 环境 | 已装 Magisk / KernelSU / APatch 任一 | 打开对应 App 查看 Root 状态 |
| Zygisk | 必须开启(Magisk 中负责把模块注入系统进程的机制) | Magisk 设置页有开关;KernelSU / APatch 默认带 Zygisk |
| 网络 | 安装过程中必须联网 | 脚本会自动抓取最新 Pixel Beta 指纹 |
| 冲突模块 | 不建议同时装 safetynet-fix、playcurl、MagiskHidePropsConf | 看 Root App 的模块列表 |
安装脚本会自动移除已存在的safetynet-fix并给出playcurl、MagiskHidePropsConf的冲突提示,但最省事的做法是装之前就先清掉它们。
PlayIntegrityFix 模块安装步骤
第 1 步:先启用 Zygisk
- 做什么:在 Root 管理器里开启 Zygisk,这是模块生效的前提。
- 怎么做:Magisk → 设置 → 打开「Zygisk」开关;KernelSU / APatch 原生支持,无需额外操作。
- 完成后你应该看到:Magisk 设置里 Zygisk 开关为开启状态;若未开启,后续安装会直接报 "Zygisk is not enabled" 并中止。
第 2 步:下载模块安装包
- 做什么:下载最新版本的模块 zip(当前为 v19.1,文件名形如
PlayIntegrityFix_v19.1.zip,版本号以项目最新发布为准)。 - 怎么做:从项目发布页(Releases)下载即可,文件很小,无需 clone 源码。
- 完成后你应该看到:本地下载目录里有一个形如
PlayIntegrityFix_v19.1.zip的文件。
⚠️ 警告:不要在 Recovery 里刷入该 zip(安装脚本检测到非开机模式会直接报错中止,模块完全不生效)。正确做法是:从 Magisk / KernelSU / APatch 应用内「从本地安装」。
第 3 步:从 Root 应用安装模块
- 做什么:在 Root App 的模块页面选择下载的 zip 进行安装。
- 怎么做:Magisk → 模块 → 安装(从存储中选择);KernelSU / APatch 操作相同。
- 完成后你应该看到:安装日志输出
[+] PlayIntegrityFix v19.1和- new pif.json saved to /data/adb/pif.json;按提示重启设备后,模块列表出现「Play Integrity Fix」且状态为已启用(v19.1)。
💡 提示:安装过程需要联网——module/action.sh 会抓取最新 Pixel Beta 的设备指纹写入配置。断网会报 "download failed!",连上网络重装即可。
第 4 步:验证安装结果
- 做什么:用终端确认模块目录和配置文件存在。
- 怎么做:
ls /data/adb/modules/playintegrityfix # 模块目录 cat /data/adb/pif.json # 设备指纹配置- 完成后你应该看到:目录存在;
pif.json里有 4 个字段,与仓库默认配置 module/pif.json 结构一致:
{ "FINGERPRINT": "google/oriole_beta/oriole:16/BP22.250325.012/13467521:user/release-keys", "MANUFACTURER": "Google", "MODEL": "Pixel 6", "SECURITY_PATCH": "2025-04-05" }模块实际分两层工作:app/src/main/cpp/main.cpp 中的 Zygisk 代码注入 Google Play 服务进程替换设备信息,module/下的 shell 脚本在开机时修复暴露 Root 的属性。
第 5 步:用检测 App 验证 Play Integrity
- 做什么:安装「Play Integrity Checker」App(各应用市场可搜到),运行一次检查。
- 怎么做:打开 App → 点 Check,等待结果。
- 完成后你应该看到:App / Integrity / Device 三项状态。Android 12 及以下设备,装好即应三项全过;Android 13+ 设备 Device 一项默认过不了,解法见下文「进阶」部分。
常见报错现象对照表
| 现象 | 可能原因 | 解法 |
|---|---|---|
| 安装日志报 "Install from recovery is NOT supported" | 在 Recovery 里刷入了 zip | 回到 Root App 内重新安装 |
| 安装中止 "Zygisk is not enabled" | Zygisk 没开 | Magisk 设置里开启,或装 ZygiskNext / ReZygisk 模块 |
| "Unable to connect to ... / download failed!" | 安装时断网(需抓 Pixel Beta 指纹) | 联网后重装 |
| "Please remove busybox and try again" | 装了 busybox 模块产生冲突 | 模块列表里移除 busybox 模块 |
| App / Integrity 过、Device 不过(Android 13+) | Google 移除了旧版校验 | 装 TrickyStore + 有效 keybox,见进阶部分 |
| Play 商店提示设备未认证 | GMS 缓存未刷新 | 终端执行pm clear com.google.android.gms后重启 |
| 与旧模块行为互相干扰 | 同时存在 safetynet-fix / playcurl | 脚本会自动移除 safetynet-fix;playcurl 可能覆盖指纹,建议卸载 |
进阶配置与版本维护
自定义设备指纹
/data/adb/pif.json的优先级最高,改完重启生效。FINGERPRINT按/和:拆开后必须是 8 段(品牌/产品/设备/Android 版本/构建 ID/增量号/类型/标签),段数不对会在日志里报 "Error parsing fingerprint values!"。除必填字段外,还支持spoofProps、spoofProvider、spoofSignature、DEVICE_INITIAL_SDK_INT、DEBUG等可选开关,控制哪些伪装行为生效。
过 Android 13+ 的 Device 判定
⚠️ 警告:Android 13+ 上 Device 判定等价于旧的 Strong 判定(后果:不额外配置就永远过不了 Device)。正确做法是:加装 TrickyStore 模块并配置有效 keybox——PlayIntegrityFix 检测到 TrickyStore 后会自动关闭自身属性伪装以避免冲突。项目 README 也明确建议:非资深用户如果必须让设备认证,直接刷官方 ROM 并锁 Bootloader 更稳妥。
更新模块
- 直接在 Root App 内安装新版 zip 即可覆盖升级。
- 注意:升级脚本会把你自定义过的
/data/adb/pif.json备份为pif.json.old并写入一份新抓取的配置,升级后如果指纹被重置,手动把.old的内容改回来即可。 - 项目内置
update.json供 Root App 检查新版本;changelog.md 记录了每次改动,v19.1 的更新内容就是刷新指纹。
要点回顾
- 前提:Android 8.0+、已 Root、Zygisk 已开启、安装时联网。
- 只从 Magisk / KernelSU / APatch 应用内安装,别在 Recovery 刷。
- 装完先确认
/data/adb/pif.json存在,再用 Play Integrity Checker 看三项状态。 - Android 13+ 想过 Device 判定需要 TrickyStore + keybox。
- Google 会持续收紧校验,尽量保持模块为最新版。
如果这篇帮到了你,欢迎点个收藏,下一篇我们讲 TrickyStore 与 keybox 的详细配置。
【免费下载链接】PlayIntegrityFixFix Play Integrity (and SafetyNet) verdicts.项目地址: https://gitcode.com/GitHub_Trending/pl/PlayIntegrityFix
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考