搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

bkerler/mtkclient

安全

面向 MediaTek 设备的 Python 工具,可在 BROM 或 preloader 模式下利用 bootROM、读写闪存并修复手机。

1,535
313
Python
GPL-3.0
创建于 10 个月前

项目介绍

MTKClient 是一个用 Python 编写的 MediaTek 设备工具。它让设备进入 BROM 或 preloader 模式,通过攻击 bootROM 来读写闪存分区并做修复。README 把它直接定位成「做利用、读写闪存和各种折腾」的 mtk 工具。

它覆盖多代联发科芯片。MT6781、MT6789、MT6855、MT6886、MT6895、MT6983、MT8985 等较新芯片使用 V6 协议,bootROM 已被修补,BROM 模式走不通,必须改用 preloader 模式,并通过 --loader 指定 Loaders/V6 目录中的匹配 loader 芯片说明。部分设备的 preloader 被关闭,可用 adb reboot edl 重新打开。

快速使用

  1. 按平台安装依赖和 USB 驱动。Linux/macOS 与 Windows 有各自的安装说明:Linux/macOS 安装、Windows 安装,另外还有一个 自动化 Windows 安装器。
  2. Windows 上必须安装联发科原厂 USB 端口驱动和 usbdk 驱动;Linux 一般只在用旧版 kamakiri 时才需要打补丁的内核,读写闪存不需要。
  3. 运行 mtk 脚本,关机后按住音量上 + 电源或音量下 + 电源并连接手机,工具识别到设备后松开按键。
  4. 对上面列出的 V6 芯片,不按硬件键、以 preloader 模式连接,并提供 loader:README 说明必须使用 --loader 选项和 Loaders/V6 中的文件。
  5. 执行需要的操作,完整命令参考见 使用说明。

出错时加上 --debugmode 运行会生成 log.txt,求助时请附上日志和完整控制台输出 问题排查。

使用约束

  • 上面列出的 V6 芯片不能靠 BROM 利用,必须使用 preloader 模式并配好 loader。
  • Windows 需要联发科原厂端口驱动加 usbdk,工具才能识别设备。
  • Linux 上旧版 kamakiri 需要打补丁的内核,读写闪存不需要。
  • 项目以 GPL-3.0 发布,属于底层设备操作工具,应把它当作修复和利用工具来使用,而不是面向普通用户的刷机软件。
  • USB VID/PID 自动识别配置在 config/usb_ids.py,芯片配置在 config/brom_config.py 芯片配置。

其他资源

项目还提供基于 Ubuntu 22.04 的 Live DVD,账号密码均为 user Live DVD,以及一份单独的 学习资料。

HotRepo 点评

MTKClient 是一个边界很窄的硬件利用与修复工具,并非通用刷机套件;README 也点明 V6 芯片会改变整个进入方式。该仓库在 2026-11-16 的 HotRepo Python 日榜上有记录,名次为第 14,当日新增 9 个 Star,全部语言日榜的最好名次尚无记录。这条单次快照只能说明它在 Python 榜上最近有一次不算高的露脸,现有同口径历史不足以判断趋势。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。