N3urda/hongguoTV v0.1.0

hongguoTV v0.1.0 — Android TV + Docker

on GitHub

首个可安装版本：React Native TV 客户端连接独立内容服务，面向自家 Android 8.0 及以上电视。支持推荐、搜索、详情选集、遥控器操作、收藏、断点续播和自动下一集。

下载

• hongguotv-0.1.0-android8.apk：约 26 MiB，包含 ARM32 / ARM64 和 JS，无需 Metro；使用开发签名供个人侧载安装。
• hongguotv-0.1.0-source.zip：与版本标签一致的完整源码、锁文件和文档。
• hongguotv-0.1.0-docker.zip：独立内容服务、Dockerfile、Compose、示例环境变量与部署指南。
• hongguotv-0.1.0-evidence.zip：接口、媒体、APK、模拟器及容器验证记录。
• SHA256SUMS：以上四个文件的校验值。

Docker 快速部署

解压 Docker 部署包，在解压后的根目录执行：

cp .env.example .env
docker compose --env-file .env -f server/compose.yaml up -d --build

电视安装 APK，在「设置」填入 http://宿主机局域网IP:8787。服务设备需要保持在线；如在 .env 中设置了 BRIDGE_TOKEN，电视同步填写相同口令。

预构建镜像为 ghcr.io/n3urda/hongguotv-bridge:0.1.0，支持 linux/amd64 和 linux/arm64。私有镜像需要先登录 GHCR，再使用根目录 compose.yaml 拉取部署；源码构建方式不需要 GHCR 登录。

完整 Docker 指南 · 首版交付说明

验证与范围

• 类型检查和 9 项自动化测试通过；17 项真实内容与媒体探测通过。
• Android TV API 36 模拟器验证真实播放、遥控器、收藏持久化、续播和自动下一集。
• AMD64 / ARM64 镜像构建及容器启动、健康检查、端口映射、口令验证通过；ARM64 容器采用 QEMU 验证。
• 版本构建及镜像发布记录。

实际 Android 8.0 电视和用户 NAS 尚未连接验收；硬件解码、声音、长时间连播及家庭网络表现仍需实机确认。Apple TV 仅有工程骨架，其他平台尚未交付。内容服务依赖非官方接口，实现和 GPL-3.0 来源说明随源码提供。

镜像索引摘要：sha256:4e18a419f815e3e1c1ea1776107b2ae63b3b265f28b569d1a6e2cb030772bf9d。