Modules / device_faker

Device Faker

使用Zygisk实现自定义配置对应用伪装机型

README

简体中文 | English

Device Faker 📱

logo

一个基于 Zygisk 的机型伪装模块,可以为不同的应用配置不同的设备型号。

Version GitHub Downloads Language Telegram QQ群

特性 ✨

  • 🎯 精确控制: 为每个应用单独配置设备信息
  • 📁 模板管理: 多机型模板,便捷应用到多包名
  • 🔄 实时生效: 修改配置后仅需重启应用,无需重启系统
  • 🛡️ 安全可靠: 基于 Zygisk 框架,模块化设计
  • 📝 简单配置: 使用 TOML 格式配置文件,易于编辑
  • 性能优化: 仅对配置的应用生效,不影响其他应用
  • 🎭 三项模式: lite 模式(轻量隐蔽)/ full 模式(完整伪装)/ resetprop 模式(支持只读属性修改)
  • 🌐 WebUI管理: 提供图形化界面,方便配置管理

WebUI 功能 🖥️

Device Faker 提供了现代化的 Web 管理界面,可以通过WebUI-X API访问:

  • 📊 状态监控: 实时查看模块运行状态
  • 📋 模板管理: 创建、编辑和删除机型模板,批量应用到多个包名
  • 📱 应用管理: 直观查看已安装应用及其配置状态
  • 🖋️ 配置编辑: 图形化界面编辑应用配置,支持模板应用和自定义配置

配置说明 ⚙️

详细的配置说明请参考 配置文档

配置文件位于 /data/adb/device_faker/config/config.toml,使用 TOML 格式。修改配置后仅需重启对应应用即可生效,无需重启系统。

致谢 🙏

本项目在开发过程中参考了以下优秀项目:

感谢这些项目的开发者!💖


📱 让设备不为应用的机型限制所困! 🚀

💝 如果这个模块对你有帮助,可以给个 Star 支持一下

Release History

v1.2.0

Published on December 17, 2025
Download

📝更新日志

⬆️[v1.1.0 → v1.2.0] - 2025-12-17

🆕 新功能

  • 🌐 WebUI添加在线模板库功能
  • 🛠️ 添加CLI工具用于配置转换和在线模板加载
  • 🔧 添加resetprop模式支持及characteristics属性
  • 🌍 WebUI新增多语言支持
  • 📋 添加FORCE_DENYLIST_UNMOUNT支持
  • 👥 添加对多用户环境的配置支持

⚡ 改进

  • 💾 安装脚本更改备份文件后缀为.bak以便于恢复
  • 📱 WebUI适配KernelSU API 2.1.1以支持KernelSU 2.1.2及以上版本应用名称和图标显示
  • 🎨 适配KernelSU WebUI沉浸标准
  • 🌐 WebUI使用fetch API替代curl命令进行网络请求,提升兼容性
  • 🏗️ 模块化架构重构Zygisk模块核心
  • 🎨 优化WebUI显示和布局
  • 🏗️ 重构WebUI模板页面为组件化结构
  • 🔄 将C++ atexit实现迁移为Rust实现
  • 📋 WebUI添加配置元数据支持

v1.1.0

Published on November 30, 2025
Download

📝更新日志

⬆️[v1.1.0] - 2025-11-09

🆕 新功能

  • 🌐 新增WebUI界面,提供更友好的配置管理体验
  • ⚙️ 安装脚本添加配置选择功能,支持个性化安装选项

⚡ 改进

  • 🗺️ 优化配置字段属性映射逻辑,提升配置处理效率
  • 📦 迁移到新的zygisk-api-rs库并更新依赖,兼容更多Zygisk实现
  • 🔧 更新Rust edition至2024版本,利用最新语言特性
  • 📚 优化配置文档结构,提升可读性和易用性

IMG_20251109_200816
IMG_20251109_200752

Module Details

Module ID
device_faker
Authors
153
Stars
2
Releases

Latest Version

v1.2.0
Released 12/17/2025
Download Now