夜雨聆风学习资料网

ARTICLE · 1392376

搞机工具箱:浏览器里连上手机,装 App、改 DPI、跑 Shell

搞机工具箱:浏览器里连上手机,装 App、改 DPI、跑 Shell

每日开源 · 2026-11-21

搞机工具箱是一个网页版安卓玩机工具,在浏览器里通过 USB 直接操作手机

装一个 ADB 客户端要下几十兆的安装包,装完还可能和你之前装的平台工具打架——版本对不上,端口被占,设备列表一直是空的。搞机工具箱 Web 想省掉这一整段。

它是一个网页版 Android 玩机工具,在 Chromium 内核的浏览器里通过 WebUSB 接管手机,无需安装客户端。2,057 星,2026-11-03 建库,18 天,GPL-3.0,整套东西是纯前端 HTML/CSS/JavaScript。它值得看的原因是「门槛低到几乎没有」——打开网页、插线、授权,三步之后你面对的就是一份图形化的设备面板。

它在网页里能做什么

作者把功能分成了十二个页面,覆盖面比想象中宽:

页面 主要能力
主页 设备与系统信息、CPU 频率、隐藏主板 ID、重启 / 关机 / 重启到 Bootloader、Fastbootd、Recovery、EDL
软件管理 读包名与前台活动、启用禁用、强行停止、卸载(可保留数据)、清数据、恢复系统软件、批量管 Google 套件
安装与传输 装 APK、装拆分 APK、推文件、提取已安装的包
显示控制 改分辨率、改 DPI、按键模拟、截图
系统界面 隐藏状态栏图标、改时钟与快捷设置、沉浸模式
电池管理 电池信息、参数模拟与恢复、定时统计、CSV 导出
无极调节 字体倍数、窗口与过渡动画倍率、自动锁屏时间
控机脚本 脚本编辑导入、命令插入、解释执行部分 BAT 语法
ADB 终端 真 Shell 会话、ANSI 显示、命令历史、补全、Ctrl+C 中断

终端那条是最有意思的:它接的不是模拟层,是手机上真正的 Android Shell。getprop ro.product.model、wm size、settings get system font_scale 这些命令直接可用,且同一次连接里会话保持当前目录和环境变量,切页面不会重建。

脚本那条更容易被误解。控机脚本解释的是 BAT 语法的一个子集(echo、rem、set、set /a、goto、部分 if、for /l、timeout、choice、pause、exit /b),把里面的 adb 操作翻译成浏览器端调用——它不会启动 Windows 的 cmd.exe,也不会执行你电脑上的 exe。这既是安全设计,也是能力边界:依赖 PowerShell、for /f、外部程序的脚本跑不了。

上手要满足四个条件

缺一个就卡住,而且卡住的现象各不相同:

  1. 用支持 WebUSB 的 Chrome 或 Edge(或任何 Chromium 内核浏览器)。系统不限,手机上装 Chrome 也能用。
  2. 手机开开发者选项和 USB 调试,用支持数据传输的线连电脑。
  3. 通过 localhost / 127.0.0.1 或 HTTPS 网站访问页面。本机回环属于浏览器认可的可信上下文,所以本地用 HTTP 没问题。
  4. Windows 能正常识别这台手机的 ADB 接口,且手机上点了授权。

第四条是失败率最高的一条,通常不是浏览器的问题,是驱动。

两种跑法,别选错

整合版最省事:下载 docs/index.html,依赖已内嵌,双击用 Chrome 打开就能用。

分离版要起个服务器:下完整项目、保留目录结构、装 Node.js,在 server.cjs 所在目录执行 node server.cjs,然后开 http://127.0.0.1:8124。默认端口被占就改环境变量 $env:PORT = "8080" 再起。

这里有个必须说的坑:分离版不能直接双击 index.html。file:// 地址下,外部 ES 模块会被浏览器的跨源限制挡住,结果就是连接按钮一直是灰的。很多人第一步就死在这,以为是浏览器不支持。

