yinyun-lxserver

项目概述

音云 Yinyun 是一个可以私有部署的音乐服务器，适合安装在 NAS 或服务器上。它内置 Web 播放器，能聚合搜索主流音乐平台并直接播放、收藏或下载，同时管理本地曲库。服务端支持多用户同步账户、歌单分享、数据快照与 Subsonic 协议，可搭配独立 Windows 客户端或第三方客户端使用。

在自家 NAS 上搭一座能搜索、能下载、能同步的音乐库

主要功能

• 多平台搜索播放：聚合主流平台搜索，结果可直接播放、收藏或下载
• 本地曲库管理：自动扫描音乐目录，支持多层目录、搜索、筛选与批量操作
• 多档音质下载：提供从标准到母带的音质选项，服务端下载队列离线也能继续
• 歌曲洗版：批量选择本地歌曲，按目标音质重新下载
• 播放器设置：支持音质、缓存、代理、歌词、主题与音效配置
• 账号与权限：创建同步账户，隔离各用户的歌单、设置与缓存目录
• 歌单分享：支持同一服务端内分享，也支持跨服务端分享与导入
• Subsonic 协议：兼容音流、LMP、Feishin 等客户端
• 管理后台：查看连接数、资源占用，维护数据、快照与日志

适用人群

• 拥有 NAS 的音乐收藏者
• 自建私有音乐服务的用户
• 追求无损音质的发烧友
• 需要多账户同步的家庭用户
• 使用 Subsonic 客户端的用户

快速上手

方式一：Docker 部署

1. 拉取镜像 bobcc4/yinyun-lxserver:latest
2. 用 Docker Run 或 Compose 启动，映射 9527 端口与四个数据目录
3. 打开 Web 播放器 http://your-ip:9527/
4. 打开管理后台 http://your-ip:9527/admin，用默认密码 123456 登录
5. 在后台修改默认管理密码并创建同步账户

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

方式二：源码运行

1. 克隆仓库并进入目录：git clone https://github.com/bobcc4/yinyun-lxserver.git && cd yinyun-lxserver
2. 安装依赖并编译：npm ci && npm run build
3. 启动服务：npm start

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

核心优势

• 私有部署：数据与曲库都保存在自己的服务器上
• 一处管理：播放、下载、洗版与分享集中在同一个后台
• 账户隔离：每个同步账户的歌单、设置与缓存互不干扰
• 协议兼容：可直接接入已有的 Subsonic 客户端生态
• 部署灵活：支持 Docker、源码与发行包多种方式

系统要求

注意事项

• 首次部署后请立即修改默认管理密码 123456
• 通过公网访问时建议在反向代理层启用 HTTPS 与访问控制
• 反向代理需放行 /api/v1、/rest 与实际音频地址，并支持音频 Range 请求
• 升级或迁移时须保留 data、logs、cache、music 四个挂载目录
• 项目内置匿名统计，可用 DISABLE_TELEMETRY=true 关闭