Repository navigation
ko 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 모듈입니다: Zygisk 로더가 zygote에 주입하고, 거기서부터 앱 프로세스에 주입하는
작은 네이티브 라이브러리(libspoof.so)입니다. 하는 일은 당신이 대상으로 하는 프로세스에 선택한
디바이스 identity를 제시하는 것뿐입니다. 앱은 없으며, 선택적인 프로파일 가져오기를 제외하면
네트워크도 없습니다.
-
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로 상속하므로, 각 앱은 부팅 시 읽힌 config에서 시작합니다.
모듈은 파일이 실제로 변경되었을 때만 대상 프로세스별로 파일을 다시 읽으므로, 새로 시작되거나 다시
열린 앱은 편집된 프로파일을 가져옵니다: 그러나 스코프 결정 자체는 zygote 시작 시 이루어지므로,
스코프, 엔진 또는 drm_targets 변경에는 재부팅이 필요합니다.
각각 독립적이며 전환 가능합니다.
-
Build 필드 (
motor_jni). 대상 프로세스에서 JNI를 통해android.os.Build.*(및Build.VERSION.*)를 다시 작성하여, Java 코드가 스푸핑된 값을 읽도록 합니다. -
속성 후크 (
motor_prop_hook). 속성 영역(prop_virtualizer)의 clean-room 프로세스별 리맵을 통해 프로세스에 스푸핑된 시스템 속성을 제시합니다. 이것은 함수 후크가 아니라 메모리 리맵이므로, 후크된 함수 흔적이 없습니다. - resetprop (디바이스 전체). 시스템 속성을 그룹별로 작성합니다: identity, version, boot 상태, SELinux, adb/usb, anti-emulator, 그리고 정리 패스. boot 스크립트가 그것을 실행합니다. 스코프 모드에서는 identity와 version 그룹이 제외됩니다(Zygisk가 프로세스별로 전달); boot, lock, SELinux 그룹은 전역으로 유지되어 디바이스가 일관됩니다.
-
DRM / Widevine (
motor_drm). Widevine 보안 수준을 보고하는MediaDrm메서드 (getSecurityLevel,getPropertyString)를 후크하고 구성된 수준을 반환합니다. 후크는 null 체크되어 있으므로, 잘못된 프로파일은 앱을 충돌시키는 대신 우아하게 저하됩니다.drm_targets는 이 엔진이 메인 스코프와 분리된 자체 앱 리스트에서 실행되도록 합니다.
주입된 프로세스는 zygote SELinux 도메인에서 실행되며, 기본적으로 /data/adb에 도달할 수 없습니다.
모듈은 그것을 허용하는 자체 sepolicy.rule을 함께 제공하며, 폴백으로 열린 모듈 디렉터리
(getModuleDir)를 통해 config를 읽을 수 있어, Zygisk 빌드가 그 경로 부여를 중단하더라도 계속
작동합니다. 파일은 작은 임베디드 JSON 파서(jsmn)로 파싱됩니다; 파싱되지 않는 파일은 모듈이
아무것도 스푸핑하지 않음을 의미합니다.
fingerprint-update.sh는 WebUI에서 또는 부팅마다 한 번, 최신 Google factory image로부터 Build
필드를 새로 고칩니다. 모듈 자체의 번들 다운로더(PATH의 curl/wget이 아님)를 사용하고, 사용 전에
모든 값을 검증하며, 절대 뒤로 가지 않고, 다른 디바이스를 스푸핑하는 프로파일을 거부합니다.
android.os.Build는 zygote 시작 시 작성되므로, 새 값은 다음 재부팅 시 앱에 도달합니다. 사용자 측에
대해서는 USER-GUIDE.md를, 필드에 대해서는 CONFIGURATION.md를
참조하세요.
SDK_INT / ANDROID_VERSION을 ROM의 framework의 실제보다 높게 올리면 앱이 존재하지 않는 API를
호출하게 되어, Google의 앱이 충돌하고 전화기가 softloop로 재부팅됩니다. 따라서 version 그룹은
기본적으로 꺼져 있고 spoof_version 뒤에서 게이트됩니다. 모듈은 실제 버전을
/system/build.prop에서 읽으며, getprop에서는 절대 읽지 않습니다. getprop이 바로 그것이
위조하는 것이기 때문입니다. USER-GUIDE.md의 함정을
참조하세요.
이 문서는 Claude (Anthropic)로 생성되었으며 VD171이 유지 관리합니다. 수정 및 개선을 환영합니다. CONTRIBUTING.md를 참조하세요.