musicshare/frontend

MusicShare前端

MusicShare是一款简单且功能强大的自托管开源音乐库前端应用，旨在解决传统音乐播放器体验下降与流媒体服务缺乏所有权的问题，让用户完全掌控并分享自己的音乐收藏。

核心功能

• 自托管音乐库管理：用户拥有音乐文件的完全控制权
• 直观单页界面：提供流畅的网页端操作体验
• 音乐分享能力：支持在授权范围内共享音乐资源
• 跨设备访问：通过网页实现多终端无缝使用

使用场景

1. 个人音乐管理：替代本地播放器，实现云端化的音乐存储与分类
2. 家庭/小团队共享：在内部网络中分享音乐库资源
3. 独立创作者展示：用于展示和分享原创音乐作品

配置说明

Docker部署示例

单容器运行

bash
# 需先确保后端服务已启动，替换your-backend-url为实际后端地址
docker run -d \
  --name musicshare-frontend \
  -p 8080:80 \
  -e API_URL=http://your-backend-url:3000 \
  docker.xuanyuan.run/musicshare/frontend

Docker Compose完整部署（含后端与数据库）

yaml
version: '3'
services:
  frontend:
    image: docker.xuanyuan.run/musicshare/frontend
    ports: ["8080:80"]
    environment: { API_URL: "http://backend:3000" }
    depends_on: [backend]
  
  backend:
    image: docker.xuanyuan.run/musicshare/backend # 需配合对应后端镜像使用
    environment:
      DB_HOST: db
      DB_USER: postgres
      DB_PASSWORD: postgres
      DB_NAME: musicshare
    depends_on: [db]
  
  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: musicshare
    volumes: [postgres_data:/var/lib/postgresql/data]

volumes: { postgres_data: }

开发与贡献

如需参与开发或贡献代码，请参考项目https://github.com/yss14/musicshare/wiki/Contributing%E3%80%82

许可证

本项目采用AGPL许可证。