music-on

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #typescript #rust #macos #nodejs #awesome #cli #awesome-list #pytorch #mcp #openai

(★ 21)

一个面向云盘音乐库管理的现代个人音乐中心，支持网盘挂载、Subsonic 协议接入以及美观的前端展示。

music-on Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <h3><img src="https://github.com/gefl24/music-on/blob/main/tag/logo.svg" alt="MusicOn"></h3>
  <h3>面向云盘音乐库管理的现代个人音乐中心</h3>
  <p>支持 AList/网盘 挂载、FastAPI 极速扫描、Subsonic 协议接入以及 Vue 3 现代化管理后台</p>

## 🌟 核心特性

- **🚀 异步极速扫描**：采用 Python 异步 I/O (AsyncIO) 机制构建强大的网盘 扫描器，无缝解析夸克、115等网盘海量云端音乐。扫描任务运行于后台，不阻塞主应用响应。
- **📱 完美兼容 Subsonic**：内置兼容 Subsonic API (v1.16.1)，你可以使用任意支持 Subsonic 协议的客户端（如音流、Navidrome、DSub、PlaySub）全平台无缝串流。
- **🌐 零流量云端直链播放**：创新架构设计！播放音频时，后端会智能重定向 (302) 到云盘直链，听无损音乐**完全不消耗本地服务器带宽与流量**，且无需磁盘缓存。
- **👑 全网榜单精选**：对接 LX-Server，每日自动拉取全网 5 大核心音乐榜单（热歌/新歌/抖音神曲等）。即便你网盘没有这些歌，依然能通过流媒体劫持在客户端直接秒播！扫描网盘时，还会自动将虚拟在线歌曲替换为你的本地无损高音质版本。
- **🖼️ 智能缩略图优化**：内建基于 Pillow 的图像引擎，自动将提取的歌曲封面压缩为极小体积的 WebP 格式，配合前端虚拟列表与懒加载，万首曲库依然丝滑。
- **💻 现代化 Web 控制台**：基于 Vue 3 构建的响应式控制台。支持曲库管理、批量删除清理、播放历史统计与扫描任务实时监控。
- **📦 极简部署体验**：后端 FastAPI + 前端静态托管同源打包。只需配合一个 PostgreSQL 数据库，一键 Docker Compose 拉起。官方提供 `amd64` / `arm64` 双架构镜像。

## 📸 界面预览
![首页](https://github.com/gefl24/music-on/blob/main/tag/%E9%A1%B5%E9%9D%A21.png)
![歌单页](https://github.com/gefl24/music-on/blob/main/tag/%E9%A1%B5%E9%9D%A23.png)

## 🚀 快速开始 (Docker Compose)
### 方案 A：默认 SQLite（推荐）
推荐使用 Docker Compose 进行部署。创建一个 `docker-compose.yml` 文件：

```yaml
services:
  musicon:
    image: geelonn/musicon:latest
    container_name: musicon
    environment:
      DATABASE_URL: sqlite:///./data/musicon.db
    ports:
      - 8000:8000
    volumes:
      - ./data:/app/data
    restart: unless-stopped
    healthcheck:
      test: ['CMD-SHELL', 'python -c "import urllib.request; urllib.request.urlopen(\"http://127.0.0.1:8000/health\")"']
      interval: 15s
      timeout: 5s
      retries: 10
```
### 方案 B：使用PostgreSQL

```yaml
services:
  musicon:
    image: geelonn/musicon:latest
    container_name: musicon-app
    environment:
      DATABASE_URL: postgresql+psycopg://musicon:${POSTGRES_PASSWORD:-change_me}@postgres:5432/musicon
    ports:
      - '${BACKEND_PORT:-8000}:8000'
    depends_on:
      postgres:
        condition: service_healthy
    volumes:
      - ./data:/app/data
    restart: unless-stopped
    healthcheck:
      test: ['CMD-SHELL', 'python -c "import urllib.request; urllib.request.urlopen(\"http://127.0.0.1:8000/health\")"']
      interval: 15s
      timeout: 5s
      retries: 10

postgres:
    image: postgres:16-alpine
    container_name: musicon-postgres
    environment:
      POSTGRES_DB: musicon
      POSTGRES_USER: musicon
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-change_me}
    ports:
      - '${POSTGRES_PORT:-5432}:5432'
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ['CMD-SHELL', 'pg_isready -U musicon -d musicon']
      interval: 10s
      timeout: 5s
      retries: 10

volumes:
  postgres_data:

```

一键拉起服务：
```bash
docker compose up -d
```

服务启动后，在浏览器访问 `http://localhost:8000` 即可进入 Web 控制台。

---

## ⚙️ 配置指南

1. **登录控制台**：默认密码 changeme ，进入后请立即前往【系统设置】修改你的管理密码。
2. **连接网盘**：在【系统设置】中填入你的夸克Token 或者 AList 地址（如 `http://192.168.x.x:5244`）和 Token。
3. **扫描音乐**：前往【扫描任务】页面，填入网盘中存放音乐的挂载路径（如 `/Music`），点击新建扫描，后台会自动异步拉取歌曲。
4. **配置 LX-Server (选填)**：若你想白嫖全网热歌榜单的在线流媒体播放，请在【扫描任务】顶部填入你部署的 LX-Server 地址，并点击“刷新网络榜单”。
5. **客户端连接 (Subsonic)**：
   - **服务器地址**: `http://你的IP:8000`
   - **用户名**: `admin` (默认，可在设置中修改)
   - **密码**: 在【系统设置】中配置的 Subsonic 密码

---

## 🛠️ 环境变量说明

| 变量名 | 必填 | 默认值 | 描述 |
| :--- | :---: | :--- | :--- |
| `DATABASE_URL` | ✅ | 无 | PostgreSQL 数据库连接串 |
| `SECRET_KEY` | ✅ | 无 | 用于加密会话和 Cookie 的密钥 |
| `PORT` | ❌ | `8000` | 容器内部监听端口 |
| `TZ` | ❌ | `Asia/Shanghai` | 容器时区 |

---

## 🔗 相关链接

- **提交 Issue**: [Report a bug](https://github.com/gefl24/music-on/issues)

*如果觉得好用，欢迎在 GitHub 上给个 ⭐ Star！*

## 🤝 参与贡献

非常欢迎提交 Pull Request (PR) 或者提出 Issue。无论是功能建议、Bug 修复，还是文档完善，都能帮助 MusicOn 变得更好！

music-on

music-on Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

music-on

music-on Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README