# musichub-docker

**Repository Path**: ambitiouscat/musichub-docker

## Basic Information

- **Project Name**: musichub-docker
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-09
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MusicHub

统一音乐平台 - 连接 Navidrome 与在线音乐源

## 功能

- 连接 Navidrome 本地音乐库
- 浏览、搜索、播放本地音乐
- 收藏歌曲管理
- 播放列表管理
- 在线搜索（网易云、QQ、酷狗、咪咕）
- 一键下载到本地曲库

## 快速开始

### 1. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env 填入你的 Navidrome 密码
```

### 2. 启动服务

```bash
docker-compose up -d --build
```

### 3. 访问

- 前端: http://localhost:3010
- API 文档: http://localhost:8010/docs

## 目录结构

```
musichub/
├── frontend/          # Vue 3 前端
│   ├── src/
│   │   ├── api/       # API 封装
│   │   ├── components/# 组件
│   │   ├── views/     # 页面
│   │   └── stores/    # Pinia 状态管理
│   └── Dockerfile
├── backend/           # FastAPI 后端
│   ├── app/
│   │   ├── routers/   # API 路由
│   │   ├── services/  # 业务服务
│   │   └── models/    # 数据模型
│   └── Dockerfile
└── docker-compose.yml
```

## 支持的在线平台

- 网易云音乐
- QQ音乐
- 酷狗音乐
- 咪咕音乐

## 技术栈

- 前端: Vue 3 + TypeScript + Element Plus + TailwindCSS
- 后端: Python + FastAPI
- 部署: Docker Compose

## 注意事项

1. 需要与 Navidrome 在同一个 Docker 网络中
2. 音乐目录需要共享挂载
3. 下载功能依赖各平台的公开 API，可能有反爬限制