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 services, โปรเซส unstable ของมัน และ Play Store
global ทั้งอุปกรณ์: ทุกโปรเซส
whitelist เฉพาะแอปที่อยู่ในรายการ scope_whitelist
blacklist ทุกแอปยกเว้นที่อยู่ใน scope_blacklist

เริ่มด้วย playstore เป็นตัวเลือกที่เบาที่สุดและเป็นตัวที่ผ่าน Play Integrity โดยไม่เปิดเผยการปลอมให้กับแอปที่ไม่เกี่ยวข้อง

เครื่องยนต์ (engine)

แต่ละเครื่องยนต์เป็นอิสระต่อกันและสามารถปิดได้ ทั้งหมดเปิดอยู่โดยค่าเริ่มต้นยกเว้น 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

สิ่งที่ยากที่สุดที่จะทำให้ถูกต้อง 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 ยังถูกปฏิเสธเมื่อกู้คืนข้อมูลสำรอง ดังนั้น ข้อมูลสำรองเก่าจึงไม่สามารถเปิดใช้มันกลับมาลับหลังคุณได้

DRM / Widevine

ปิดโดยค่าเริ่มต้น (motor_drm) เมื่อเปิด มันจะรายงานระดับ Widevine ที่เลือก DRM_SECURITY_LEVEL (L1 หรือ L3) ให้กับแอปที่อ่านมัน

โดยค่าเริ่มต้น การปลอม DRM จะทำตาม scope_mode ในการใช้มันกับชุดแอปที่เฉพาะเจาะจง แทน, โดยเป็นอิสระจากขอบเขตหลัก, ให้ลงรายการไว้ใน drm_targets จากนั้นโมดูลจะ ยังคงโหลดอยู่ในแอปที่ลงรายการไว้ เพียง เพื่อ DRM hook แม้ว่าแอปนั้นจะอยู่นอก ขอบเขตหลัก รายการที่ว่างเปล่าหรือไม่มีอยู่หมายถึงทำตามขอบเขต สิ่งนี้ต้องใช้โหมดที่มีขอบเขต (ไม่ใช่ global) และจะมีผลในการ รีบูต ครั้งถัดไป

Analyze: ตรวจสอบคอนฟิกของคุณ

Analyze ใน WebUI (หรือ fingerprint-update.sh analyze) ตรวจสอบคอนฟิกตามที่ มันเป็นอยู่ และบอกคุณว่ามีอะไรผิดก่อนที่แอปจะทำ:

  • เวอร์ชันเทียบกับ ROM (มันจะ softloop ไหม?)
  • ไฟล์ยัง parse ได้หรือไม่ (ไฟล์ที่เสียทำให้โมดูลปลอม อะไรไม่ได้เลย และมีแต่ logcat เท่านั้นที่จะบอกได้)
  • ลายนิ้วมือสอดคล้องกับฟิลด์รอบ ๆ มันหรือไม่
  • คีย์ที่โมดูลไม่อ่าน วันที่ที่น่าสงสัย และพร็อพเพอร์ตีสด ๆ มีสิ่งที่ คอนฟิกขอไว้อยู่แล้วหรือไม่

เรียกใช้มันทุกครั้งที่คุณแก้ไขคอนฟิกด้วยมือ

WebUI

เป็นทางเลือก แต่เป็นวิธีที่ง่ายในการควบคุมทุกอย่าง ห้าแท็บ:

  • 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

Clone this wiki locally