Device Faker配置入门:两种写法+模板机制,新手10分钟上手应用机型伪装
Device Faker配置入门:两种写法+模板机制,新手10分钟上手应用机型伪装
Device Faker 是一个基于 Zygisk 的机型伪装模块,可以为不同的应用配置不同的伪装机型与系统属性。本文带你快速掌握它的 Device Faker 配置方法:配置文件的两种写法、模板机制与优先级规则,新手跟着做,10 分钟就能完成应用级别的机型伪装。
配置文件在哪里?热加载如何生效
安装模块后,所有配置都集中在一个 TOML 文件里:
/data/adb/device_faker/config/config.toml
三个关键特性,新手一定要知道:
- 🔄 热加载:模块在每次应用启动时重新读取配置,修改后只需重启目标应用,无需重启系统
- 🛡️ 单应用隔离:未出现在配置中的应用不做任何伪装;配置解析失败时该应用跳过伪装,不影响其他应用
- 📄 默认模板:仓库中的 module/config.toml 就是一份带完整中文注释的默认配置,直接照着抄即可
两种配置写法:模板批量套用 vs 应用直接配置
写法一:机型模板(推荐,一次配置多个应用)
在 [templates.模板名] 下定义机型字段,并把包名加入 packages 列表,列表中所有应用自动使用该模板:
[templates.redmagic_9_pro]
packages = [
"com.mobilelegends.mi",
"com.supercell.brawlstars",
]
manufacturer = "ZTE"
brand = "nubia"
model = "NX769J"
device = "REDMAGIC 9 Pro"
fingerprint = "nubia/NX769J/NX769J:14/UKQ1.230917.001/20240813.173312:user/release-keys"
build_id = "UKQ1.230917.001"
# 无需写 [[apps]],所有包名自动使用该模板
优点:集中管理机型和包名、无需重复写 [[apps]]、一眼看清哪些应用使用哪个模板。多用户场景还支持 com.example.app@999 这样的写法,仅对指定 userId 生效。
写法二:[[apps]] 直接配置(单应用独立设置)
不想用模板时,用 [[apps]] 为单个应用指定设备信息:
[[apps]]
package = "com.omarea.vtools"
manufacturer = "Xiaomi"
brand = "Xiaomi"
model = "2509FPN0BC"
device = "Xiaomi 15 Pro"
product = "popsicle"
name = "popsicle"
⚠️
package是唯一必填字段,缺失会导致整个配置解析失败。
模板机制核心:优先级规则
配置生效的优先级从高到低:
[[apps]] 直接配置 > 模板 packages 列表 > 全局默认值
这里有一个新手最容易踩的坑:[[apps]] 是整记录匹配。一旦包名命中 [[apps]],该条记录整体取代模板——记录里没写的字段不会回落到模板,只套用全局默认值。
[templates.redmagic_9_pro]
packages = ["com.mobilelegends.mi"] # 默认使用这个模板
manufacturer = "ZTE"
brand = "nubia"
[[apps]]
package = "com.mobilelegends.mi" # 命中后整记录取代模板
manufacturer = "Samsung"
# 模板中设置了但这里未写的字段(如 brand)不会生效
全局设置还有两个开关:debug(调试日志,默认关闭,建议保持关闭以提高隐蔽性)和 default_force_denylist_unmount(全局启用 Zygisk 的 FORCE_DENYLIST_UNMOUNT,可在模板/应用里覆盖)。
常用字段速查表
以下字段可在模板或 [[apps]] 中使用,同时驱动 android.os.Build 静态字段和对应系统属性:
| 字段 | 说明 | 示例 |
|---|---|---|
manufacturer |
厂商 | Xiaomi, Samsung |
brand |
品牌 | Redmi, nubia |
model |
型号 | NX769J, SM-S9280 |
name / device / product |
产品内部名 / 代号 | popsicle |
fingerprint |
指纹 | nubia/NX769J/... |
build_id |
Build ID | UKQ1.230917.001 |
android_version / sdk_int |
Android 版本 / SDK 级别 | "15" / 35 |
dpi |
临时屏幕密度(120–640) | 420 |
custom_props |
自定义系统属性 | 见 docs/CONFIG.md |
完整字段(含 hardware、board、marketname、分区变体等)请查 website/docs/guide/configuration/fields.md。
新手10分钟快速上手清单
- ⏱️ 第1分钟:确认已安装 Zygisk 实现(推荐 ZygiskNext,不支持 Magisk 自带 Zygisk),并在模块管理器中安装 device_faker zip、重启设备(详见 website/docs/guide/installation.md)
- ⏱️ 第3分钟:用文件管理器或 root 终端打开
/data/adb/device_faker/config/config.toml,可参考 module/config.toml 的注释模板 - ⏱️ 第5分钟:选择写法——多个游戏用同一机型 → 建模板加
packages;个别应用特殊设置 → 写[[apps]] - ⏱️ 第8分钟:从设备检测工具(如 DevCheck)抄取目标机型的
manufacturer、brand、model、fingerprint填入 - ⏱️ 第10分钟:强制停止并重新启动目标应用,打开应用内检测页面验证伪装是否生效 ✅
不想手改 TOML?模块自带 WebUI 管理界面,在模块页面点「WebUI」入口即可图形化编辑模板、批量套用包名,还支持从社区在线模板库一键导入,详见 website/docs/guide/webui.md。
进阶与参考资料
- 📖 完整配置说明:docs/CONFIG.md
- 🧭 基础配置指南:website/docs/guide/configuration/index.md
- ⚙️ 高级用法(属性伪造机制、调试日志):website/docs/guide/configuration/advanced.md
- 🧱 配置解析源码:src/config.rs
掌握「模板 + 直接配置」两种写法和优先级规则,你的 Device Faker 机型伪装就入门完成了——剩下的,只是挑一台心仪的"新手机"而已。