Repository navigation
zh ARCHITECTURE
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
COPG-VD 是一个 Zygisk 模块:一个很小的原生库(libspoof.so),由 Zygisk 加载器注入到 zygote
中,并从那里注入到应用进程中。它所做的全部就是向你所针对的进程呈现一个所选的设备身份。没有
应用程序,而且除了可选的配置文件获取之外,没有网络。
-
Zygote 启动。 当 zygote 启动时,加载器调用模块的
onLoad。它读取一次/data/adb/COPG-VD/COPG-VD.json:作用范围配置和配置文件。 -
应用 fork。 对于 zygote fork 出的每一个应用,模块在
preAppSpecialize中决定该进程是 否在作用范围内:-
在主作用范围内(
playstore/global/whitelist/blacklist),或 -
在 DRM 作用范围内(列在
drm_targets中)。 如果两者都不是,模块就从该进程分离(dlclose),不在其中留下任何痕迹。
-
在主作用范围内(
-
Specialize。 对于保留下来的进程,各引擎在
postAppSpecialize中应用,此时进程仍具有 特权。
由于各个 fork 继承了 zygote 的写时复制(copy-on-write)内存,每个应用都从开机时读取的配置开
始。模块只有在文件确实发生变化时才会按目标进程重新读取它,因此一个新启动或重新打开的应用会
获取到被编辑过的配置文件: 但作用范围的决定本身是在 zygote 启动时做出的,所以更改作用范
围、引擎或 drm_targets 需要重启。
每一个都是独立且可切换的。
-
Build 字段(
motor_jni)。 通过 JNI 在目标进程中重写android.os.Build.*(以及Build.VERSION.*),使 Java 代码读到被伪装的值。 -
属性 hook(
motor_prop_hook)。 通过对属性区域进行净室的、按进程的重映射 (prop_virtualizer),向进程呈现被伪装的系统属性。它是一次内存重映射,而不是函数 hook, 因此没有被 hook 的函数痕迹。 - resetprop(设备范围)。 按组写入系统属性: identity、version、boot state、SELinux、 adb/usb、anti-emulator,外加一次清理处理。开机脚本运行它。在一个有范围限制的模式下, identity 和 version 组被排除在外(由 Zygisk 按进程投递);boot、lock 和 SELinux 组保持全 局,以使设备保持一致。
-
DRM / Widevine(
motor_drm)。 Hook 报告 Widevine 安全级别的MediaDrm方法 (getSecurityLevel、getPropertyString),并返回所配置的级别。这些 hook 都做了空值检 查,因此一个格式错误的配置文件会优雅降级,而不是使应用崩溃。drm_targets让这个引擎在它自 己的应用列表上运行,与主作用范围解耦。
被注入的进程运行在 zygote 的 SELinux 域中,默认情况下无法访问 /data/adb。模块自带它自己的
sepolicy.rule 来允许这一点,并且作为一种回退,可以通过它打开的模块目录
(getModuleDir)读取配置,因此即使某个 Zygisk 版本不再授予该路径,它也能继续工作。文件是用
一个小型嵌入式 JSON 解析器(jsmn)解析的;一个无法解析的文件意味着模块什么都不伪装。
fingerprint-update.sh 从最新的 Google 出厂镜像刷新 build 字段,可从 WebUI 或每次开机一次。
它使用模块自带的下载器(而不是 PATH 中的 curl/wget),在使用前校验每一个值,绝不倒退,
并拒绝一个伪装成另一台设备的配置文件。android.os.Build 是在 zygote 启动时写入的,因此新值
会在下一次重启时到达应用。关于用户侧参见 USER-GUIDE.md,关于字段参见
CONFIGURATION.md。
把 SDK_INT / ANDROID_VERSION 提高到超过 ROM 框架实际的版本,会使应用去调用并不存在的
API,这会使 Google 的应用崩溃并把手机重启进一个软循环。因此 version 组默认关闭,并受
spoof_version 的把关。模块从 /system/build.prop 读取真实版本,绝不会从 getprop 读取,因
为 getprop 正是它所伪造的东西。参见 USER-GUIDE.md
中的陷阱。
本文档由 Claude (Anthropic) 生成,并由 VD171 维护。欢迎修正和改进;请参阅 CONTRIBUTING.md。