kolstr/node-radio

镜像概述

该Docker镜像为radio-browser提供的官方Web前端界面，用于访问和管理全球各地的广播电台资源。作为radio-browser生态系统的核心组件，该前端允许用户通过直观的Web界面浏览、搜索、播放各类广播电台，并获取电台详细信息，无需复杂配置即可快速部署使用。

核心功能与特性

• 多维度电台浏览：支持按国家、语言、流派、标签等分类浏览全球广播电台
• 精准搜索功能：提供按电台名称、关键词、频率、地理位置等条件的搜索能力
• 内置媒体播放：集成播放器，支持直接播放选中的电台流媒体
• 实时电台状态：显示电台在线状态、当前听众数量、比特率等实时信息
• 响应式界面：适配桌面端、平板及移动端设备，提供一致的用户体验
• 开源架构：基于开源协议构建，支持二次开发和功能扩展

使用场景

• 个人电台中心：供个人用户发现和收听全球各类广播电台
• 家庭媒体系统：集成到家庭影音中心，作为背景音乐播放解决方案
• 公共场所部署：咖啡馆、商店等场所提供背景音乐选择界面
• 电台爱好者社区：为电台爱好者提供共享和交流电台资源的平台
• 开发测试环境：作为radio-browser后端服务的配套前端，用于API功能验证

使用方法

基本部署（docker run）

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

bash
docker run -d -p 8080:80 --name radio-browser-frontend radio-browser/frontend:latest

参数说明：

• -d：后台运行容器
• -p 8080:80：将容器内80端口映射到主机8080端口（主机端口可自定义）
• --name radio-browser-frontend：指定容器名称
• radio-browser/frontend:latest：使用最新版本镜像

启动成功后，通过 http://<主机IP>:8080 访问Web界面。

环境变量配置

可通过环境变量自定义前端行为，常用配置项如下：

示例：指定自定义后端API地址启动：

bash
docker run -d -p 80:80 \
  -e API_URL="http://your-backend-server:8080" \
  -e THEME="dark" \
  --name radio-frontend \
  radio-browser/frontend:latest

Docker Compose 配置

创建 docker-compose.yml 文件，实现前端与后端服务联动部署：

yaml
version: '3.8'
services:
  frontend:
    image: radio-browser/frontend:latest
    ports:
      - "80:80"
    environment:
      - API_URL="http://backend:8080"
      - THEME="dark"
    depends_on:
      - backend
    restart: unless-stopped

  backend:
    image: radio-browser/backend:latest
    ports:
      - "8080:8080"
    volumes:
      - ./radio-data:/app/data
    restart: unless-stopped

启动服务栈：

bash
docker-compose up -d

注意事项

• 确保后端API服务（radio-browser后端）可访问，前端依赖其提供电台数据
• 生产环境建议配置反向代理（如Nginx）并启用HTTPS，增强传输安全性
• 如需持久化配置，可通过挂载卷的方式保存自定义主题设置或用户偏好
• 容器运行用户建议使用非root用户，通过 --user 参数指定UID/GID提升安全性