cheatsnake/airstation

自托管网络广播电台Docker镜像文档

概述

本Docker镜像提供完整的自托管网络广播电台解决方案，允许用户无需复杂服务器配置，通过简单Docker命令快速搭建个人、社区或组织的互联网广播服务。支持音频流实时传输、自定义内容管理和多平台访问，适合各类非商业广播场景部署。

核心功能与特性

• 音频流传输：支持MP3、AAC、OGG等主流音频格式实时流传输，兼容多数媒体播放器和浏览器
• 播放列表管理：支持本地音频文件上传和在线流媒体源接入，可创建自定义播放序列
• Web管理界面：内置直观的Web控制面板，通过浏览器管理广播内容、监控流状态和调整参数
• 多客户端支持：兼容网络收音机、移动设备和桌面播放器，支持HTTP/RTSP协议流访问
• 轻量化部署：基于Alpine Linux构建，镜像体积小、资源占用低，适合个人服务器或云主机
• 数据持久化：支持音频文件和配置数据持久化存储，确保服务重启后数据不丢失

使用场景与适用范围

• 个人网络广播：音乐爱好者搭建个人音乐电台，分享收藏内容
• 社区/校园电台：社区组织或学校构建非商业广播服务，传播本地资讯文化
• 活动直播：小型活动（讲座、演出、会议）的音频实时直播解决方案
• 企业内部广播：企业内部信息发布、培训内容推送的内部音频系统
• 教育机构：语言学习、课程内容的音频点播与直播平台

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动服务：

bash
docker run -d \
  --name internet-radio \
  -p 8000:8000 \  # Web管理界面端口
  -p 8001:8001 \  # 音频流输出端口
  -v /path/to/local/audio:/app/audio \  # 本地音频文件目录映射
  -v /path/to/config:/app/config \      # 配置文件持久化目录
  -e STATION_NAME="My Radio Station" \  # 电台名称
  -e ADMIN_PASSWORD="securepassword" \  # Web管理界面密码
  internet-radio-image:latest

Docker Compose配置

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

yaml
version: '3'
services:
  radio:
    image: internet-radio-image:latest
    container_name: internet-radio
    ports:
      - "8000:8000"   # Web管理界面
      - "8001:8001"   # 音频流端口
    volumes:
      - ./audio:/app/audio    # 音频文件存储目录
      - ./config:/app/config  # 配置数据存储目录
      - ./logs:/app/logs      # 运行日志存储目录（可选）
    environment:
      - STATION_NAME="Community Radio"
      - ADMIN_PASSWORD="your_secure_password"
      - STREAM_BITRATE=128    # 音频流比特率(kbps)，默认128
      - MAX_CLIENTS=50        # 最大并发连接数，默认50
      - CACHE_TTL=3600        # 流缓存时间(秒)，默认3600
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

环境变量说明

配置说明

1. Web管理界面访问：服务启动后通过http://<服务器IP>:8000访问，使用ADMIN_PASSWORD登录
2. 音频文件管理：本地音频文件放入映射的/path/to/local/audio目录，Web界面直接管理
3. 播放列表创建：登录管理界面后在"播放列表"模块创建自定义序列，支持拖拽排序和定时播放
4. 流地址分享：听众通过http://<服务器IP>:8001/stream访问音频流，支持嵌入网站或播放器

数据持久化建议

必须挂载以下目录确保数据持久化：

• /app/audio：存储音频文件（重启后文件不丢失）
• /app/config：存储系统配置和播放列表数据
• /app/logs：可选，用于存储服务运行日志便于问题排查