Skip to content
github-actions[bot] edited this page Nov 17, 2026 · 7 revisions

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.

Установка

  1. Прошейте zip в KernelSU, APatch или Magisk и перезагрузитесь.
  2. Zygisk должен быть активен (встроенный или ReZygisk / Zygisk Next). Пользователям Magisk: включите Zygisk.
  3. Модуль поставляется с профилем 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

Самое трудное, что нужно сделать правильно. 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 также отклоняется при восстановлении резервной копии, так что старая резервная копия не сможет снова взвести его за вашей спиной.

DRM / Widevine

Выключен по умолчанию (motor_drm). Когда включён, сообщает выбранный уровень Widevine, DRM_SECURITY_LEVEL (L1 или L3), приложениям, которые его читают.

По умолчанию подмена DRM следует за scope_mode. Чтобы применить её к конкретному набору приложений вместо этого, независимо от основной области действия, перечислите их в drm_targets. Тогда модуль остаётся загруженным в перечисленном приложении только ради хука DRM, даже когда это приложение вне основной области действия; пустой или отсутствующий список означает следовать за областью действия. Для этого нужен режим с областью действия (не global), и вступает в силу при следующей перезагрузке.

Analyze: проверьте свою конфигурацию

Analyze в WebUI (или fingerprint-update.sh analyze) проверяет конфигурацию в её текущем виде и сообщает, что не так, прежде чем это сделает приложение:

  • версию относительно ROM (вызовет ли она softloop?),
  • по-прежнему ли файл парсится (сломанный заставляет модуль подменять ничего, и только logcat об этом скажет),
  • согласуется ли fingerprint с полями вокруг него,
  • ключи, которые модуль не читает, подозрительные даты и несут ли живые свойства уже то, что просит конфигурация.

Запускайте его всякий раз, когда редактируете конфигурацию вручную.

WebUI

Опционально, но лёгкий способ управлять всем. Пять вкладок:

  • 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.

Clone this wiki locally