贡献你的第一份机型模板:Device Faker 机型伪装配置仓库与社区支持完整指南

原创2026-10-25 17:43:421,414 阅读

贡献你的第一份机型模板:Device Faker 机型伪装配置仓库与社区支持完整指南

Device Faker 是一个基于 Zygisk 的机型伪装模块,可以为不同的应用单独配置设备型号与系统属性。本文面向新手,手把手介绍 Device Faker 的机型模板配置仓库(device_faker_config):模板长什么样、如何用三种方式制作机型模板、如何提交你的第一份贡献,以及 WebUI 在线模板库与社区支持的完整用法,零基础也能 10 分钟上手。

Device Faker Zygisk 机型伪装模块与机型模板配置仓库示意图

📌 阅读时长约 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 中创建并导出(最推荐新手)

  1. 打开 WebUI →「模板」页,新建模板并填写机型字段(图形化编辑,不易写错语法)
  2. 调好效果后,用模板页的导出功能把模板导出为文件,再按仓库要求整理提交

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。拿到导出的文件后,删掉与应用无关的字段、重命名为目标机型,就是一份高质量模板了。

提交模板贡献的步骤

  1. 注册并克隆仓库:在 device_faker_config 配置仓库创建账号,克隆仓库到你的电脑
  2. 放置模板文件:按仓库目录规范放入模板(TOML),文件内使用 [templates.模板名] 段落
  3. 本地自测:把模板合并进自己的 config.toml,重启应用确认伪装效果与字段完整
  4. 提交 Pull Request:推送分支并发起 PR,附上机型名称与适用场景说明
  5. 合并后同步入库:模板合并后,所有用户即可在 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 的在线模板库,帮助更多用户获得更真实的机型伪装效果 🎉。

登录后查看全文
device_faker