vd39/subsonic-player

Subsonic Player: 现代Subsonic客户端

概述

Subsonic Player是一个响应式、现代化的Web客户端，专为https://github.com/topics/subsonic/设计。

该开源应用基于现代Vue 3框架Nuxt 4构建，可在所有设备上提供无缝且愉悦的音乐聆听体验。

兼容服务器：

• https://github.com/sentriz/gonic/（本应用主要针对https://github.com/sentriz/gonic/优化）
• https://github.com/airsonic-advanced/airsonic-advanced/
• https://github.com/navidrome/navidrome/
• https://github.com/topics/subsonic/

核心功能与特性

1. 全响应式UI（持续优化设计中）

• 针对桌面和移动设备优化
• 自适应设计

2. 全面的音乐库浏览

• 按专辑、艺术家、流派和文件夹/文件浏览
• 探索播客和收藏内容
• 访问网络广播电台

3. 高级功能

• 播客剧集书签功能，跨会话跟踪收听进度
• MediaSession集成
• 高级搜索功能
• 深色/浅色模式支持
• 键盘快捷键（按h查看菜单）
• 右键菜单（桌面）或长按（移动）访问上下文菜单，可对曲目、专辑、播放列表等执行快速操作
• 拖放功能（仅桌面版），可将喜爱的曲目、专辑和播客剧集直接拖入队列或侧边栏播放列表

4. 渐进式Web应用（PWA）特性

• 可将应用图标下载到主屏幕，像原生应用一样便捷启动
• 相比传统下载应用占用更少设备存储空间，同时提供强大功能

预览

点击图片查看应用实际运行视频。

深色主题

浅色主题

安装方法

先决条件：

• Docker（推荐）
• Node.js 20+
• Yarn

方法1：Docker部署

Docker Compose配置

最简单的运行方式是通过Docker Compose，此方法会自动处理依赖和配置。

环境变量为可选，可根据需要自定义。

创建docker-compose.yml文件，内容如下：

yml
services:
  subsonic-player:
    container_name: subsonic-player
    image: vd39/subsonic-player:latest
    ports:
      - '3000:3000'
    restart: unless-stopped

在终端执行以下命令：

bash
docker compose up -d

应用将可通过http://localhost:3000访问。

预览版本

提供预览版本（vd39/subsonic-player:preview）供希望提前体验最新更改的用户使用。注意：此版本包含仍在内部测试的更改，可能存在bug或稳定性问题，请自行承担风险。

yml
image: vd39/subsonic-player:preview

Docker Run命令（替代方法）

此方法提供更精细的控制：

bash
docker run -d \
  --name subsonic-player \
  -p 3000:3000 \
  --restart unless-stopped \
  vd39/subsonic-player:latest

应用将可通过http://localhost:3000访问。

方法2：静态SPA导出

预构建的静态SPA归档文件在https://github.com/VD39/subsonic-player/releases发布。每个版本包含一个.tar.gz压缩包，可通过任何静态文件服务器（Nginx、Caddy、Apache、S3等）提供服务。

1. 从https://github.com/VD39/subsonic-player/releases页面下载最新压缩包

2. 解压归档文件：

   bash
   tar -xzvf subsonic-player-static-*.tar.gz -C /var/www/subsonic-player
   

3. 使用首选的静态文件服务器提供解压后的目录

方法3：本地开发

此方法跳过Docker，直接使用Node.js和Yarn运行应用：

1. 克隆仓库：

   bash
   git clone https://github.com/VD39/subsonic-player.git
   

2. 进入项目目录：

   bash
   cd subsonic-player
   

3. 安装依赖：

   bash
   yarn install
   

4. （可选） 创建.env文件：在项目根目录创建.env文件，用于存储环境变量

5. 启动开发服务器：

   bash
   yarn dev
   

开发服务器将在http://localhost:3000启动。代码更改将自动触发重建并刷新浏览器。

环境变量

贡献

欢迎任何形式的贡献！请随时在GitHub上贡献代码、提供反馈或提交issue。

许可证

本项目采用AGPLv3许可证。完整许可证详情见LICENSE文件。

项目资源

• https://github.com/VD39/subsonic-player
• https://hub.docker.com/r/vd39/subsonic-player