Repository navigation
th 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 services, โปรเซส unstable ของมัน และ Play Store |
global |
ทั้งอุปกรณ์: ทุกโปรเซส |
whitelist |
เฉพาะแอปที่อยู่ในรายการ scope_whitelist
|
blacklist |
ทุกแอปยกเว้นที่อยู่ใน scope_blacklist
|
เริ่มด้วย playstore เป็นตัวเลือกที่เบาที่สุดและเป็นตัวที่ผ่าน Play Integrity
โดยไม่เปิดเผยการปลอมให้กับแอปที่ไม่เกี่ยวข้อง
แต่ละเครื่องยนต์เป็นอิสระต่อกันและสามารถปิดได้ ทั้งหมดเปิดอยู่โดยค่าเริ่มต้นยกเว้น DRM
-
ฟิลด์ Build (
motor_jni): เขียนandroid.os.Build.*ใหม่ในโปรเซสเป้าหมาย นี่คือสิ่งที่แอปส่วนใหญ่อ่าน -
Property hook (
motor_prop_hook): นำเสนอพร็อพเพอร์ตีระบบที่ปลอมขึ้นให้กับ โปรเซสเป้าหมาย ผ่านการรีแมป (remap) พื้นที่พร็อพเพอร์ตีแบบ clean-room รายโปรเซส (ไม่มีการ hook ฟังก์ชัน) -
resetprop: เขียนพร็อพเพอร์ตีระบบใหม่ทั้งอุปกรณ์ แบ่งเป็นกลุ่ม (identity,
version, boot state, SELinux, adb/usb, anti-emulator และการเก็บกวาดอีกรอบหนึ่ง) ในโหมด
ที่มีขอบเขต กลุ่ม identity และ version จะไม่อยู่ในรอบที่ทำทั้งอุปกรณ์ (Zygisk ส่ง
ให้เป็นรายโปรเซส) กลุ่ม boot, lock และ SELinux ยังคงเป็นส่วนกลาง สลับเปิดปิดได้ที่
COPG-VD-Settings.resetprop -
DRM / Widevine (
motor_drm, ปิดโดยค่าเริ่มต้น): รายงานระดับความปลอดภัยของ Widevine ที่เลือก (L1 หรือ L3) ให้กับแอปที่อ่านมัน ดูหัวข้อ DRM ด้านล่าง
ลายนิ้วมือมีอายุ: Google หมุนเวียน factory image และตัวเก่าค่อย ๆ สูญเสียคุณค่า
fingerprint-update.sh คอยอัปเดตของคุณให้ทันสมัย จาก Google factory image ตัวใหม่ล่าสุด
- จาก WebUI (แท็บ Tools): Check Update และ Update Now
- โดยตัวมันเอง หนึ่งครั้งต่อการบูต: Auto-update JSON on boot (เปิดโดยค่าเริ่มต้น) มันทำงานใน เบื้องหลัง พยายามซ้ำเรื่อย ๆ ประมาณสิบนาทีเพราะปกติ wifi ยังไม่พร้อม ตอนบูต และไม่เคยทำให้การบูตช้าลง
- มันเขียนทับเฉพาะฟิลด์ build (fingerprint, ID, incremental, timestamp, security
patch, SDK, UUID, host, user) ทุกอย่างที่คุณปรับแต่งเองจะถูกเก็บไว้ และเนื้อหาเดิม
จะถูกบันทึกไว้เป็น
.bak - มันไม่เคยถอยหลัง (build ของต้นทางที่เก่ากว่าจะถูกปฏิเสธ) และถ้าโปรไฟล์ของคุณปลอม เป็นอุปกรณ์อื่น มันจะไม่ใช้อะไรเลย: ลายนิ้วมือ Pixel บนโปรไฟล์อื่นแย่กว่า ตัวเก่า
-
resetpropจะถูกใช้ซ้ำทันทีหลังการอัปเดต แต่android.os.Buildถูกเขียนตอน zygote เริ่ม ดังนั้นให้ รีบูต เพื่อให้ค่าใหม่ไปถึงแอป ล็อก:/data/adb/COPG-VD/update.log
สิ่งที่ยากที่สุดที่จะทำให้ถูกต้อง ANDROID_VERSION, SDK_INT, SDK_FULL และ CODENAME
อธิบาย ROM ของคุณ ไม่ใช่อุปกรณ์ที่คุณปลอม การบอกแอปว่า SDK ใหม่กว่า framework
จริง ๆ ทำให้มันเรียก API ที่ไม่มีอยู่: แอปของ Google ล่ม โทรศัพท์
รีบูต และเริ่มใหม่อีกครั้ง การบูตเองเสร็จสมบูรณ์ ดังนั้นมันจึงเป็น softloop ที่
ไม่ทิ้งอะไรไว้ในล็อกการบูต
ฟิลด์เหล่านี้ไม่ได้อยู่ในคอนฟิกที่มาพร้อมและตัวอัปเดตไม่เคยเขียนมัน Spoof
Android version (COPG-VD-Settings.spoof_version) ตัดสินว่าจะใช้มันหรือไม่:
-
never(ค่าเริ่มต้น): ใช้เวอร์ชันของ ROM เอง -
rom: ใช้เฉพาะสิ่งที่ไม่เกิน ROM ซึ่งในทางปฏิบัติหมายถึงการลด SDK ลง -
force: ใช้ตามที่คอนฟิกบอกทุกอย่าง นี่คือสิ่งที่ทำให้เกิด softloop ใช้มัน เฉพาะเมื่อคุณรู้ว่า framework เป้าหมายรองรับมัน
เวอร์ชันจริงถูกอ่านจาก /system/build.prop ไม่เคยจาก getprop (ซึ่งเป็น
สิ่งที่โมดูลนี้ปลอม) force ยังถูกปฏิเสธเมื่อกู้คืนข้อมูลสำรอง ดังนั้น
ข้อมูลสำรองเก่าจึงไม่สามารถเปิดใช้มันกลับมาลับหลังคุณได้
ปิดโดยค่าเริ่มต้น (motor_drm) เมื่อเปิด มันจะรายงานระดับ Widevine ที่เลือก
DRM_SECURITY_LEVEL (L1 หรือ L3) ให้กับแอปที่อ่านมัน
โดยค่าเริ่มต้น การปลอม DRM จะทำตาม scope_mode ในการใช้มันกับชุดแอปที่เฉพาะเจาะจง
แทน, โดยเป็นอิสระจากขอบเขตหลัก, ให้ลงรายการไว้ใน drm_targets จากนั้นโมดูลจะ
ยังคงโหลดอยู่ในแอปที่ลงรายการไว้ เพียง เพื่อ DRM hook แม้ว่าแอปนั้นจะอยู่นอก
ขอบเขตหลัก รายการที่ว่างเปล่าหรือไม่มีอยู่หมายถึงทำตามขอบเขต สิ่งนี้ต้องใช้โหมดที่มีขอบเขต (ไม่ใช่
global) และจะมีผลในการ รีบูต ครั้งถัดไป
Analyze ใน WebUI (หรือ fingerprint-update.sh analyze) ตรวจสอบคอนฟิกตามที่
มันเป็นอยู่ และบอกคุณว่ามีอะไรผิดก่อนที่แอปจะทำ:
- เวอร์ชันเทียบกับ ROM (มันจะ softloop ไหม?)
- ไฟล์ยัง parse ได้หรือไม่ (ไฟล์ที่เสียทำให้โมดูลปลอม อะไรไม่ได้เลย และมีแต่ logcat เท่านั้นที่จะบอกได้)
- ลายนิ้วมือสอดคล้องกับฟิลด์รอบ ๆ มันหรือไม่
- คีย์ที่โมดูลไม่อ่าน วันที่ที่น่าสงสัย และพร็อพเพอร์ตีสด ๆ มีสิ่งที่ คอนฟิกขอไว้อยู่แล้วหรือไม่
เรียกใช้มันทุกครั้งที่คุณแก้ไขคอนฟิกด้วยมือ
เป็นทางเลือก แต่เป็นวิธีที่ง่ายในการควบคุมทุกอย่าง ห้าแท็บ:
- About: ข้อมูลโมดูลและเวอร์ชัน
- Device: ทุกฟิลด์ build ตั้งค่าเป็นรายสถานะและจัดกลุ่มตามหมวดหมู่
- Spoofing: โหมดขอบเขตและสวิตช์เครื่องยนต์
- System: กลุ่ม resetprop
- Tools: Analyze, Check Update, Update Now, Backup / Restore, การอัปเดตอัตโนมัติตอนบูต และรายงาน Diagnostics (ปุ่มเดียวเพื่ออ่านและส่งออกทุกอย่างที่มีประโยชน์สำหรับรายงาน บั๊ก)
มันไม่ส่งคำร้องขอผ่านเครือข่าย ทุกอย่างที่มันต้องการมาพร้อมภายในโมดูล
-
แอปยังเห็นอุปกรณ์จริง ตรวจสอบขอบเขต: ใน
playstoreมีเพียงสแตก Play เท่านั้นที่ถูกครอบคลุม ยืนยันว่าคอนฟิก parse ได้ (เรียกใช้ Analyze) หลังจากเปลี่ยนเครื่องยนต์,drm_targetsหรือโปรไฟล์ ให้ รีบูต: Zygisk อ่านขอบเขตตอน zygote เริ่ม -
Play Integrity ยังล้มเหลว ตรวจสอบให้แน่ใจว่าลายนิ้วมือสดใหม่ (Check Update) และ
ว่า
SECURITY_PATCHอยู่ในglobal_fieldsเพื่อให้มันคงความสอดคล้องทั้งอุปกรณ์ ฆ่า Google Play services เพื่อให้มัน re-attest -
โทรศัพท์ softloop หลังเปิดการปลอมเวอร์ชัน นั่นคือกับดักเวอร์ชัน Android
ด้านบน: ตั้ง
spoof_versionกลับเป็นnever - WebUI ไม่เปิดบน Magisk ใช้ KsuWebUIStandalone หรือ WebUI-X Portable หรือ KsuWebUI-SN
เอกสารนี้สร้างขึ้นด้วย Claude (Anthropic) และดูแลโดย VD171 ยินดีรับการแก้ไขและการปรับปรุง ดู CONTRIBUTING.md