mediathekview/mediathekviewweb

MediathekViewWeb Docker镜像文档

概述

MediathekViewWeb是MediathekView的Web版本，专为访问德国公共电视台（如ARD、ZDF等）的媒体内容设计。该Docker镜像提供了便捷的部署方式，让用户通过浏览器即可浏览、搜索和流媒体播放海量公共媒体资源，无需本地安装复杂软件。

核心功能与特性

• 媒体内容访问：整合德国多家公共电视台的媒体库，提供电视节目、电影、纪录片等内容的访问
• 高级搜索：支持按标题、频道、日期、主题等多维度搜索媒体内容
• 分类浏览：按频道、节目类型、播出日期等分类组织内容，便于快速定位
• 流媒体播放：直接在浏览器中流式播放媒体内容，无需额外播放器
• 收藏功能：允许用户收藏喜爱的节目，方便后续访问
• 响应式设计：适配桌面和移动设备，提供一致的浏览体验
• 数据持久化：支持用户配置和收藏数据的持久化存储

使用场景与适用范围

• 个人媒体消费：家庭用户通过浏览器访问德国公共媒体内容，观看错过的电视节目或纪录片
• 教育用途：教师或学生查找德语教育内容、纪录片等教学资源
• 家庭媒体中心：作为家庭媒体中心的一部分，提供公共媒体内容的集中访问入口
• 旅居人士：海外德语使用者访问德国本土公共媒体内容

使用方法与配置说明

基本部署

通过以下命令快速启动MediathekViewWeb容器：

bash
docker run -d \
  --name docker.xuanyuan.run/mediathekviewweb \
  -p 8080:8080 \
  -v /path/to/data:/app/data \
  --restart unless-stopped \
  docker.xuanyuan.run/mediathekviewweb

参数说明：

• -p 8080:8080：将容器内8080端口映射到主机8080端口，用于Web访问
• -v /path/to/data:/app/data：挂载数据卷，持久化存储用户配置和收藏数据
• --restart unless-stopped：容器退出时自动重启（除非手动停止）

环境变量配置

可通过环境变量自定义容器行为：

示例：自定义端口和日志级别

bash
docker run -d \
  --name docker.xuanyuan.run/mediathekviewweb \
  -p 80:8081 \
  -v /path/to/data:/app/data \
  -e PORT=8081 \
  -e LOG_LEVEL=DEBUG \
  docker.xuanyuan.run/mediathekviewweb

Docker Compose部署

创建docker-compose.yml文件简化部署：

yaml
version: '3'
services:
  mediathekviewweb:
    image: docker.xuanyuan.run/mediathekviewweb
    container_name: mediathekviewweb
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    environment:
      - LOG_LEVEL=INFO
      - MAX_CACHE_SIZE=1000
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问应用

部署完成后，通过浏览器访问 http://<主机IP>:8080 即可使用MediathekViewWeb。首次访问需等待应用初始化媒体库索引（可能需要几分钟，取决于网络速度）。

注意事项

• 媒体内容版权归德国公共电视台所有，使用需遵守相关版权***
• 首次启动时媒体库索引构建可能需要较长时间，请耐心等待
• 确保主机有稳定的网络连接，以保证媒体内容的正常加载和播放
• 对于移动设备访问，建议使用Chrome、Firefox等现代浏览器以获得最佳体验