Docker 部署 TVHelper — 悟空盒子助手 📦

TVHelper Banner

📋 目录导航

🎯 项目简介

TVHelper（悟空盒子助手）是一款专为安卓电视盒子设计的 Docker 化 ADB（Android Debug Bridge）管理工具。它可以让您使用电脑、NAS 等能运行 Docker 的设备来轻松管理电视盒子，提供一键应用安装、NTP 服务器修改、设备调试等功能。结合 Docker 部署，您可以在任何支持 Docker 的平台（Linux、Windows、macOS、NAS 等）上快速部署和运行 TVHelper，实现对电视盒子的便捷管理。

🛠️ 核心特性

特性类别 功能描述 优势
📦 应用管理 支持一键批量安装主机上指定目录的全部 APK 简化应用部署过程，提高效率
⏰ 时间同步 一键修改安卓原生电视盒子/TV 的 NTP 服务器地址 确保设备时间准确，提升系统稳定性
🔧 设备调试 提供完整的 ADB 调试功能 方便设备故障排查和系统优化
🐳 容器化部署 支持 Docker Compose 和 Docker CLI 一键部署 部署简单，环境一致，易于维护
📺 流媒体支持 为国行 Sony 电视安装流行的流媒体应用 扩展电视功能，丰富娱乐体验
🏗️ 多架构兼容 兼容 ARMv7/ARM64/x86_64 等多种硬件平台 适用范围广，灵活性强
🔐 远程访问 支持 SSH 远程管理容器 方便进行高级调试和软件更新

🐳 一、Docker 部署 TVHelper

1. 创建部署目录和 docker-compose.yml 文件 📁

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
mkdir -p /mnt/mydisk/home/tvhelper && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  tvhelper:
    container_name: tvhelper
    image: wukongdaily/box:latest
    restart: always
    ports:
      - "2288:80"  # Web 界面访问端口
      - "2299:22"  # SSH 访问端口
    volumes:
      - ./data:/tvhelper/shells/data  # APK 文件存储目录
    environment:
      - TZ=Asia/Shanghai  # 设置时区
EOF

💡 提示：你可以使用 Docker 镜像加速源来拉取镜像：

1
docker pull dockerproxy.com/wukongdaily/box:latest

2. 拉取镜像并启动容器 🚀

1
docker-compose up -d

🚀 二、使用 TVHelper

1. 访问 Web 界面 💻

2. 首次使用步骤 🎯

  1. 准备 APK 文件：将需要安装的 APK 文件放在主机的 ./data 目录下，它们会自动映射到容器内的 /tvhelper/shells/data 目录。
  2. 访问 Web 界面：打开浏览器访问上述地址。
  3. SSH 访问（可选）：如需使用 SSH 管理容器：
    1
    ssh root@服务器IP -p 2299
    SSH 默认用户名：root，密码：password。
  4. 运行主脚本：在容器 Shell 或 SSH 中执行主脚本：
    1
    ./tv.sh
  5. 管理设备：按照脚本提示操作，如修改盒子的 NTP 服务器地址、批量安装 APK 等。

🔧 三、容器维护命令

1. Docker Compose 命令 🐳

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 进入项目目录
cd /mnt/mydisk/home/tvhelper

# 停止并删除容器
docker-compose down

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

# 跟踪服务日志
docker-compose logs -f

# 完整升级流程
docker-compose down && \
docker-compose pull && \
docker-compose up -d && \
docker image prune -f

2. Docker 容器命令 📦

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器
docker stop tvhelper      # 停止容器
docker start tvhelper     # 启动容器  
docker restart tvhelper   # 重启容器

# 进入容器Shell
docker exec -it tvhelper sh

# 以root身份进入容器  
docker exec -u 0 -it tvhelper sh

# 查看容器详情和资源使用
docker inspect tvhelper     # 查看详细配置
docker stats tvhelper       # 实时资源监控

## 容器日志管理
docker logs tvhelper           # 查看日志
docker logs -f tvhelper        # 实时跟踪日志
docker logs --tail 100 tvhelper  # 查看最后100行
docker logs -t tvhelper        # 带时间戳的日志

3. Docker 镜像管理 📀

1
2
3
4
docker images                  # 列出所有镜像
docker rmi <image_name:tag>    # 删除指定镜像（请替换为实际镜像名和标签）
docker image prune -f          # 清理悬空镜像
docker image prune -a -f       # 清理所有未使用镜像

📦 启航管理，掌控无限

通过本文档，你已经成功使用 Docker 部署了 TVHelper（悟空盒子助手），掌握了通过 ADB 轻松管理电视盒子的核心技能。现在，你可以：

📺 便捷管理 一键批量安装、更新电视盒子应用，告别繁琐的手动操作
⏰ 时间同步 轻松修改 NTP 服务器地址，确保设备时间准确，提升系统稳定性
🔧 高效调试 通过完整的 ADB 功能快速排查设备问题，优化电视盒子性能
🌐 远程控制 随时随地通过 Web 界面或 SSH 管理你的电视设备，打破空间限制

TVHelper 不仅是工具，更是连接你与智能电视设备的便捷桥梁。愿这个助手让你对电视盒子的管理变得更加简单、高效，充分释放设备的潜在能力。

从现在开始，轻松管理你的电视盒子，享受更智能的大屏体验！🖥️

📌 持续迭代：建议关注 TVHelper 官方更新，及时获取新功能与优化。
🐛 反馈与互助：使用中如有疑问或建议，可前往 GitHub Issues 提出。

祝你使用愉快，管理自如！🎉