wukongdaily/boxadb

项目介绍

boxadb 是一个运行在浏览器里的 ADB 助手，面向电视盒子和 Android TV 设备。电脑上运行一个桥接程序把 ADB 能力暴露出来，网页端负责界面：连上同一局域网内的盒子后，可以在网页里安装 APK、打开终端、当遥控器用、截图以及重启设备。ADB 协议部分基于 ya-webadb，终端使用 xterm.js，APK/XAPK 解包使用 fflate，这些第三方组件均为 MIT 许可，详见第三方许可说明（source:5、source:7、source:8、source:9）。

快速开始

1. 从 Releases 页面 下载桥接程序并运行。桌面上双击「BoxADB 桥接」快捷方式，会弹出一个窗口运行桥接，保持窗口不要关闭。
2. 浏览器打开 boxadb 网页，填写盒子的局域网 IP（端口 5555 会自动补全），点击连接设备。
3. 连接成功后即可安装 APK、打开终端、控制电视、截图或重启设备。
4. 用完后关闭桥接窗口，端口会立即释放，不残留后台进程。

前提是盒子与电脑在同一局域网，并且盒子已开启 5555 端口的 ADB 调试；README 没有说明如何在盒子上开启，需先在盒子的开发者选项里确认。

使用约束

• 桥接程序支持 macOS、Windows、Linux，界面通过浏览器使用。
• 桥接程序以预编译程序形式发布在 Releases 中，README 未说明二进制与仓库源码的对应关系，也未提供校验值，运行前请自行确认下载来源。
• 电脑和盒子需要处于同一局域网，盒子需接受 5555 端口的 ADB 连接。
• 项目以 MIT 许可证开源（source:10）。

HotRepo 点评

该仓库在 2026-11-14 的 JavaScript 新项目榜有记录，UTC 17:16 起约一小时的统计窗口内新增 4 个 Star、1 个 Fork（source:1）。这只是一次短窗口快照，只能说明当天上榜，不足以判断趋势。对读者来说更实际的问题是桥接程序本身：网页界面只是使用的一半，运行前应在 Releases 页面确认下载的具体内容。