Repository navigation
ru USER GUIDE
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 переписывает отпечаток (fingerprint) и build устройства так, что выбранные вами приложения видят Pixel вместо вашего настоящего устройства. Это руководство проведёт вас от установки к рабочей конфигурации и через решения, встречающиеся по пути. Описание каждого поля и значения смотрите в CONFIGURATION.md; как это работает внутри: смотрите ARCHITECTURE.md.
- Прошейте zip в KernelSU, APatch или Magisk и перезагрузитесь.
- Zygisk должен быть активен (встроенный или ReZygisk / Zygisk Next). Пользователям Magisk: включите Zygisk.
- Модуль поставляется с профилем Pixel, поэтому сразу после перезагрузки стек Google Play уже видит этот Pixel. С рабочим отпечатком вам не нужны PlayIntegrityFix или GooglePhotosUnlimited.
Откройте WebUI из вашего root-менеджера, чтобы управлять модулем. Пользователи Magisk открывают его через
KsuWebUIStandalone или WebUI-X Portable или KsuWebUI-SN. Всё
можно также редактировать напрямую в /data/adb/COPG-VD/COPG-VD.json.
scope_mode определяет, какие процессы получают подменённую идентичность. В режиме с областью действия
идентичность доставляется для каждого процесса через Zygisk и не утекает в остальную
систему через глобальные свойства.
| Режим | Кто получает подмену |
|---|---|
playstore (по умолчанию) |
Только стек Play: сервисы Google Play, его нестабильный процесс и Play Store. |
global |
Всё устройство: каждый процесс. |
whitelist |
Только приложения, перечисленные в scope_whitelist. |
blacklist |
Все приложения, кроме перечисленных в scope_blacklist. |
Начните с playstore. Это самый лёгкий вариант и тот, что проходит Play Integrity,
не раскрывая подмену несвязанным приложениям.
Каждый движок независим и может быть выключен. Все включены по умолчанию, кроме DRM.
-
Поля Build (
motor_jni): переписываетandroid.os.Build.*в целевых процессах. Это то, что читает большинство приложений. -
Хук свойств (
motor_prop_hook): предоставляет подменённые системные свойства целевым процессам через чистое (clean-room) переотображение области свойств для каждого процесса (без хука функции). -
resetprop: переписывает системные свойства на уровне всего устройства, по группам (идентичность,
версия, состояние загрузки, SELinux, adb/usb, анти-эмулятор и проход очистки). В режиме с
областью действия группы идентичности и версии остаются вне прохода по всему устройству (Zygisk доставляет
их для каждого процесса); группы boot, lock и SELinux остаются глобальными. Переключается в
COPG-VD-Settings.resetprop. -
DRM / Widevine (
motor_drm, по умолчанию выключен): сообщает выбранный уровень безопасности Widevine (L1 или L3) приложениям, которые его читают. Смотрите раздел DRM ниже.
Отпечаток стареет: Google ротирует заводские образы, и старый постепенно теряет ценность.
fingerprint-update.sh поддерживает ваш актуальным, на основе новейшего заводского образа Google.
- Из WebUI (вкладка Tools): Check Update и Update Now.
- Самостоятельно, один раз за загрузку: Auto-update JSON on boot (включено по умолчанию). Работает в фоне, продолжает попытки около десяти минут, потому что wifi обычно ещё не поднят при загрузке, и никогда не задерживает загрузку.
- Переписывает только поля build (fingerprint, ID, incremental, timestamp, security
patch, SDK, UUID, host, user). Всё, что вы настроили, сохраняется, а предыдущее
содержимое сохраняется как
.bak. - Он никогда не откатывается назад (более старый upstream-build отклоняется), и если ваш профиль подменяет другое устройство, он не применяет ничего: отпечаток Pixel на другом профиле хуже, чем старый.
-
resetpropприменяется заново сразу после обновления, ноandroid.os.Buildзаписывается, когда стартует zygote, поэтому перезагрузитесь, чтобы новые значения дошли до приложений. Лог:/data/adb/COPG-VD/update.log.
Самое трудное, что нужно сделать правильно. ANDROID_VERSION, SDK_INT, SDK_FULL и CODENAME
описывают вашу ROM, а не устройство, которое вы подменяете. Если сказать приложениям, что SDK новее, чем
фреймворк на самом деле, они начнут вызывать API, которых не существует: приложения Google падают, телефон
перезагружается, и всё начинается заново. Сама загрузка завершается, поэтому это softloop, который
не оставляет ничего в логах загрузки.
Этих полей нет в поставляемой конфигурации, и апдейтер их никогда не записывает. Spoof
Android version (COPG-VD-Settings.spoof_version) решает, применяются ли они вообще:
-
never(по умолчанию): используется собственная версия ROM. -
rom: применяет только то, что не превышает ROM, что на практике означает понижение SDK. -
force: применяет ровно то, что указано в конфигурации. Именно это вызывает softloop; используйте его только если знаете, что целевой фреймворк это поддерживает.
Настоящая версия читается из /system/build.prop, никогда из getprop (который и есть то
самое, что этот модуль фальсифицирует). force также отклоняется при восстановлении резервной копии, так что
старая резервная копия не сможет снова взвести его за вашей спиной.
Выключен по умолчанию (motor_drm). Когда включён, сообщает выбранный уровень Widevine,
DRM_SECURITY_LEVEL (L1 или L3), приложениям, которые его читают.
По умолчанию подмена DRM следует за scope_mode. Чтобы применить её к конкретному набору приложений
вместо этого, независимо от основной области действия, перечислите их в drm_targets. Тогда модуль
остаётся загруженным в перечисленном приложении только ради хука DRM, даже когда это приложение вне
основной области действия; пустой или отсутствующий список означает следовать за областью действия. Для этого нужен режим с областью действия (не
global), и вступает в силу при следующей перезагрузке.
Analyze в WebUI (или fingerprint-update.sh analyze) проверяет конфигурацию в её текущем
виде и сообщает, что не так, прежде чем это сделает приложение:
- версию относительно ROM (вызовет ли она softloop?),
- по-прежнему ли файл парсится (сломанный заставляет модуль подменять ничего, и только logcat об этом скажет),
- согласуется ли fingerprint с полями вокруг него,
- ключи, которые модуль не читает, подозрительные даты и несут ли живые свойства уже то, что просит конфигурация.
Запускайте его всякий раз, когда редактируете конфигурацию вручную.
Опционально, но лёгкий способ управлять всем. Пять вкладок:
- About: информация о модуле и версии.
- Device: каждое поле build, задаётся по состоянию и сгруппировано по категориям.
- Spoofing: режим области действия и переключатели движков.
- System: группы resetprop.
- Tools: Analyze, Check Update, Update Now, Backup / Restore, автообновление при загрузке и отчёт Diagnostics (одна кнопка, чтобы прочитать и экспортировать всё полезное для отчёта об ошибке).
Он не делает ни одного сетевого запроса; всё, что ему нужно, поставляется внутри модуля.
-
Приложение всё ещё видит настоящее устройство. Проверьте область действия: в
playstoreпокрыт только стек Play. Убедитесь, что конфигурация парсится (запустите Analyze). После смены движков,drm_targetsили профиля перезагрузитесь: Zygisk читает область действия, когда стартует zygote. -
Play Integrity всё ещё не проходит. Убедитесь, что fingerprint свежий (Check Update) и
что
SECURITY_PATCHнаходится вglobal_fields, чтобы он оставался согласованным на всём устройстве. Убейте сервисы Google Play, чтобы они повторно прошли аттестацию. -
Телефон уходит в softloop после включения подмены версии. Это ловушка версии Android,
описанная выше: верните
spoof_versionобратно вnever. - WebUI не открывается на Magisk. Используйте KsuWebUIStandalone или WebUI-X Portable или KsuWebUI-SN.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.