github XCQ0607/lxserver v2.1.3
LX Music Sync Server v2.1.3

latest releases: v2.2.0, v2.1.4
one month ago

v2.1.3 (2026-10-13)

🌟 新增功能与体验升级

  • Web 登录界面全新重构与体验升级:
    • 拟物微质感设计与灵动动效: 登录页 UI 全面重构,采用拟物毛玻璃卡片、自适应布局与深浅主题切换,并新增灵动音乐粒子动态背景。
    • 多模式登录与会话保持: 支持「用户账号登录」与「播放器访问密码」双模式切换;优化移动端及 Safari 等浏览器的登录状态保持与掉线静默恢复。
    • 全新登录界面与动态音乐粒子
  • 后台管理登录 UI 全新重构与视觉体验升级:
    • 灵动极光动效与星尘粒子: 后台管理登录界面(/admin)全面重构升级,引入极光流转光斑、微质感网格遮罩、动态星尘粒子 Canvas 与光标跟随发光效果,搭配毛玻璃卡片与密码显隐切换,视觉风格与 Web 播放器完美呼应。
    • 后台管理登录界面全新升级
  • 支持自定义 Web 播放器与后台管理登录页标题与名称:
    • 独立定制与多端协同: 新增「播放器名称」(player.name / PLAYER_NAME,默认 LX Music Web)与「同步服务名称」(serverName / SERVER_NAME,默认 LX Sync Server)双重独立配置。
    • 可视化设置与即时生效: 管理员可在后台管理控制台「前端访问配置」中可视化修改,配置将自动同步至浏览器标签页标题及登录卡片大标题,支持环境变量与配置文件持久化。
    • 前端访问配置支持自定义播放器与服务名称
  • 配置项命名规范化与迁移:
    • 原 FRONTEND_PASSWORD(环境变量)与 frontend.password(配置项)正式更名/迁移为 ADMIN_PASSWORD 与 admin.password,语义更加清晰准确,专门指代后台管理控制台与管理员权限密码。
  • Web 登录与本地歌单自动同步打通 (#422 @pokemonred06-creator):
    • 网页端完成账号登录后自动激活本地歌单同步,无需再手动二次填写账号密码即可实时同步云端与本地歌单。
  • 缓存存储位置与歌曲命名规则支持分用户独立配置:
    • 缓存存储位置与歌曲命名规则改为按用户独立保存与隔离,不同用户互不干扰。
    • 文件批量重命名严格限制在当前操作用户的音乐与缓存文件夹内,并完整保留歌单分类目录结构。
  • 服务端缓存生命周期配置与自动清理(#422 @pokemonred06-creator):
    • 新增缓存保留天数配置(默认 14 天,设为 0 为永久保留),后台定时自动清理超期未访问的音频与歌词文件。
  • 缓存与下载文件生命周期与状态归属优化 (#424 @jiyuchen1):
    • 歌曲转为下载或下载完成后自动清理临时缓存,避免同一首歌曲重复占用磁盘空间。
    • 播放与读取优先使用下载目录中的文件,播放底栏和状态精确区分显示【已下载】与【缓存】。
  • 未引用歌词清理与管理 (#424 @jiyuchen1):
    • 优化歌词落盘对齐机制,并在缓存管理面板中提供「清理未引用歌词」功能,支持一键安全清理无引用的孤儿歌词。
  • 前端服务器文件状态统一标注与下载联动 (#424 @jiyuchen1):
    • 搜索列表、歌单及下载弹窗中实时标注歌曲的服务器状态(如“已缓存”、“已下载”),对已缓存歌曲点击下载时可直接在服务端快速转入下载目录,无需重新向外网请求。
    • 统一音乐源、音质与服务器状态徽标样式,优化手机窄屏下的显示排版。
  • 单源搜索全量取回与纯前端分页 (#424 @jiyuchen1):
    • 单源搜索一次性获取全量检索结果,前端转为本地纯前端分页,大幅提升翻页流畅度并避免翻页错乱。
  • 移动端播放体验与车载蓝牙封面交互升级 (#428 @pokemonred06-creator):
    • 车载蓝牙 (AVRCP 1.6+ BIP) 封面与 MediaSession 规范化: 补齐高分辨率 512×512 PNG 位图图标,针对蓝牙 AVRCP BIP 协议仅支持栅格位图(不支持 SVG)的特性,在回退或缺省时使用 PNG 格式并动态输出对应 MIME 类型;在播放连接建立后多重同步元数据,彻底解决车载屏幕封面黑屏或无法显示的问题。
    • 移动端歌词详情页退出与手势交互优化: 歌词详情页右上角新增显式常亮的关闭/返回按钮,并支持在歌词顶部向下滑动顺畅收起歌词详情页;底部播放栏封面支持点击直达歌词。
    • 原生 WebKit AirPlay 投播权限支持: <audio> 播放器标签新增 x-webkit-airplay="allow" 属性,支持原生隔空播放。
  • 版本更新与系统通知弹窗支持结构化要点与富文本渲染:
    • 通知引擎重构日志排版,更新要点自动解析为数字微徽章与结构化条目卡片,支持标题加粗、分类标签、轻量 Markdown 及微型美化滚动条。
  • 支持「禁用预读跳过」选项:
    • 在设置「播放体验强化」中新增「禁用预读跳过」开关(默认关闭)。开启后,当后台音乐预读失败时不会自动将歌曲标记为不可播放并跳过,轮到该歌曲时依然会在前台尝试完整解析、多源轮询与降级恢复。
    • 禁用预读跳过设置
  • 歌单详情页大窗与吸顶小窗(Mini Bar)交互体验升级:
    • 沉浸式 Hero 卡片(大窗): 歌单详情页重构为与歌手/专辑页统一的现代 Hero 卡片风格,内置绝对定位快捷返回、独立心形收藏状态联动、大封面悬浮播放全部、平台徽标与完整元数据展示。
    • 吸顶浮动 Mini Bar(小窗)与平滑滚动联动: 浏览歌单长列表下滑时,大窗平滑收起并无缝唤出吸顶 Mini Bar,集成微缩封面、歌单信息、播放全部、收藏及【展开/顶部】智能切换按钮,大幅提升长列表浏览与操作效率。
    • 歌单详情页吸顶小窗 Mini Bar 交互

🐛 缺陷修复与稳定性提升

  • 自定义音源试听片段与 404 失效链接自动拦截及多源故障转移 (#428 @pokemonred06-creator):
    • 针对部分自定义音源在遭遇 VIP 或下架歌曲时不会报错、而是返回 30s/35s 试听片段(如网易云 jd-musicrep-ts、QQ音乐 /rs02、包含 trial 的试听直链)或 404 错误页面的缺陷,新增 validateReturnedMusicUrl 校验机制。
    • 快速识别并拦截试听直链与失效地址,主动触发多音源故障转移(Failover),自动尝试后续候选音源解析完整歌曲,杜绝将 30 秒片段透传给前端播放。
  • 音频缓存防投毒与时长完整性校验机制 (#428 @pokemonred06-creator):
    • 下载时长与特征比对: 服务端下载音频时增加真实物理时长与歌曲元数据时长比对;若歌曲预期时长大于 60 秒但实际音频为短片段/试听音频(或异常过小),坚决拒绝写入永久缓存并安全删除临时文件,防止缓存被试听残片污染。
    • 异常缓存自动清理与重新回源: 在读取缓存时若检测到残缺试听文件,自动从索引与磁盘中剔除并重新回源拉取完整音频。
  • 移动端后台变音、音调漂移与耳机拔出防外放保护 (#428 @pokemonred06-creator):
    • 移动端原生音频通道直通: 将直通保护扩展至所有移动端设备(iOS / Android),在未开启均衡器或变调音效时跳过 Web Audio API 音频流劫持,从根源上消除锁屏或切后台导致的采样率不匹配、音调变尖/变粗及静音挂起问题;切回前台时自动守护音调一致性。
    • 耳机拔出与蓝牙断开防外放保护: 实时监听系统音频设备路由变动(devicechange),在耳机拔出或蓝牙音频断开时立即主动暂停播放并禁用断线自动恢复,杜绝在公共场所发生扬声器意外外放。
  • 修复搜索完成切换侧边栏 Tab 导致搜索结果丢失的问题:
    • 修复在搜索完成产生结果后,切换至歌单、排行榜、我的收藏、设置等其他侧边栏标签再切回搜索页时,结果丢失或重新触发网络搜索并卡在加载中的问题。
    • 切回搜索页面时自动保留并无缝恢复上次搜索的关键词、音源、搜索结果列表以及所在页码,无需重新输入或重复发起网络请求。
  • 音频后台播放变音与卡顿优化 (#422 @pokemonred06-creator):
    • 优化浏览器在后台或最小化运行时对音频的处理逻辑,解决切换到后台时部分设备出现的变调、降速或爆音问题。
  • 服务端断线重连与无缝续播守护 (#422 @pokemonred06-creator):
    • 增加弱网与断线自动重连守护,服务端临时重启或网络恢复后自动从中断处平滑续播。
  • Subsonic 协议兼容性与音源探测优化 (#422 @pokemonred06-creator):
    • 规范返回的音频文件扩展名,优化音源链接可用性探测与重定向容错。
  • 修复文件下载缓存时重定向 URL 含有特殊字符导致解析异常的问题 (#422 @pokemonred06-creator)。
  • 修复下载状态卡在处理中及部分歌曲无法下载的问题 (#423):
    • 修复浏览器端下载队列在处理 Blob 转换与多任务并发调度时可能出现状态阻塞、卡在“处理中”的问题。
    • 完善下载链接解析机制与代理兜底逻辑,修复部分歌曲在线可播但触发下载时因解析策略或跨域流拦截而下载失败的问题。
  • 修复移动端及窄屏视图下歌曲列表表头操作图标与标题文字重叠的问题 (#431):
    • 优化表头序号列与操作按钮排版,第一列专用于序号「#」并与歌曲列表精准垂直对齐,将排序、批量操作与搜索图标优雅整合至标题栏右侧,彻底解决小屏下内容挤压与文本遮挡。
  • 移动端非 PWA 视口高度与底部遮挡适配优化:
    • 视口动态高度适配 (100dvh & viewport-fit=cover): 针对 Chrome、Edge 等移动端浏览器在非 PWA 独立窗口模式下底部常驻导航栏/地址栏的问题,将页面及侧边栏视口基准从传统的 100vh 优化为 100dvh,彻底消除由于浏览器动态工具栏导致的侧边栏底部空白截断。
    • 底部安全区域与翻页条自适应对齐: 为全局搜索分页栏、排行榜分页栏与底部播放栏注入 env(safe-area-inset-bottom) 动态内边距安全区域,并在播放底栏展开/折叠时联动同步侧边栏下边距;彻底解决移动端非 PWA 下翻页按钮被浏览器底栏或系统手势指示条遮挡的问题。
  • Media Session 媒体会话控制、封面渲染与播放恢复稳定性提升 (#432 @pokemonred06-creator):
    • 播放控制与指令幂等执行: 修复系统媒体控制栏(Media Session)的播放/暂停指令未比对当前播放状态导致的逻辑反转问题,确保系统与锁屏快捷指令严格幂等。
    • 意外暂停后的错误恢复守护: 保留系统意外打断(如来电、系统音频中断)时的错误恢复监听,确保用户在恢复播放时重新挂载错误恢复能力,避免状态丢失。
    • Media Session 封面与车载渲染规范化: 通过内建下载代理中转跨17918246011101791824602639域封面,避免 Canvas 污染与跨域访问失败;统一在离屏 Canvas 居中缩放为标准 512×512 JPEG 位图(失败时优雅回退),防止尺寸或格式不符导致蓝牙车机或锁屏黑屏;增加版本锁与内存缓存,杜绝切歌时旧封面异步覆盖新歌曲,并补充专辑名 (song.meta.albumName) 读取。
    • iOS 后台保活桥接重连与打断恢复: 在音频图重建(如调节均衡器/音效)时自动重新连接 MediaStreamDestination,避免桥接断开或静音;优化切回前台(visibilitychange)时的 AudioContext 状态恢复;捕获并容忍自动播放限制(NotAllowedError),保留锚点以便后续用户手势重试。
    • 服务端缓存音频流 Range 请求与连接管理优化: 严格限制只读取缓存目录内合法普通文件,增强路径遍历安全校验;补齐 HEAD 请求支持;完整支持不区分大小写的 bytes= 范围头、后缀范围(如 bytes=-500)及单边范围,对超出文件大小的请求规范返回 416 Range Not Satisfiable;并在客户端断开或读取出错时及时销毁读取流并释放文件描述符。

  • 本次版本由 @XCQ0607 维护构建 🚀

Don't miss a new lxserver release

NewReleases is sending notifications on new releases.