xcq0607/lxserver

LX Music Sync Server (Enhanced Edition)

!lxserver

https://github.com/XCQ0607/lxserver

---

本项目内置了一个功能强大的 Web 播放器，让你可以随时随地在浏览器中享受音乐。同时，它也是一个增强版的 https://github.com/lyswhut/lx-music-desktop 数据同步服务端，支持多端同步、自定义源、以及 Subsonic 协议。

⚠️ 注意：本页面仅包含 Docker 部署说明。**查看详细功能截图、详细配置文档及更新日志，请跳转至 https://github.com/XCQ0607/lxserver**%E3%80%82

---

✨ 核心特性

• 现代化 Web 播放器：支持深色模式、多套皮肤（森之韵、深海鲨等）、移动端深度优化。
• 多源聚合搜索：支持各大音乐平台资源搜索与播放，支持导入自定义源脚本。
• 全平台数据同步：完美适配 LX Music 桌面端与移动端的数据同步需求。
• Subsonic 协议适配：支持使用音流、Feishin 等第三方 Subsonic 客户端连接播放。
• 全自动化缓存：内置缓存系统，自动保存歌词、链接及歌曲文件，支持颗粒化管理。
• 歌词卡片分享：支持生成精美歌词海报，支持多种比例与风格定制。
• 访问控制：支持设置播放器访问密码，提供详尽的管理员/用户权限矩阵。

---

🚀 快速启动 (Docker)

方式一：Docker Run (命令行)

bash
docker run -d \
  -p 9527:9527 \
  -v $(pwd)/data:/server/data \
  -v $(pwd)/logs:/server/logs \
  -v $(pwd)/cache:/server/cache \
  -v $(pwd)/music:/server/music \
  --name lx-sync-server \
  --restart unless-stopped \
  xcq0607/lxserver:latest

方式二：Docker Compose (推荐)

新建 docker-compose.yml 文件：

yaml
version: '3'
services:
  lx-sync-server:
    image: xcq0607/lxserver:latest
    container_name: lx-sync-server
    restart: unless-stopped
    ports:
      - "9527:9527"
    volumes:
      - ./data:/server/data
      - ./logs:/server/logs
      - ./cache:/server/cache
      - ./music:/server/music
    environment:
      - NODE_ENV=production
      # - FRONTEND_PASSWORD=123456         # 管理后台密码
      # - ENABLE_WEBPLAYER_AUTH=true        # 是否启用 Web 播放器访问密码
      # - WEBPLAYER_PASSWORD=yourpassword  # Web 播放器访问密码

访问说明

• Web 播放器: http://your-ip:9527/music (默认路径，可通过 PLAYER_PATH 修改)
• 同步管理后台: http://your-ip:9527 (默认路径，可通过 ADMIN_PATH 修改，默认密码: 123456)

---

⚙️ 关键配置说明 (环境变量)

你可以通过环境变量快速调整服务配置，无需手动修改配置文件。环境变量优先级最高：

---

📂 卷映射 (Volumes)

为了确保你的数据在镜像更新或容器重启后不会丢失，请务必映射以下目录：

• /server/data: 存放同步快照、用户信息和系统设置核心数据。
• /server/logs: 存放系统运行日志。
• /server/cache: 存放 Web 播放器的自动化缓存文件（音频、歌词等）。
• /server/music: 映射你的本地音乐库目录。

---

🛡️ 数据收集与隐私说明

本项目集成了 PostHog ***数据统计，主要用于：

1. Bug 追踪: 收集版本号、环境类型。
2. 通知推送: 弹出版本更新提醒与紧急维护公告。

• 绝对***: 绝不收集 IP、用户名或具体歌单内容。
• 关闭方法: 环境变量设置 DISABLE_TELEMETRY=true。注意：关闭后将无法收到新版本通知。

🤝 贡献与致谢

• 修改自 https://github.com/lyswhut/lx-music-sync-server%E3%80%82
• Web 播放器逻辑参考 https://github.com/lyswhut/lx-music-desktop%E3%80%82
• 基于 Apache License 2.0 协议开源。

更多详情、功能截图及高级配置，请访问 GitHub 仓库：https://github.com/XCQ0607/lxserver

📄 开源协议

本项目基于 Apache License 2.0 许可证发行，以下协议是对于 Apache License 2.0 的补充，如有冲突，以以下协议为准。

Apache License 2.0 copyright (c) 2026 https://github.com/xcq0607

词语约定：本协议中的“本项目”指 LX Music Web 播放器；“使用者”指签署本协议的使用者；“官方音乐平台”指对本项目内置的包括酷我、酷狗、咪咕等音乐源的官方平台统称；“版权数据”指包括但不限于图像、音频、名字等在内的他人拥有所属版权的数据。

一、数据来源

1. 官方平台: 本项目的各官方平台在线数据来源原理是从其公开服务器中拉取数据，经过对数据简单地筛选与合并后进行展示(与未登录状态在官方APP获取的数据相同)，因此本项目不对数据的合法性、准确性负责。
2. 音频数据: 本项目本身没有获取某个音频数据的能力，所使用的在线音频数据来源来自设置内“自定义源”所选择的“源”返回的在线链接。本项目无法校验其准确性，使用过程中可能会出现播放异常。
3. 其他数据: 本项目的非官方平台数据（例如“我的列表”内列表）来自服务器存储数据，本项目不对这些数据的合法性、准确性负责。

二、免责声明

1. 版权数据: 使用本项目的过程中可能会产生版权数据。对于这些版权数据，本项目不拥有它们的所有权。为了避免侵权，使用者务必在 24 小时内 清除使用本项目的过程中所产生的版权数据。
2. 责任承担: 由于使用本项目产生的包括由于本协议或由于使用或无法使用本项目而引起的任何性质的任何直接、间接、特殊、偶然或结果性损害由使用者负责。
3. ***: 本项目完全免费，且开源发布于 GitHub 面向全世界人用作对技术的学习交流。禁止在违反当地的情况下使用本项目。对于使用者在明知或不知当地不允许的情况下使用本项目所造成的任何违法违规行为由使用者承担。

三、其他

1. 资源使用: 本项目内使用的部分包括但不限于字体、图片等资源来源于互联网。如果出现侵权可联系本项目移除。
2. 非商业性质: 本项目仅用于对技术可行性的探索及研究，不接受任何商业（包括但不限于广告等）合作及***。
3. 接受协议: 若你使用了本项目，即代表你接受本协议。