yinyun-lxserver

Project Overview

Yinyun is a self-hosted music server designed to run on a NAS or a personal server. Its built-in web player aggregates searches across major music platforms and lets you play, favorite, or download results while managing a local library. The server supports multiple sync accounts, playlist sharing, data snapshots, and the Subsonic protocol, and works with a standalone Windows client or third-party clients.

A searchable, downloadable, and syncable music library on your own NAS

Key Features

• Search and playback: aggregated search across major platforms with one-click play, favorite, or download
• Local library management: automatic scanning with nested folders, search, filters, and batch actions
• Multi-tier downloads: quality options from standard to master, with server-side queues that continue offline
• Library remaster: batch-select local tracks and re-download them at a target quality
• Player settings: quality, caching, proxy, lyrics, theme, and sound effect options
• Accounts and permissions: sync accounts that isolate each user's playlists, settings, and cache
• Playlist sharing: share within one server or across servers, then import
• Subsonic protocol: compatible with clients such as AudioStream, LMP, and Feishin
• Admin console: connection counts, resource usage, plus data, snapshot, and log tools

Target Audience

• Music collectors who own a NAS
• Users who self-host private music services
• Audiophiles chasing lossless quality
• Families that need multi-account sync
• Users of Subsonic clients

Quick Start

Option 1: Docker

1. Pull the image bobcc4/yinyun-lxserver:latest
2. Start it with Docker Run or Compose, mapping port 9527 and the four data folders
3. Open the web player at http://your-ip:9527/
4. Open the admin console at http://your-ip:9527/admin and log in with the default password 123456
5. Change the default admin password and create a sync account

docker run -d -p 9527:9527 -v ./data:/server/data -v ./logs:/server/logs -v ./cache:/server/cache -v ./music:/server/music --name yinyun --restart unless-stopped bobcc4/yinyun-lxserver:latest

Option 2: Run from source

1. Clone the repository and enter it: git clone https://github.com/bobcc4/yinyun-lxserver.git && cd yinyun-lxserver
2. Install dependencies and build: npm ci && npm run build
3. Start the service: npm start

git clone https://github.com/bobcc4/yinyun-lxserver.git && cd yinyun-lxserver
npm ci && npm run build
npm start

Core Advantages

• Private hosting: your data and library stay on your own server
• One console: playback, downloads, remastering, and sharing live in one place
• Account isolation: each sync account keeps its own playlists, settings, and cache
• Protocol compatible: it plugs into the existing Subsonic client ecosystem
• Flexible deployment: Docker, source, or release packages

System Requirements

Notes

• Change the default admin password 123456 right after the first deployment
• Enable HTTPS and access control at the reverse proxy when exposing it publicly
• The reverse proxy must allow /api/v1, /rest, and the real audio URLs, and support audio Range requests
• Keep the data, logs, cache, and music mount folders when upgrading or migrating
• Anonymous telemetry is built in and can be turned off with DISABLE_TELEMETRY=true