wukongdaily/box repository overview
盒子助手Docker版 V1.1.5
🤔 这是什么？
该项目可以让你使用电脑、NAS等一切能运行docker的设备变成盒子的ADB安装助手。让你的盒子用起来更加得心应手。
💡 特色功能
- 💻 支持
一键修改安卓原生电视盒子/TV的NTP服务器地址 - 💻 支持
一键安装/data目录下所有apk/xapk/apkm (适合流媒体app) - 💻 支持
SSH连接 且容器内ADB服务均已准备就绪,无需额外安装 - 🔑 支持
安装装机必备app 尤其是文件管理器和三方市场、图标等 - 🐋 支持
Docker compose和 docker cli一键部署 - 📕 支持
为国行Sony电视安装时下流行的流媒体应用 - ❓ 兼容`ARMv7/ARM64/x86_64 双平台设备
- ❓ 其他功能和特点会持续迭代
- MacOS(Apple芯片/Intel芯片)✅
- Windows 10/11 ✅
- Linux发行版 ✅
- NAS系统（群晖、威联通等）✅
- 软路由iStoreOS/OpenWrt/ImmortalWrt/eSir_OpenWrt等一切能用docker的op系统 ✅
🚀 快速上手
飞牛应用安装包fpk （arm64/x86-64双平台）
https://github.com/wukongdaily/tvhelper-docker/releases/tag/fpk
1. 安装Docker和Docker compose
Docker安装教程：https://docs.docker.com/engine/install/Docker compose安装教程：https://docs.docker.com/compose/install/个人普通电脑安装教程：https://docs.docker.com/get-docker/- docker 根目录剩余空间 至少大于1GB
2. 下载image
docker pull wukongdaily/box:latest
3. 容器系统默认账号密码或环境变量
- 容器内运行的就是Ubuntu系统。
- ssh用户名和密码分别是：
root和password - 推荐ssh端口映射到主机端口为2299。
- 推荐把/data映射到宿主机某个目录 方便上传apk或xapk、apkm
- 注意！映射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电脑使用-CMD写法,注意不是powershell 且注意💡续行符^后不能有空格。数据目录默认映射到 【我的文档】
docker run -d ^
--restart unless-stopped ^
--name tvhelper ^
-p 2299:2299 ^
-p 2280:2280 ^
-p 15000:15000 ^
-v "%USERPROFILE%\Documents\tvhelper_data:/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的
/tmp/upload/下
docker run -d \
--restart unless-stopped \
--name tvhelper \
-p 2299:2299 \
-p 2280:2280 \
-p 15000:15000 \
-v "/tmp/upload/tvhelper_data:/data" \
-e PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools \
wukongdaily/box:latest
- macOS苹果电脑写法,数据目录默认映射到mac电脑文稿目录下
docker run -d \
--restart unless-stopped \
--name tvhelper \
-p 2299:2299 \
-p 2280:2280 \
-p 15000:15000 \
-v "$HOME/Documents/tvhelper_data:/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 写法,注意容器内的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:2299/tcp' \
-p '2280:2280/tcp' \
-p '15000:15000/tcp' \
-v '/mnt/user/appdata/':'/tvhelper/shells/data':'rw' 'wukongdaily/box'
docker compose (绿联、群晖、威联通、极空间、飞牛NAS等)
version: '3.8' # 使用docker-compose文件版本3.8
services:
tvhelper:
build: . # 构建Dockerfile所在的当前目录
image: wukongdaily/box:latest # 指定构建完成后的镜像名称和标签
container_name: box
ports:
- "2299:2299" # 用于连接容器ssh的端口 一般无需更改 ssh默认账密为root/password
- "2280:2280" # 用于重定向到盒子助手资讯页 一般无需更改
- "15000:15000" # 一般无需更改、将容器的15000端口映射到宿主机的15000端口，以便通过浏览器上传安装包
volumes:
- /volume2/public:/data # 冒号前的路径 换成你NAS里的路径比如/volume2/public 用于存放apk等资源
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
- 若需离线包 可在工作流里自行构建 fork该项目后 在action中构建即可 几秒后就构建成功 在release中下载离线包 https://github.com/wukongdaily/DockerTarBuilder/
- docker离线包的格式是tar.gz 通常无需解压 docker load的过程就会解压了。
Windows 举例
docker load < "%USERPROFILE%\Documents\tvhelper-amd64.tar.gz"
Linux/OpenWrt 举例
docker load < /mnt/sata1.3-1/tvhelper.tar.gz
辅助视频教程⬇️
🗂️ 引用项目
本项目的开发参照了以下项目，感谢这些开源项目的作者：
DUFS
https://github.com/sigoden/dufs
TVBox
https://github.com/takagen99/Box
Sun-Panel
https://github.com/hslr-s/sun-panel
用真金白银鼓励作者
Tag summary
Content type
Image
Digest
sha256:cf8384151…
Size
171.9 MB
Last updated
6 months ago
docker pull wukongdaily/box