飞牛NAS一键部署VoiceHub：打造专属校园广播站点歌系统

VoiceHub：

一个使用 Nuxt 4 全栈框架开发的现代化校园广播站点歌管理系统。系统提供完整的点歌、投票、排期管理、通知推送、数据分析、权限控制和数据库管理功能，支持多角色权限管理和灵活的系统配置。

主要功能：

1. 智能点歌系统（核心）

多平台音乐搜索：支持网易云音乐、QQ 音乐、哔哩哔哩内容检索，可指定期望播出时段；
网易云音乐深度集成：扫码登录后可同步歌单 / 最近播放、一键投稿，支持播客电台内容投稿；
投稿限额：按时间段 / 用户角色配置投稿额度，控制系统负载；
智能去重：识别重复歌曲，避免重复播放；
播放与下载：内置播放器（支持音质切换、进度控制），管理员可批量下载歌曲（多音质可选）；
重播申请：用户可申请重播已播放歌曲，支持记录查看 / 撤回。

2. 用户与权限管理

多角色权限：普通用户、管理员、超级管理员分级管控；
用户分类：按年级 / 班级管理用户，支持黑名单（歌曲 / 艺术家）自动过滤不当内容；
安全机制：JWT 认证、验证码验证、密码 bcrypt 加密。

3. 排期管理

可视化排期：拖拽式界面管理歌曲排期与顺序；
排期草稿：支持分步编辑、草稿发布，不影响公开展示；
多时段配置：灵活设置播出时段，支持学期关联、排期打印（自定义纸张 / PDF 导出）；
公开展示：按日期分组展示正式排期，方便师生查看。

4. 通知与数据管理

实时通知：歌曲选中 / 投票 / 系统消息，支持自定义通知偏好、批量推送、第三方账号绑定；
数据安全：数据库备份 / 恢复 / 重置、文件导入导出，自带数据库自检修复机制；
操作审计：关键操作记录可追溯。

安装

Docker Compose

services:
voicehub:
    image: ghcr.io/laoshuikaixue/voicehub:latest
    container_name: voicehub
    ports:
      - 3000:3000
    environment:
      - DATABASE_URL=postgresql://user:password@postgres:5432/voicehub
      - JWT_SECRET=your-jwt-secret-here
      - NODE_ENV=production
    depends_on:
      postgres:
        condition: service_healthy
    restart: unless-stopped

postgres:
    image: postgres:15-alpine
    container_name: postgres
    ports:
      - 5432:5432
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=voicehub
    volumes:
      - ./postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -U user -d voicehub']
      interval: 5s
      timeout: 5s
      retries: 5
    restart: unless-stopped

参数说明（更多参数建议去看文档）

:::
DATABASE_URL（环境变量）：数据库连接地址

JWT_SECRET（环境变量）：JWT 认证密钥，随机生成字符串

NODE_ENV（环境变量，可选）：应用运行环境

3000（端口）：Web 页面访问端口

5432（端口，可选）：数据库访问端口，项目内部连接可以不映射

POSTGRES_USER（环境变量）：数据库用户名

POSTGRES_PASSWORD（环境变量）：数据库密码

POSTGRES_DB（环境变量）：自动创建的初始数据库名

:::