liqman/yinyun-lxserver repository overview

音云 Yinyun（Lite 精简版）— 私有音乐服务器与 Web 播放器

面向私有部署的音乐服务器，内置 Web 播放器与 Subsonic 协议支持，Docker 一键运行。

⁠✨ 功能特性

Web 播放器

• 多平台在线聚合搜索与播放（酷我 / 酷狗 / 咪咕 / 网易 / 腾讯等公开接口元数据）
• 排行榜、歌手/专辑详情、歌词（含翻译）、评论、搜索建议
• 自定义音源管理（支持 JS 自定义源脚本），无限扩展音乐来源
• 本地曲库扫描、文件缓存、下载队列、洗版（重新压制）、歌词嵌入
• 收藏 / 歌单 / 我的收藏按账号隔离并持久化，与 Subsonic 客户端双向同步
• 单曲行内一键收藏、批量选择收藏/下载/删除、歌单内搜索
• PWA 支持（可安装为桌面/手机应用）、深浅主题、移动端适配

Subsonic 协议

• 完整 Subsonic 开放协议，支持音流（StreamMusic）、LMP、Feishin、DSub 等客户端
• 歌单、收藏（红心）、播放列表、星级、搜索、在线试听/直链播放
• 在线全网搜索（可选），客户端可直接搜到多平台歌曲

机器人下载

• Telegram 机器人：发送关键词搜索、点歌、批量下载
• 企业微信自建应用：文字指令搜索与下载
• 网易云歌单自动下载（支持跨平台兜底搜索）
• 下载存储支持本地 / WebDAV / SMB，可选 AI 自动分类（OpenAI 兼容接口）

安全与多用户

• 多同步账户隔离（收藏、歌单、缓存、下载互不干扰）
• scrypt 密码哈希、登录限速、路径穿越防护、敏感日志脱敏

⁠🔌 Subsonic 客户端对接方法

1. 服务端默认已开启 Subsonic（subsonic.enable: true），访问路径默认为 /rest；
2. 客户端（音流 StreamMusic / LMP / Feishin / DSub 等）填写：

1. 账号密码与 Web 播放器共用同一套；Subsonic 中创建的歌单、红心收藏会与 Web 端“我的收藏”双向同步；
2. 可选配置：
   • subsonic.streamMode: redirect（客户端直连音源）或 proxy（经服务器中转）；
   • subsonic.onlineSearch: true 开启在线搜索，客户端搜索可聚合多平台；
   • subsonic.onlineSearchSources 自定义在线搜索平台（默认 wy,tx,kw,kg,mg）。

⁠🚀 快速开始

docker run -d \
  -p 9527:9527 \
  -v $(pwd)/data:/server/data \
  -v $(pwd)/logs:/server/data/logs \
  -v $(pwd)/cache:/server/cache \
  -v $(pwd)/music:/server/music \
  -v $(pwd)/downloads:/server/downloads \
  --name yinyun --restart unless-stopped \
  -e LX_USER_admin=你的强密码 \
  -e CONFIG_PATH=/server/data/config.js \
  liqman/yinyun-lxserver:latest

查看首次启动生成的管理员随机密码：

docker logs yinyun | grep "管理员初始密码"

也可以在启动前用环境变量预置账号，例如 -e LX_USER_admin=你的强密码。

⁠💾 数据持久化

用户数据（data）、日志（logs）、缓存（cache）、音乐文件（music）、下载（downloads）均为挂载目录，容器重建不会丢失。配置文件 config.js 默认保存在 ./data/config.js，更新镜像或重建容器后无需重新配置 Telegram / 企业微信等机器人；如需宿主机直接管理配置，可设置 CONFIG_PATH=/server/config.js 并挂载 ./config.js:/server/config.js（先 cp config.example.js config.js）。

⁠⚠️ 版权与法律声明

本项目仅从互联网公开接口收集音乐信息（元数据：曲名、歌手、歌词、试听链接等），用于搜索、展示与在线播放；本项目不存储、不复制、不分发任何受版权保护的音乐音频文件，也不内置任何音乐源。实际音频播放由使用者自行配置的自定义音源 / 在线链接提供，本项目对使用者产生的任何数据不承担所有权与法律责任。

请使用者遵守当地法律法规，及时清理使用过程中产生的临时数据，不得将本项目用于商业用途或任何侵权用途。

English: Yinyun (Lite) is a self-hosted music server with a web player and Subsonic support. It only collects public metadata from the internet and does not store or distribute any copyrighted music files. All online audio comes from user-configured custom sources. Use at your own risk and comply with local laws.