HUB
Sign inSign up
boxadb logo

wukongdaily/boxadb

By wukongdaily

•Updated 1 day ago

网页版 ADB 工具箱:把电视/盒子变成能用网页操作的设备

Image
Developer tools
0

722

wukongdaily/boxadb repository overview

⁠盒子助手 BoxADB · NAS / Docker 部署指南

⁠本项目为开源项目:https://github.com/wukongdaily/boxadb⁠

⁠网页预览:https://wukongdaily.github.io/boxadb/⁠

⁠功能简介

把电视盒子、Android TV、投影、机顶盒变成"能用网页操作的设备":装 APK/XAPK/APKM、看设备信息、传文件、跑 ADB 命令、当遥控器、截图、重启。

装在你的 NAS(或任何跑 Docker 的机器)上,手机、平板、电脑打开同一个网址就能用,不用每台设备都装东西。


⁠标签说明

  • latest —— 当前版本,含「无线调试配对」(需要 Node 运行时,约 62 MB)。
  • lite —— 2026-11-17 那次发布的存档快照(2.58 MB),不含无线配对功能:设备打开 USB 调试即可连。不过此版本作为存档备用,不再更新。如果你的电视或者盒子无需 无线配对就能连接adb,且不在乎后面更新新功能的话,可用此版本。

⁠一、一分钟跑起来

在 NAS 的终端里(群晖 / 威联通 / 飞牛 / 极空间 / unRAID 都可以):

docker run -d --name boxadb --restart unless-stopped \
  -p 8765:8765 -p 8766:8766 \
  -v boxadb-data:/data \
  -e BRIDGE_HOST=0.0.0.0 \
  -e BRIDGE_PORT=8765 \
  -e BRIDGE_HTTPS_PORT=8766 \
  -e BRIDGE_PRIVATE_ONLY=1 \
  -e BRIDGE_STATE_DIR=/data \
  -e BRIDGE_TLS_HOSTS=你的NAS地址 \
  wukongdaily/boxadb:latest

把 你的NAS地址 换成 NAS 在局域网里的 IP,例如 192.168.66.218(这一行是让加密证书认得这个地址,手机打开才不会多弹一次警告)。

然后浏览器打开:

https://你的NAS地址:8766/

第一次会提示"连接不是私密连接",点 高级 → 继续访问。只需点这一次,以后长期可用。

也可以用 http://你的NAS地址:8765/ 打开,它会自动把你送到上面那个加密地址。

⁠用 Docker Compose 的话
services:
  boxadb:
    image: wukongdaily/boxadb:latest
    container_name: boxadb
    restart: unless-stopped
    ports:
      - "8765:8765"
      - "8766:8766"
    volumes:
      - boxadb-data:/data
    environment:
      BRIDGE_HOST: 0.0.0.0
      BRIDGE_PORT: "8765"
      BRIDGE_HTTPS_PORT: "8766"
      BRIDGE_PRIVATE_ONLY: "1"
      BRIDGE_STATE_DIR: /data
      BRIDGE_TLS_HOSTS: 192.168.66.218   # 改成你的 NAS 地址
volumes:
  boxadb-data:

docker compose up -d 即可。


⁠二、盒子这边要先做的事

  1. 盒子接入和 NAS 同一个局域网(有线或 WiFi 都行)
  2. 设置里打开 开发者模式 → USB 调试(部分盒子叫「网络调试 / ADB 调试」)
  3. 第一次连接时,盒子上会弹 是否允许 USB 调试? → 勾选"一律允许" → 确定

之后在网页里填盒子的局域网 IP,点连接即可。


⁠三、能做什么

  • 装应用:拖入 .apk / .xapk / .apkm(多文件分包会自动处理)
  • 应用管理:查看、启动、卸载、清理数据
  • 文件传输:往盒子里传文件、从盒子里取文件
  • ADB 终端:直接敲命令(有补全)
  • 遥控器:方向键、返回、主页、音量
  • 截图 / 重启 / 关机
  • 设备信息:型号、系统版本、CPU、内存、已装应用列表

⁠四、常见问题

连不上 / 显示离线

  • 先确认盒子没休眠:休眠时 5555 端口会"假死",用遥控器唤醒盒子再连
  • 同一时刻只能有一台设备占着盒子的 ADB 通道。如果电脑上还开着 adb 命令行或别的助手,先在那边执行 adb kill-server 或断开
  • 盒子上重新弹的授权框要点"允许"

手机打开网址提示不安全

  • 这是自签证书的正常提示,点 高级 → 继续访问 就好,只需一次
  • 如果提示的是"地址不匹配",说明 BRIDGE_TLS_HOSTS 没填成你实际访问的那个地址,改一下再重启容器

能不能只开 http、不开 https?

  • 不建议。浏览器规定:只有加密页面才允许生成连接盒子所需的密钥,http://局域网IP 打开的页面连不上盒子

会不会被外人用?

  • 默认只允许连到局域网内的设备地址(BRIDGE_PRIVATE_ONLY=1),公网地址会被拒绝
  • 但请注意:这个服务本身没有登录密码。不要把 8765/8766 端口映射到公网,只在家庭局域网里用

怎么更新

docker pull wukongdaily/boxadb:latest
docker rm -f boxadb
# 然后重新执行上面的 docker run

GHCR 拉不动?

  • 同一份镜像也在 ghcr.io/wukongdaily/boxadb:latest,但国内网络经常连不上 GHCR。拉不到就用本仓库这份,内容完全一致(digest 相同)

⁠五、环境变量

变量默认说明
BRIDGE_HOST0.0.0.0监听地址,容器里保持默认
BRIDGE_PORT8765网页 + 连接通道(http)
BRIDGE_HTTPS_PORT8766加密访问端口;填 0 可关闭
BRIDGE_TLS_HOSTS空额外加进证书的地址,bridge 模式下请填你的 NAS 局域网 IP
BRIDGE_PRIVATE_ONLY1只允许连接局域网内的设备
BRIDGE_STATE_DIR/data证书存放位置,挂上卷后重启不换证书

⁠六、其他版本

有问题欢迎开 issue,或到 B 站「悟空的日常」留言。

⁠想支持作者开发

点击这里赞助我

https://wkdaily.cpolar.cn/01⁠

Tag summary

Content type

Image

Digest

sha256:4d3681860…

Size

62.3 MB

Last updated

1 day ago

docker pull wukongdaily/boxadb