/tvhelper-docker

让你使用电脑、NAS等一切能运行docker的设备变成盒子的ADB安装助手

Primary LanguageShellGNU General Public License v3.0GPL-3.0

盒子助手Docker版

docker pulls Bilibili YouTube

🤔 这是什么?

该项目可以让你使用电脑、NAS等一切能运行docker的设备变成盒子的ADB安装助手。让你的盒子用起来更加得心应手。
另外【OpenWrt版本盒子助手命令行】可以点击这里直达

💡 特色功能

  • 💻 支持一键修改安卓原生电视盒子/TV的NTP服务器地址
  • 💻 支持SSH连接 且容器内ADB服务均已准备就绪,无需额外安装
  • 🔑 支持安装装机必备app 尤其是文件管理器和三方市场、图标等
  • 🌏 支持一键批量安装主机上指定目录的全部apk
  • 🐋 支持Docker compose和 docker cli一键部署
  • 📕 支持为国行Sony电视安装时下流行的流媒体应用
  • ❓ 兼容`ARMv7/ARM64/x86_64 双平台设备
  • ❓ 其他功能和特点会持续迭代
  • MacOS(Apple芯片/Intel芯片)✅
  • Windows 10/11 ✅
  • Linux发行版 ✅
  • NAS系统(群晖、威联通等)✅
  • 软路由iStoreOS/OpenWrt ✅

🚀 快速上手

1. 安装DockerDocker compose

2. 下载image

docker pull wukongdaily/box:latest

国内使用⬇️ 可用该项目构建离线包

https://github.com/wukongdaily/DockerTarBuilder

3. 容器系统默认账号密码或环境变量

  • 容器内运行的就是alpine linux系统。
  • ssh用户名和密码分别是:rootpassword
  • 推荐ssh端口映射到主机端口为2299。
  • 注意!映射ssh端口这一步并非是必须的,如果你需要用ssh连接容器则自行设置。
  • 根据自己的需求来映射,2299也不是固定的,映射的端口号多少都可以,只要跟主机不冲突即可。

调用形式举例

ssh root@宿主机ip地址 -p 2299

SSH常见错误举例和新手指南详见

https://github.com/wukongdaily/HowToUseSSH

  • 容器内的环境变量
  • PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools

4. 运行

Windows

  • win电脑使用-CMD写法,注意不是powershell 且注意💡续行符^后不能有空格。数据目录默认映射到 【我的文档】
docker run -d ^
--restart unless-stopped ^
--name tvhelper ^
-p 2299:22 ^
-p 2288:80 ^
-v "%USERPROFILE%\Documents\tvhelper_data:/tvhelper/shells/data" ^
-e PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools ^
wukongdaily/box:latest

Linux

  • Linux(iStoreOS/OpenWrt路由器) 使用下列命令,数据目录默认映射到linux的/tmp/upload/
docker run -d \
  --restart unless-stopped \
  --name tvhelper \
  -p 2299:22 \
  -p 2288:80 \
  -v "/tmp/upload:/tvhelper/shells/data" \
  -e PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools \
  wukongdaily/box:latest
 -v "/tmp/upload:/tvhelper/shells/data" \
# 这目录是用来存放apk的,对应脚本里的批量安装apk的功能。如果你要使用该功能,你就关注一下映射的目录。
# 若不需要修改,则默认用/tmp/upload 目录来存放apk,你可以将需要安装的apk复制到该目录下即可。

menu

yuansheng

sony

macOS

  • 苹果电脑写法,数据目录默认映射到mac电脑文稿目录下
docker run -d \
  --restart unless-stopped \
  --name tvhelper \
  -p 2299:22 \
  -p 2288:80 \
  -v "$HOME/Documents/tvhelper_data:/tvhelper/shells/data" \
  -e PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools \
  wukongdaily/box:latest

UNRAID

  • unraid写法,注意容器内的data目录默认映射到 /mnt/user/appdata/,你可以适当修改成别的空间的路径。
docker run -d \
  --name='tvhelper' \
  --net='bridge' \
  -e HOST_OS="Unraid" \
  -e HOST_HOSTNAME="unraid" \
  -e HOST_CONTAINERNAME="tvhelper" \
  -e 'PATH'='/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools' \
  -l net.unraid.docker.managed=dockerman \
  -p '2299:22/tcp' \
  -p '2288:80/tcp' \
  -v '/mnt/user/appdata/':'/tvhelper/shells/data':'rw' 'wukongdaily/box'
  • UNRAID 方法2 ,利用模版,打开UNRAID 命令行 粘贴
wget -O /boot/config/plugins/dockerMan/templates-user/wukongdaily-box-template.xml  https://gitee.com/wukongdaily/tvhelper-docker/raw/master/dockerinfo/unraid-template.xml

下载成功之后,新建容器,选择模版————wukongdaily-box-template 即可.如图
123

CasaOS docker compose

version: '3.8'  # 使用docker-compose文件版本3.8

services:
  tvhelper:
    build: .  # 构建Dockerfile所在的当前目录
    image: wukongdaily/box:latest  # 指定构建完成后的镜像名称和标签
    ports:
      - "2299:22"  # 将容器的22端口映射到宿主机的2299端口,以便通过SSH访问
      - "2288:80"  # 将容器的80端口映射到宿主机的2288端口,以便通过浏览器webUI
    volumes:
      - /tmp/upload/tvhelper_data:/tvhelper/shells/data  # 根据需要映射数据卷,此处假设您希望持久化的数据位于./data目录
    restart: unless-stopped  # 除非明确要求停止,否则总是重启容器
    environment:
      - PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools

5. 如何导入本地镜像tar

如何获得最新版离线包

https://github.com/wukongdaily/DockerTarBuilder

Windows 举例

docker load < "%USERPROFILE%\Documents\tvhelper-amd64.tar"

Linux/OpenWrt 举例

docker load < /mnt/sata1.3-1/myboxarm.tar

辅助视频教程⬇️

在线教学视频 长视频

🗂️ 鸣谢

本项目的开发参照了以下项目,感谢这些开源项目的作者:

my-tv

https://github.com/yaoxieyoulei/mytv-android

BBLL

https://github.com/xiaye13579/BBLL

TVBox

https://github.com/takagen99/Box

Sun-Panel

https://github.com/hslr-s/sun-panel

web页截图

盒子助手v1 0 8 2024-11-19 14-03-45