贡献你的第一份机型模板:Device Faker 机型伪装配置仓库与社区支持完整指南
贡献你的第一份机型模板:Device Faker 机型伪装配置仓库与社区支持完整指南
Device Faker 是一个基于 Zygisk 的机型伪装模块,可以为不同的应用单独配置设备型号与系统属性。本文面向新手,手把手介绍 Device Faker 的机型模板配置仓库(device_faker_config):模板长什么样、如何用三种方式制作机型模板、如何提交你的第一份贡献,以及 WebUI 在线模板库与社区支持的完整用法,零基础也能 10 分钟上手。
📌 阅读时长约 8 分钟 | 前提条件:已安装 Device Faker 模块并能打开 WebUI
为什么要贡献机型模板?
机型模板是 Device Faker 的核心配置单元:一份 TOML 模板定义了一台"虚拟手机"的全部身份(厂商、品牌、型号、指纹等),通过 packages 列表即可一次性应用到多个应用。
贡献模板对所有人都受益:
- 🤝 社区复用:你整理好的机型会进入 device_faker_config 配置仓库,所有用户可在 WebUI「在线模板库」中按品牌、型号分类浏览并一键导入
- 🎯 质量沉淀:经过多人验证的模板,比随手写几行配置更可靠
- 🏷️ 分类体系:模板库按「通用设备 / 游戏设备 / 破限设备」三大类组织(见 webui/src/utils/onlineTemplates.ts),贡献前可以先看看同类模板
配置仓库与在线模板库如何工作
Device Faker 的模板生态由两部分组成:
| 部分 | 作用 |
|---|---|
| device_faker_config 配置仓库 | 社区机型模板的集中仓库,贡献者在此提交模板 |
| WebUI 在线模板库 | 模块内置功能,从配置仓库拉取模板,支持按品牌/型号浏览、搜索、一键导入 |
在线模板库的加载与导入逻辑见 webui/src/utils/onlineTemplates.ts;如果你加载失败,通常是设备网络问题,可参考 常见问题文档。本地配置与社区仓库相互独立——仓库更新不会影响你已有的本地模板。
机型模板包含哪些字段?
一份模板本质上就是 module/config.toml 中 [templates.xxx] 这样的段落:
[templates.红魔11Pro]
packages = [
"com.mobilelegends.mi",
"com.supercell.brawlstars",
]
manufacturer = "Nubia"
brand = "REDMAGIC"
model = "NX809J"
device = "REDMAGIC 11 PRO"
product = "NX809J"
fingerprint = "REDMAGIC/NX809J-UN/NX809J:16/BP2A.250605.031.A3/20251017.000000:user/release-keys"
build_id = "BP2A.250605.031.A3"
最常被用到的字段速查(完整字段表见 docs/CONFIG.md):
| 字段 | 含义 | 示例 |
|---|---|---|
manufacturer |
厂商 | Xiaomi、Samsung |
brand |
品牌 | Redmi、nubia |
model |
型号 | NX809J、SM-S9280 |
device / product / name |
设备代号/内部名 | popsicle |
fingerprint |
构建指纹 | 见上方示例 |
build_id |
Build ID | UKQ1.230917.001 |
android_version / sdk_int |
Android 版本与 SDK 级别 | "15" / 35 |
dpi |
屏幕密度伪装(120–640) | 420 |
⚠️ TOML 对引号、缩进敏感,一个缺失的引号会导致整份配置解析失败,所有应用都不再伪装。贡献前务必本地验证。
制作你的第一份机型模板:三种方式
方式一:WebUI 中创建并导出(最推荐新手)
- 打开 WebUI →「模板」页,新建模板并填写机型字段(图形化编辑,不易写错语法)
- 调好效果后,用模板页的导出功能把模板导出为文件,再按仓库要求整理提交
WebUI 完整的模板管理功能(创建、批量应用、导入导出、重命名)说明见 website/docs/guide/webui.md。
方式二:直接在配置文件中手写
编辑 /data/adb/device_faker/config/config.toml,按上面「字段速查」追加一个 [templates.你的模板名] 段落即可。配置是热加载的:改完只需重启目标应用验证,无需重启系统。
方式三:用 device_faker_cli 一键导出真机属性
模块自带命令行工具 device_faker_cli(位于 /data/adb/modules/device_faker/bin/device_faker_cli),其中 dump-device 子命令可读取当前设备的全部属性并导出为 TOML 模板底稿:
device_faker_cli dump-device -o my_template.toml
三个子命令(convert / convert-props / dump-device)定义见 device_faker_cli/src/main.rs。拿到导出的文件后,删掉与应用无关的字段、重命名为目标机型,就是一份高质量模板了。
提交模板贡献的步骤
- 注册并克隆仓库:在 device_faker_config 配置仓库创建账号,克隆仓库到你的电脑
- 放置模板文件:按仓库目录规范放入模板(TOML),文件内使用
[templates.模板名]段落 - 本地自测:把模板合并进自己的
config.toml,重启应用确认伪装效果与字段完整 - 提交 Pull Request:推送分支并发起 PR,附上机型名称与适用场景说明
- 合并后同步入库:模板合并后,所有用户即可在 WebUI 在线模板库中检索到
✅ 提交前检查清单
- [ ] 必填的机型身份字段(manufacturer / brand / model)已填写
- [ ]
fingerprint、build_id与目标机型真实固件一致(可用方式三导出对照) - [ ] TOML 语法检查通过(引号成对、缩进一致)
- [ ] 已在真机验证目标应用识别为伪装后的机型
- [ ] 模板命名清晰(如「红魔11Pro」而非「test1」)
在线模板库:一键导入社区模板
作为使用者,你可以在 WebUI「模板」页直接浏览在线模板库:
- 📂 按品牌、型号分类浏览,支持关键词搜索
- ⚡ 一键导入为本地模板,再批量应用到任意应用包名
- 🌐 内置多模板源自动切换,部分地区网络下也能稳定加载
社区支持渠道
遇到问题或想交流伪装方案,可以加入社区:
| 渠道 | 说明 |
|---|---|
| Telegram 社区群 | 官方 README 顶部的入群入口,实时答疑 |
| QQ 群 | 群号 854188252,中文交流友好 |
| 多语言文档 | 简体中文 / English / Türkçe,见 docs/README.md、docs/en/README.md、docs/tr/README.md |
贡献机型模板的入口说明见 docs/README.md 中的「模板配置贡献」一节。
常见问题
Q:贡献需要会写代码吗? 不需要。模板就是 TOML 配置文件,会复制粘贴加改几个字段就够了;方式三的导出工具能帮你完成 80% 的工作。
Q:我的模板被合并后,本地旧版会受影响吗?
不会。本地 config.toml 与配置仓库完全独立,仓库只做模板的分发源。
Q:在线模板库一直加载失败怎么办? 先检查设备网络;模板源地址与排查步骤见 website/docs/guide/faq.md。
Q:模板写错了会损坏系统吗?
不会。配置解析失败时模块会让该应用跳过伪装并自动卸载模块,其他应用不受影响;卸载前注意备份 /data/adb/device_faker 下的配置。
小结
贡献你的第一份机型模板其实只需四步:导出底稿 → 整理字段 → 本地自测 → 提交 PR。你的每一份机型模板都会通过 Device Faker 的在线模板库,帮助更多用户获得更真实的机型伪装效果 🎉。
