Repository navigation
fa 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 است: یک کتابخانه native کوچک (libspoof.so) که loader مربوط به
Zygisk آن را به درون zygote و، از آنجا، به درون پردازههای اپ تزریق میکند. تنها کاری که
میکند ارائه یک هویت دستگاه انتخابشده به پردازههایی است که هدف میگیرید. هیچ اپی وجود
ندارد و، جدا از دریافت اختیاری پروفایل، هیچ شبکهای نیست.
-
شروع Zygote. وقتی zygote boot میشود، loader تابع
onLoadماژول را فراخوانی میکند. یک بار/data/adb/COPG-VD/COPG-VD.jsonرا میخواند: پیکربندی scope و پروفایل. -
Fork اپ. برای هر اپی که zygote آن را fork میکند، ماژول در
preAppSpecializeتصمیم میگیرد که آیا این پردازه در scope است:-
در scope اصلی (
playstore/global/whitelist/blacklist)، یا -
در scope مربوط به DRM (فهرستشده در
drm_targets). اگر هیچکدام نباشد، ماژول از آن پردازه جدا میشود (dlclose) و هیچ ردی در آن باقی نمیگذارد.
-
در scope اصلی (
-
Specialize. برای پردازهای که باقی میماند، موتورها در
postAppSpecializeاعمال میشوند، در حالی که پردازه هنوز privileged است.
چون fork ها کپی copy-on-write حافظه zygote را به ارث میبرند، هر اپ از config خواندهشده
هنگام boot شروع میشود. ماژول فایل را به ازای هر پردازه هدف فقط وقتی دوباره میخواند که
واقعاً تغییر کرده باشد، پس یک اپ تازه راهاندازیشده یا دوباره بازشده یک پروفایل ویرایششده
را برمیدارد: اما خود تصمیم scope هنگام شروع zygote گرفته میشود، پس تغییر scope، موتورها
یا drm_targets به یک ریاستارت نیاز دارد.
هر کدام مستقل و قابل تعویض است.
-
فیلدهای Build (
motor_jni).android.os.Build.*(وBuild.VERSION.*) را در پردازه هدف از طریق JNI بازنویسی میکند، پس کد Java مقادیر جعلی را میخواند. -
Property hook (
motor_prop_hook). property های سیستمی جعلی را به پردازه از طریق یک remap تمیز (clean-room) و per-process از ناحیه property (prop_virtualizer) ارائه میدهد. این یک remap حافظه است، نه hook تابع، پس هیچ ردپای تابع hookشدهای وجود ندارد. - resetprop (سراسری در دستگاه). property های سیستم را گروه به گروه مینویسد: identity، version، boot state، SELinux، adb/usb، anti-emulator، به علاوه یک پاس پاکسازی. اسکریپتهای boot آن را اجرا میکنند. در یک حالت scoped، گروههای identity و version کنار گذاشته میشوند (Zygisk آنها را per-process تحویل میدهد)؛ گروههای boot، lock و SELinux سراسری میمانند تا دستگاه همخوان باشد.
-
DRM / Widevine (
motor_drm). متدهایMediaDrmرا که سطح امنیتی Widevine را گزارش میدهند (getSecurityLevel،getPropertyString) hook میکند و سطح پیکربندیشده را برمیگرداند. hook ها null-check شدهاند، پس یک پروفایل بدشکل به جای کرش کردن اپ به آرامی تنزل مییابد.drm_targetsبه این موتور اجازه میدهد روی فهرست اپ خودش اجرا شود، جدا از scope اصلی.
پردازه تزریقشده در دامنه SELinux مربوط به zygote اجرا میشود، که به صورت پیشفرض نمیتواند
به /data/adb دست یابد. ماژول sepolicy.rule خودش را عرضه میکند تا آن را مجاز کند، و، به
عنوان یک fallback، میتواند config را از طریق دایرکتوری باز ماژول خود (getModuleDir)
بخواند، پس حتی اگر یک build از Zygisk اعطای این مسیر را متوقف کند همچنان کار میکند. فایل با
یک parser کوچک JSON تعبیهشده (jsmn) parse میشود؛ فایلی که parse نمیشود یعنی ماژول هیچ
چیزی را spoof نمیکند.
fingerprint-update.sh فیلدهای build را از جدیدترین تصویر کارخانه Google تازه میکند، از
WebUI یا یک بار در هر boot. از downloader همراه خود ماژول استفاده میکند (نه یک curl/wget
از PATH)، هر مقدار را پیش از استفاده اعتبارسنجی میکند، هرگز به عقب نمیرود، و یک پروفایلی
که دستگاه متفاوتی را spoof میکند رد میکند. android.os.Build هنگام شروع zygote نوشته
میشود، پس مقادیر جدید در ریاستارت بعدی به اپها میرسند. برای سمت کاربر USER-GUIDE.md
و برای فیلدها CONFIGURATION.md را ببینید.
بالا بردن SDK_INT / ANDROID_VERSION فراتر از آنچه framework رام واقعاً هست باعث میشود
اپها API هایی را فراخوانی کنند که وجود ندارند، که اپهای Google را کرش میکند و تلفن را به
یک softloop ریاستارت میکند. بنابراین گروه version به صورت پیشفرض خاموش است و پشت
spoof_version محصور شده. ماژول نسخه واقعی را از /system/build.prop میخواند، هرگز از
getprop، چون getprop دقیقاً همان چیزی است که آن را جعل میکند. تله را در
USER-GUIDE.md ببینید.
این مستندات با Claude (Anthropic) تولید شده و توسط VD171 نگهداری میشود. اصلاحات و بهبودها خوشآمد است؛ به CONTRIBUTING.md مراجعه کنید.