想挂到公网也简单:整套文件传到一个支持 HTTPS 的静态托管,以 index.html 为入口,第三方依赖在 js/vendor/ 里,不从 CDN 拉,也不需要部署任何 ADB 后端。三个注意点——保留 index.html / css / js / assets 的相对路径;对外必须 HTTPS(localhost 除外);JavaScript 要返回 text/javascript 而不是 application/octet-stream,否则模块加载失败。

连不上时按这张表查

作者列了九条,按「最常见」到「最冷门」排:

现象 先查什么
连接按钮是灰的 换 Chrome/Edge、走本地服务器或 HTTPS、看控制台的模块加载错误与 MIME 报错
提示 ADB 接口被占用 任务管理器结束占用的 adb.exe,关掉其他 ADB 工具和已连设备的 WebADB 页面
浏览器找不到设备 检查 USB 调试、数据线(有些线只供电)、USB 接口、Windows 下的 ADB 驱动
手机没有授权弹框 解锁手机;已有有效授权时不再弹,可先撤销授权再试
资源被拦成 mixed-content HTTPS 页面引了 HTTP 资源,把相关资源改 HTTPS
命令返回权限不足 系统策略与厂商 ROM 会限制 ADB Shell,部分设备还要开厂商自己的 USB 调试安全项
CPU 频率 / 功率读不到 有些设备不开放对应系统节点
关页面就断连 USB 会话依附当前页面,重连即可,数据要提前下载

「功率记录不等同于外接功率计」这句作者特意标了,避免有人拿它去测充电器。

数据存在哪,换地址会怎样

这个容易被忽略,但会影响你迁移部署:

  • 设置、脚本文本、软件操作记录存在当前网站的浏览器本地存储里,清网站数据就没了,所以要导出备份。
  • ADB 身份密钥由 Tango 存在 IndexedDB,断开设备后能在设置里清除。
  • 协议、域名或端口任一变化,都是一个独立的存储空间。你把工具从 127.0.0.1:8124 换到自己的域名,之前的授权和设置不会跟过去。
  • 截图和电池统计是临时数据,不跨刷新保留,要及时下载。

边界在哪

只支持 USB 有线。 无线 ADB 没有做。

没有 Fastboot 刷机。 那个「进入 Fastboot」的按钮只发一条重启命令,进去之后的事它不管。

功能生效与否取决于设备。 Android 版本、厂商 ROM、ADB Shell 权限三者共同决定——同一页面上有的按钮在这台机器能用,在另一台就是灰的或报错。作者在开头就写了「本工具为全安卓通用软件,使用需有一定玩机知识,盲目操作导致无法开机或数据丢失后果自负」。

GPL-3.0。 自己用、改都行,分发修改版要按 GPL 开放源码。第三方组件(Tango / xterm.js)是 MIT,分发时保留声明。

适合谁

手边只有一台电脑、偶尔要装个 APK、改个 DPI、看个电池信息的人,这是目前最轻的方案——不用装平台工具,不用记 adb 命令。

经常刷机、要进 Fastboot 线刷、要跑复杂脚本的,还是备一套完整的 platform-tools 加专用工具。这个项目明确不覆盖那部分,硬用它只会更麻烦。

项目地址:https://github.com/CzJam/gjgjxweb

开源协议:GPL-3.0

数据截至 2026-11-21:2,057 stars / 180 forks / HTML / 无 release


创作来源声明

本文由 AI 生成:选题、初稿、排版与封面均出自自动化流程。文中的项目信息、star 数、协议与版本取自 GitHub API 和项目官方仓库、官方文档,数据截至文末标注日期;官方口径的性能与效果描述已在正文中单独标注来源。文中不含作者实测数据,也未进行实际部署验证。

如有事实错误或版本过期,欢迎留言指出,我会核实后更正。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料