podcastserver/ui

Podcast Server Web UI 镜像文档

镜像概述

Podcast Server Web UI 镜像是为Podcast Server提供的Web用户界面组件，旨在提供直观、高效的播客管理与播放体验。通过该界面，用户可轻松完成播客订阅、内容播放、历史记录追踪等操作，无需依赖复杂命令行工具，适用于各类播客爱好者和媒体中心场景。

核心功能与特性

• 播客订阅管理：支持添加、编辑、删除播客源，自动同步最新 episodes
• 多媒体播放：集成网页播放器，支持播放/暂停、进度调节、音量控制及播放速度调整
• 内容组织：按类别、更新时间、播放状态等维度对播客内容进行分类管理
• 历史追踪：自动记录播放进度，支持跨设备续播及播放历史查询
• 搜索与筛选：快速检索已订阅播客或 episodes，支持关键词过滤
• 响应式设计：适配桌面、平板及移动设备，提供一致的操作体验

使用场景与适用范围

• 个人用户：管理个人播客收藏，打造个性化播客收听库
• 家庭媒体中心：作为家庭影音系统的一部分，供家庭成员共享播客资源
• 小型办公环境：团队内部共享行业播客、培训内容，支持协作学习
• 教育场景：教师或学生管理教育类播客，辅助课程学习与知识积累

使用方法与配置说明

基础部署（Docker Run）

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

bash
docker run -d \
  --name podcast-webui \
  -p 8080:8080 \
  -v /path/to/local/data:/app/data \
  podcast-server-webui:latest

参数说明：

• -p 8080:8080：端口映射（主机端口:容器端口，默认容器端口为8080）
• -v /path/to/local/data:/app/data：挂载数据卷，用于持久化存储订阅列表、播放记录等数据

环境变量配置

通过环境变量自定义运行参数，常用配置如下：

带环境变量的启动示例：

bash
docker run -d \
  --name podcast-webui \
  -p 80:8080 \
  -v /opt/podcast-data:/app/data \
  -e API_ENDPOINT="http://podcast-server:3000/api" \
  -e DEFAULT_LANGUAGE="zh-CN" \
  -e ENABLE_AUTH="true" \
  -e ADMIN_USERNAME="podcast_admin" \
  -e ADMIN_PASSWORD="SecurePass123!" \
  podcast-server-webui:latest

Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  webui:
    image: podcast-server-webui:latest
    container_name: podcast-webui
    ports:
      - "8080:8080"
    volumes:
      - ./webui-data:/app/data
    environment:
      - API_ENDPOINT="http://backend:3000/api"
      - DEFAULT_LANGUAGE="zh-CN"
      - ENABLE_AUTH="true"
    restart: unless-stopped
    depends_on:
      - backend  # 需配合后端Podcast Server服务使用

  backend:
    image: podcast-server-backend:latest  # 假设存在后端服务
    container_name: podcast-backend
    volumes:
      - ./backend-data:/app/data
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

1. 后端依赖：若Web UI需连接独立后端服务，需确保 API_ENDPOINT 配置正确且后端服务正常运行
2. 数据持久化：务必挂载数据卷（/app/data），避免容器重建导致订阅数据和播放记录丢失
3. 安全加固：启用认证后，建议首次登录后立即修改默认管理员密码
4. 端口冲突：若主机8080端口已被占用，可修改 -p 参数的主机端口（如 -p 8081:8080）