Skip to content
github-actions[bot] edited this page Nov 17, 2026 · 3 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. З робочим fingerprint вам не потрібні 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): подає підмінені системні властивості цільовим процесам через чистий попроцесний ремап області властивостей (без хука функцій).
  • resetprop: переписує системні властивості для всього пристрою, за групами (ідентичність, версія, стан завантаження, SELinux, adb/usb, анти-емулятор і прохід очищення). У режимі з областю групи ідентичності та версії не потрапляють до загальнопристроєвого проходу (Zygisk доставляє їх по процесах); групи завантаження, блокування та SELinux залишаються глобальними. Перемикається у COPG-VD-Settings.resetprop.
  • DRM / Widevine (motor_drm, вимкнено за замовчуванням): повідомляє вибраний рівень безпеки Widevine (L1 або L3) застосункам, що його читають. Див. розділ DRM нижче.

Підтримання fingerprint свіжим

Fingerprint старіє: Google ротує заводські образи, і старий поволі втрачає цінність. fingerprint-update.sh підтримує ваш актуальним, з найновішого заводського образу Google.

  • З WebUI (вкладка Інструменти): Перевірити оновлення і Оновити зараз.
  • Самостійно, раз на завантаження: Автооновлення JSON під час завантаження (ввімкнено за замовчуванням). Воно працює у фоні, продовжує спроби близько десяти хвилин, бо wifi зазвичай ще не піднятий під час завантаження, і ніколи не затримує завантаження.
  • Воно переписує лише поля build (fingerprint, ID, incremental, timestamp, патч безпеки, SDK, UUID, host, user). Усе, що ви налаштували, зберігається, а попередній вміст зберігається як .bak.
  • Воно ніколи не йде назад (старіша upstream-збірка відхиляється), і якщо ваш профіль підмінює інший пристрій, воно нічого не застосовує: fingerprint 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, що не залишає нічого в журналах завантаження.

Цих полів немає в постаченій конфігурації, і оновлювач ніколи їх не записує. Підміняти версію Android (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) і набуває чинності після наступного перезавантаження.

Аналіз: перевірте свою конфігурацію

Аналіз у WebUI (або fingerprint-update.sh analyze) перевіряє конфігурацію як вона є, і каже вам, що не так, перш ніж це зробить застосунок:

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

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

WebUI

Необов'язковий, але простий спосіб керувати всім. П'ять вкладок:

  • Про модуль: інформація про модуль і версію.
  • Пристрій: кожне поле build, задане за станом і згруповане за категоріями.
  • Spoofing: режим області та перемикачі рушіїв.
  • Система: групи resetprop.
  • Інструменти: Аналіз, Перевірити оновлення, Оновити зараз, Резервна копія / Відновлення, автооновлення при завантаженні, і звіт Діагностики (одна кнопка, щоб прочитати й експортувати все корисне для звіту про помилку).

Він не виконує жодних мережевих запитів; усе, що йому потрібно, постачається всередині модуля.

Усунення несправностей

  • Застосунок досі бачить справжній пристрій. Перевірте область: у playstore покривається лише стек Play. Переконайтеся, що конфігурація парситься (запустіть Аналіз). Після зміни рушіїв, drm_targets чи профілю перезавантажте: Zygisk читає область під час старту zygote.
  • Play Integrity досі не проходить. Переконайтеся, що fingerprint свіжий (Перевірити оновлення) і що 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