TVBoxOSC 容器化部署：电视盒子管理一条命令跑起来

TVBoxOSC 容器化部署：电视盒子管理一条命令跑起来

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC

在电视盒子上折腾过部署的人都知道，同一套程序在这台盒子跑得好好的，换一台就开始报 Java 版本不对、端口被占用，环境依赖排查一下能占掉一整个下午。用 Docker 部署 TVBoxOSC，思路是把运行环境整个装进容器：机器只要能跑 Docker，剩下的就是一条命令的事。

它到底是什么

TVBoxOSC 是一个电视盒子控制管理项目，代码库基于上游第三方项目（来源见 README.md 的 Credits 部分），并通过 CI 定时自动构建发版，构建逻辑在 .github/workflows/。和在一台台盒子上手动装相比，容器化部署把程序和环境解耦了：同一份镜像放到不同盒子，行为基本一致。适合需要把多台电视盒子纳入统一运行环境的场景。

📋 动手之前：把环境检查一遍

• Docker 已安装且守护进程在跑，docker version不报错
• Docker Compose（用来按依赖关系一次性拉起并管理多个容器的工具）可用，docker compose version有输出
• 宿主机 8080 端口没有被别的服务占用
• 机器能访问 gitcode 代码托管

🐳 跑起来

把代码拉到本地

git clone https://gitcode.com/GitHub_Trending/tv/TVBoxOSC cd TVBoxOSC

写好 Dockerfile 和编排文件

在项目根目录新建Dockerfile和docker-compose.yml。注意这两个文件不属于仓库本身，只是部署用的配套文件，仓库现有内容一个字节都不用动。

Dockerfile（构建镜像的指令文件）：

# 基础镜像：8 版 Java 运行环境 FROM openjdk:8-jre-alpine WORKDIR /app COPY . . EXPOSE 8080 CMD ["java", "-jar", "tvboxosc.jar"]

docker-compose.yml：

version: '3' services: tvboxosc: build: . ports: - "8080:8080" # 宿主机端口:容器端口 volumes: - ./data:/app/data restart: always

EXPOSE只是声明端口，真正的映射由 compose 里的ports完成；volumes把./data挂进容器，重建容器时数据还在。

构建镜像，确认它活着

两个文件就位后，剩下的事交给 Compose：

docker compose up -d

首次构建要拉基础镜像、跑构建步骤，耐心等几分钟。起来之后看一眼状态和日志：

docker ps docker compose logs -f

日志正常滚动、没有 ERROR，浏览器打开http://localhost:8080就能看到管理界面，部署完成。

之后怎么管

• 看实时日志：docker compose logs -f，按 Ctrl+C 退出
• 停止服务：docker compose down，容器和数据卷都停掉
• 更新系统：先git pull，再docker compose up -d --build，--build会强制重建镜像，编排配置不用动

⚠️ 容易踩的坑

• 启动报 8080 端口被占用 → 宿主机上有别的服务占着端口 → 把 compose 里映射左侧换成空闲端口（如"80:8080"），容器内端口不用改
• 日志里报找不到 jar → 镜像里根本没有那个启动文件 → 核对 Dockerfile 中CMD写的文件名和目录里的实际文件是否一致
• git pull之后跑的还是旧版 → 重建时没加--build，容器复用了旧镜像 → 更新时永远带着--build参数

镜像本身偏大，后续可以做瘦身（多阶段构建、换更小基础镜像），或者接一个监控，容器挂了第一时间知道。项目背景和上游依赖说明见 README.md。

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC