Repository navigation
uk 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, модуль вирішує у
preAppSpecialize, чи цей процес в області:-
в основній області (
playstore/global/whitelist/blacklist), або -
в області DRM (перелічений у
drm_targets). Якщо він ні там, ні там, модуль від'єднується від цього процесу (dlclose) і не залишає в ньому слідів.
-
в основній області (
-
Specialize. Для процесу, що залишається, рушії застосовуються у
postAppSpecialize, доки процес ще привілейований.
Оскільки fork'и успадковують копію пам'яті zygote за принципом copy-on-write, кожен застосунок стартує з конфігурації,
прочитаної під час завантаження. Модуль перечитує файл для цільового процесу лише коли той справді
змінився, тож щойно запущений чи повторно відкритий застосунок підхоплює відредагований профіль, але рішення про
область приймається під час старту zygote, тож зміна області, рушіїв чи
drm_targets потребує перезавантаження.
Кожен незалежний і перемикається.
-
Поля Build (
motor_jni). Переписуєandroid.os.Build.*(іBuild.VERSION.*) у цільовому процесі через JNI, тож код Java читає підмінені значення. -
Хук властивостей (
motor_prop_hook). Подає підмінені системні властивості процесу через чистий попроцесний ремап області властивостей (prop_virtualizer). Це ремап пам'яті, а не хук функції, тож немає відбитка хукнутої функції. - resetprop (загальнопристроєвий). Записує системні властивості за групами: ідентичність, версія, стан завантаження, SELinux, adb/usb, анти-емулятор, плюс прохід очищення. Його запускають скрипти завантаження. У режимі з областю групи ідентичності та версії залишаються поза (Zygisk доставляє їх по процесах); групи завантаження, блокування та SELinux залишаються глобальними, щоб пристрій був узгодженим.
-
DRM / Widevine (
motor_drm). Хукає методиMediaDrm, що повідомляють рівень безпеки Widevine (getSecurityLevel,getPropertyString), і повертає налаштований рівень. Хуки перевіряються на null, тож некоректний профіль деградує плавно замість падіння застосунку.drm_targetsдозволяє цьому рушію працювати на власному списку застосунків, відв'язаному від основної області.
Впроваджений процес працює в домені SELinux zygote, який за замовчуванням не може дістатися до
/data/adb. Модуль постачає власне sepolicy.rule, щоб це дозволити, і, як запасний варіант,
може читати конфігурацію через свій відкритий каталог модуля (getModuleDir), тож він продовжує
працювати навіть якщо збірка Zygisk перестане надавати цей шлях. Файл парситься невеликим
вбудованим парсером JSON (jsmn); файл, що не парситься, означає, що модуль не підміняє нічого.
fingerprint-update.sh оновлює поля build з найновішого заводського образу Google,
з WebUI чи раз на завантаження. Він використовує власний вбудований завантажувач модуля (не PATH
curl/wget), перевіряє кожне значення перед використанням, ніколи не йде назад і відхиляє
профіль, що підмінює інший пристрій. android.os.Build записується під час старту zygote, тож
нові значення доходять до застосунків при наступному перезавантаженні. Див. USER-GUIDE.md для користувацького
боку і CONFIGURATION.md для полів.
Підвищення SDK_INT / ANDROID_VERSION над тим, чим насправді є фреймворк ROM, змушує застосунки
викликати API, яких не існує, що валить застосунки Google і перезавантажує телефон у
softloop. Тому група версії вимкнена за замовчуванням і захищена за
spoof_version. Модуль читає справжню версію з /system/build.prop, ніколи з
getprop, бо getprop і є саме те, що він фальсифікує. Див. пастку у
USER-GUIDE.md.
Ця документація створена за допомогою Claude (Anthropic) і підтримується VD171. Виправлення та покращення вітаються; див. CONTRIBUTING.md.