# docker-tvhelper

**Repository Path**: meimolihan/tvhelper

## Basic Information

- **Project Name**: docker-tvhelper
- **Description**: docker-tvhelper 连接电视 ADB
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: docker-compose

## README

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

![TVHelper Banner](https://file.meimolihan.eu.org/img/etvhelper-01.webp)

## 📋 目录导航
- [🐳 一、Docker 部署 TVHelper](#deploy)
  - [1. 创建部署目录和配置文件 📁](#deploy-setup)
  - [2. 拉取镜像并启动容器 🚀](#deploy-start)
- [🚀 二、使用 TVHelper](#usage)
  - [1. 访问容器界面 💻](#usage-access)
  - [2. 运行 TVHelper 主脚本 🛠️](#usage-script)
  - [3. SSH 访问 🔐](#usage-ssh)
- [🔧 三、容器维护命令](#maintenance)
  - [1. Docker Compose 命令 🐳](#docker-compose)
  - [2. Docker 容器命令 📦](#docker)
  - [3. Docker 镜像管理 📀](#docker-images)

<a id="deploy"></a>
## 🐳 一、Docker 部署 TVHelper

<a id="deploy-setup"></a>
### 1. 创建部署目录和配置文件 📁

```bash
mkdir -p /mnt/mydisk/home/tvhelper && cd $_ && \
cat > docker-compose.yml <<'EOF'
services:
  box: ## 服务名称（可自定义）
    container_name: tvhelper ## 容器名称（可自定义）
    image: wukongdaily/box:latest ## 镜像版本
    restart: unless-stopped ## 重启策略
    network_mode: bridge ## 桥接网络
    ports:
      - 2288:80
      - 2299:22
    environment:
      - PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/lib/android-sdk/platform-tools
    volumes:
      - ./data:/tvhelper/shells/data

## 容器内运行的是 Alpine Linux 系统。
## SSH 端口：2299
## SSH 用户名和密码分别是：root 和 password
## Shell 终端执行命令：./tv.sh
## APK 放在 /mnt/mydisk/home/tvhelper/data 目录
EOF
```

<a id="deploy-start"></a>
### 2. 拉取镜像并启动容器 🚀

```bash
cd /mnt/mydisk/home/tvhelper && docker-compose up -d
```

<a id="usage"></a>
## 🚀 二、使用 TVHelper

<a id="usage-access"></a>
### 1. 访问容器界面 💻

部署完成后，可以通过以下方式访问 TVHelper:

- **Web 界面访问**: `http://服务器IP:2288`
- **SSH 访问**: `ssh root@服务器IP -p 2299` (密码: `password`)

<a id="usage-script"></a>
### 2. 运行 TVHelper 主脚本 🛠️

```bash
# 进入容器内部
docker exec -it tvhelper sh

# 运行 TVHelper 主脚本
./tv.sh

# 使用 Ctrl + D 退出容器
```

<a id="usage-ssh"></a>
### 3. SSH 访问 🔐

```bash
# 使用 SSH 连接到容器
ssh root@服务器IP -p 2299

# 输入密码: password

# 连接成功后可以执行各种命令
./tv.sh
```

<a id="maintenance"></a>
## 🔧 三、容器维护命令

<a id="docker-compose"></a>
### 1. Docker Compose 命令 🐳

```bash
# 进入项目目录（请替换为您的实际目录）
cd /path/to/your/project

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

# 拉取最新镜像
docker-compose pull

# 启动容器
docker-compose up -d

# 仅启动指定服务（请替换 <service_name> 为实际服务名）
docker-compose up -d <service_name>

# 查看服务状态
docker-compose ps

# 查看服务日志
docker-compose logs

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

# 查看指定服务日志（请替换 <service_name> 为实际服务名）
docker-compose logs <service_name>

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

<a id="docker"></a>
### 2. Docker 容器命令 📦

```bash
# 查看所有容器名称
docker ps -a --format "{{.Names}}"

# 查看运行中容器
docker ps

# 停止/启动/重启容器（请替换 <container_name> 为实际容器名）
docker stop <container_name>      # 停止容器
docker start <container_name>     # 启动容器  
docker restart <container_name>   # 重启容器

# 删除容器
docker rm <container_name>        # 删除已停止容器
docker rm -f <container_name>     # 强制删除运行中容器

# 进入容器Shell
docker exec -it <container_name> sh      # 使用sh进入容器
docker exec -it <container_name> bash    # 使用bash进入容器

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

# 在容器中执行命令
docker exec <container_name> ls -la

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

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

<a id="docker-images"></a>
### 3. Docker 镜像管理 📀

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

---

## 💡 使用提示

- 🗂️ 你可以在本地 `./data` 目录中放置 APK 文件，它们会自动映射到容器内的 `/tvhelper/shells/data`。
- 🔐 SSH 默认账号：`root`，密码：`password`，端口：`2299`。
- ⚠️ 请确保宿主机端口 `2288` 和 `2299` 未被占用。

如果有任何问题或建议，欢迎在 [GitHub Issues](https://github.com/wukongdaily/tvhelper-docker) 中反馈！

🙌 快乐折腾，高效管理！