仪表盘

服务器运行中
GitHub

你好，管理员 👋

欢迎回到 LX Sync Server 管理控制台

用户总数

0

在线设备

0

CPU 负载

系统 / 服务
0% / 0%

- Cores

内存占用

系统 / 服务
0% / 0%

0 MB

运行时间

WebDAV 就绪

0h

已加载音源: - 个

CPU 实时负载波动
计算核心监控中
系统 0% 本服务 0%
内存实时占用走势
物理内存与 RSS 分配
系统 0% 本服务 0%

快速操作

常用功能
用户名
密码
状态
操作
选择用户

基本配置

服务器核心参数设置

启用 DEBUG 模式 开发人员使用（输出音源详细日志与调试信息）

代理配置

反向代理与出站代理设置

启用反向代理支持 Forwarded Headers
启用 API 服务端代理 服务端获取歌词/热搜/歌单等将通过此代理发出
支持 http:// 或 socks5://
未单独配置时，三类都沿用上面的统一代理

前端访问配置

管理控制台与播放器密码

启用 Web 播放器密码 开启后访问播放器需要验证密码

自定义歌曲目录

配置服务器存放本地音频文件的目录

启用自定义歌曲目录 开启后将优先使用自定义目录加载与存放歌曲
💡 目录配置说明

不同系统路径结构参考：

  • Windows: D:/Music 或 C:\Users\Username\Music
  • Linux / macOS: /home/user/music 或 /var/music
  • Docker: 需先挂载容器目录，如 /app/music
配置文件参考路径 (config.js):
--

WebDAV 同步配置

云端数据同步与定时备份

启用 WebDAV 同步服务 开启或关闭 WebDAV 云端数据同步与自动备份

备份与恢复

歌单数据快照与本地配置备份设置

用户歌单数据保留的历史快照份数，超限自动清理
启用本地配置备份 每日生成一份 config.js 副本，按保留天数自动清理
默认 7 天
相对路径基于 data 目录，绝对路径直接使用
额外快照存储路径，按用户名自动隔离；相对路径基于 data 目录，绝对路径直接使用。保存后即时热生效并自动迁移历史快照
💡 如何填写路径？
① 直接留空：
留空不填即使用默认位置，自动存到服务端自带的 data 目录下（如 data/backups/ 和 data/用户/list/snapshot/）。
② 填相对路径：
只填文件夹名即可。例如填 my_backups，实际就会保存在 data/my_backups/。
③ 填绝对路径：
• Windows: 填盘符完整路径，如 D:\LX_Backup 或 D:/LX_Backup
• Linux / macOS / Docker: 填完整路径，如 /data/lx_backup
当前服务器数据目录位置：
--

用户路径配置

连接 URL 与鉴权模式

启用根路径 连接 URL 即为根路径，不允许不同用户使用相同密码
启用用户路径 连接 URL 需包含 /用户名 路径，允许不同用户使用相同密码

访问路径配置

自定义管理界面与播放器的 URL 路径，保存后立刻生效

以 / 开头，留空表示根路径。不能和播放器路径相同，不能以 /api 开头。
以 / 开头，留空或输入 / 表示根路径。不能和后台路径相同，不能以 /api 开头。

权限与缓存限制

针对公开用户与普通登录用户的权限管控

开启公开用户限制 开启后，未验证的公开用户将被限制核心缓存设置与公开音源查看管理
开启公开收藏和歌曲 开启后允许登陆管理员的情况下对公开用户创建公开收藏与本地音乐歌单文件（说明：只有登录管理员后才可以管理收藏歌单和本地歌单）
开启登录用户缓存限制 开启后，所有非管理员登录用户将被限制核心缓存设置（不影响音源管理）
开启缓存空间限制 开启后，当缓存总量超出限制时将按时间顺序（LRU）自动清理最旧文件
允许 VM 模式运行脚本 允许某些需要原生 VM 模式运行以突破沙盒限制的自定义音源脚本（如部分混淆脚本）。警告：原生 VM 模式不具备沙盒安全性，可能导致服务器被执行任意系统命令，请仅在信任脚本来源时开启。

Subsonic 协议配置

启用后支持第三方 Subsonic 客户端（如 PlaySub, Symfonium）

启用 Subsonic 服务 允许 Subsonic 客户端连接并同步歌单
Subsonic 调试日志模式 开启后将在服务器控制台中实时打印所有客户端发起的 Subsonic 请求与缺失接口提示
Subsonic API 默认路径为 /rest。修改后需在客户端同步更新 URL
启用 Subsonic 独立监听端口 与主端口同时生效。主端口用于网页端与管理后台，此端口仅暴露纯净 Subsonic API（严格鉴权且非 API 请求返回空 404），适合反代、公网穿透或防火墙单独放行
启用 Subsonic 公开排行榜歌单 将在线排行榜（如飙升榜、热歌榜、新歌榜等）映射为 Subsonic 只读虚拟歌单
开启全网在线搜索 允许 Subsonic 客户端在搜索歌曲时检索全网音乐 API
网易云 (wy) QQ 音乐 (tx) 酷我音乐 (kw) 酷狗音乐 (kg) 咪咕音乐 (mg)
点击标签快速启用/停用对应平台搜索
开启歌词翻译支持 允许在 Subsonic 歌词响应中包含翻译文本（原文在上，翻译在下）
播放时触发服务器缓存 通过 Subsonic 播放的曲目在后台自动落盘到该用户缓存目录，已缓存自动跳过（注意可能产生较大流量）
服务器存在缓存优先播放 通过 Subsonic 播放曲目时，若服务器已存在该歌曲缓存或下载文件，直接通过本地传输，避免请求源站
💡 Subsonic 客户端搜索：直接输入歌曲名时使用上方“默认在线搜索模式”。也可在搜索框中使用以下前缀：
• all:歌名 / online:歌名：搜索全部已启用在线平台
• local:歌名：只搜索本地歌单
• wy:歌名、tx:歌名、kw:歌名、kg:歌名、mg:歌名：指定网易、QQ、酷我、酷狗或咪咕
客户端支持音乐目录时，也可选择“全部在线平台”或单个平台目录后再搜索。同时间戳歌词顺序为原文在上，翻译在下。
设置歌手详情、头像及简介的获取来源优先级
不喜欢 / 评分联动 (Subsonic)
Subsonic 客户端打低星时写回原生 dislike 规则的阈值；0 关闭整条联动
在列表中隐藏 dislike 歌曲 命中不喜欢规则的歌曲从专辑/歌单/搜索等列表中剔除；关闭则仅以评分体现
dislike 跨平台同名命中 开启后同名不同歌手/专辑也会被一并屏蔽（有误伤风险）
推荐类接口排除 dislike 每日推荐/随机/相似歌曲中排除 dislike 命中歌曲（与隐藏列表独立）
歌曲与专辑维度多歌手时，dislike 规则命中的判定方式（合唱歌曲与专辑歌手集合统一按此处理）
歌名去版本后缀归一化 「晴天 (Live)」也能命中「晴天」规则（代价：少数仅差后缀的不同歌曲会误并）
要求歌手同时匹配 歌曲/专辑级别都要求歌手匹配，避免不同歌手同名歌曲被一起屏蔽
评星 → 不喜欢 自动联动 Subsonic 客户端打低星时写回原生 dislike 规则；关闭则评分仅记录、不触碰不喜欢
不喜欢 → 评星 自动联动 网页端/Subsonic 点「不喜欢」回写客户端评分（低星）；关闭则不喜欢仅写入规则、不回写评星
音质 / 源优选 (Subsonic)
音质优选总开关 按优先级主动选最优可用音质；关闭则 stream 仅单次解析
拖拽可调整优先顺序；点击 ✕ 可停用/置底变灰（再次点击即可重新启用）
客户端声明最大码率时的取舍策略
拖拽可调整优先顺序；点击 ✕ 可停用/置底变灰（客户端所选源始终最优先）
允许跨平台优选 按歌名+歌手在其它平台搜索替身
同源切换其它自定义源 callUserApiGetMusicUrl 内部循环同平台候选脚本
配置修改后需要保存方可生效，部分配置需重启服务器
云端存储协同 支持全量快照归档与跨端增量同步
本地离线备份 支持一键打包下载到电脑本地或从离线压缩包还原

同步状态与健康度

实时监控中

暂无同步数据

同步日志

实时推送

暂无日志

system.log
最新 200 行

备份与恢复管理

集中管理系统配置文件历史备份与各用户歌单数据快照，保障数据安全与即时回滚。

自动备份模式
已开启 (每日自动)
自动保留天数
7 天
备份保存目录
backups
备份时间
备份文件 / 类型
大小
操作
管理各用户空间生成的歌单同步历史快照
选择用户
创建时间
快照 ID
大小
操作
加载中...

点击检查服务器是否有新版本发布