搜索音乐
00:00
用户名
class="t-text-muted hover:t-text-muted transition-colors" title="GitHub">
v1.0.0 Web
已选择: 0 首
#
歌曲标题
歌手
专辑
时长
操作
操作
输入关键词开始搜索音乐
第 1 / 1
页
选择分类
正在加载歌单...
第 1 页
歌单详情
加载中...
已选择: 0 首
#
歌曲
歌手
专辑
时长
操作
请选择榜单
榜单列表
已选择:
0 首
#
歌曲
歌手
专辑
时长
操作
请从左侧选择一个榜单
第 1
页
开启云端收藏之旅
您的收藏暂时无法同步。请前往设置页面登录，同步您的LX MUSIC歌单，享受跨设备的一致体验。
本地音乐
共 0 首
已选择: 0 首
#
歌曲
歌手
专辑
来源/信息
操作
正在加载本地音乐...
第 1 / 1 页
设置
源与基础设置
管理员权限
登录后可管理自定义源和管理员专属设置。
管理员自定义源管理
开启版权显示 控制页脚中的访问量、更新日期和版权信息显示，仅管理员可见此设置。
显示页脚访问量、当日更新日期和版权文案。
暂无数据 (JS未加载)
启用公开源 开启后，您上传的自定义源将可以被其他用户在公共源列表中看到。
默认音质 实际播放音质取决于歌曲支持的最高音质，系统会自动降级
当前音质：无损音质
每页显示数量 设置搜索和列表页面每页显示的记录数量
默认入口 设置页面刷新时默认显示的Tab页面
网络设置
播放音乐代理
通过服务器端代理解析和播放音乐，有效解决部分源的
IP
限制问题。
下载音乐代理
通过服务器端代理执行音乐下载操作。
自动代理
自动检测链接兼容性。若检测到跨域限制
(CORS)、HTTPS 混合内容报错或链接失效，将自动启用服务器代理解析，确保播放成功。
自定义代理
开启后，当自动代理触发时，将优先使用您填写的自定义代理地址（客户端直接请求），而非服务器中转。
URL 格式示例：
其中
URL 格式示例：
https://proxy.example.com/{url}其中
{url}
将被替换为原始音乐链接（不编码）。需同时开启"自动代理"才生效。
使用 {url}
作为原始链接占位符，将被直接替换为原始音乐 URL（不编码）。
缓存并发量
控制本地与云端同时执行的任务数量（建议
3-5）。
数据同步
请输入 LX Music 桌面端或移动端的连接信息
状态: 未连接
启用 Token 认证
API 访问凭证管理自动更新
自动更新网络歌单
开启后，点击进入网络歌单时将自动尝试同步远端内容。注意：此操作可能会覆盖本地对该歌单的修改。
网络歌单自动检测间隔
输入值示例：30m / 6h / 1d，开启后自动检测并标记已更新歌单。
检查所有歌单更新
手动触发一次网络歌单更新检测，结果会在侧边栏中显示。
自动同步账号设置到文件
保存当前账号的设置（音质、源选择等）到服务器端用户配置目录，实现多端自动同步。注意：未登录状态下，该设置无效，账号设置将保存在浏览器缓存。
手动将当前所有 UI 设置（包含音质、音效等）缓存并保存至服务器对应用户的对应json文件中。
本地缓存与重置
缓存歌词
开启后，应用会自动缓存已加载的歌词。
缓存歌曲链接
优先使用缓存链接播放，失效时系统会自动尝试重新获取并更新缓存。
缓存歌曲文件
将歌曲文件永久缓存到服务器存储。再次播放时无需消耗外部流量，极大提升加载速度。
缓存歌词文件
将歌词文件缓存到同服务器配置的缓存目录下，优先供多端同步极速加载。
下载时嵌入歌词
开启后，下载或缓存歌曲时将自动获取歌词并写入音频文件标签（USLT），同时保存
.lrc 文件。支持浏览器下载与服务器缓存两种模式。
优先播放缓存歌曲
如果歌曲已缓存，则优先从本地加载。即使“缓存歌曲文件”关闭，已存在的缓存仍可使用。
仅下载模式
未开启时下载到
/server/cache/用户名 (或
/server/data/cache/)；
开启后下载到 /server/music/用户名 (或 /server/data/music/)。
开启后下载到 /server/music/用户名 (或 /server/data/music/)。
启用歌曲洗版
将下载目录内已有歌曲替换为指定音质。该功能不处理缓存目录。
风险提示
洗版会替换下载目录中的原音频文件，请先备份重要文件。缓存目录不会参与处理；新文件下载或写入失败时会保留原文件。目标音质不可用时可能降级，结果中会标明实际音质。
缓存歌曲位置
设置服务器端存储缓存文件的具体路径。
歌曲命名方式
设置服务端存储文件的命名规则（对标准缓存和仅下载模式均生效）。不影响已有文件。
优先级: 本地文件 > 链接缓存 > 在线获取 (自动缓存)
浏览器存储占用
当前浏览器 localStorage 及 IndexedDB
(歌单数据)
已使用空间。
0
KB
服务器缓存占用
已缓存在服务器端的歌曲文件和歌词文件总占用空间。
正在统计音乐...
正在统计缓存...
外观设置
主题风格
界面与布局
自动精简控制栏
(仅手机版) 进入歌词界面自动精简播放栏，关闭界面时自动恢复展开。
*
提示：长按播放键可手动切换。
展示侧边栏封面/标题 是否在屏幕左下角展示当前播放歌曲的封面和名称 (仅在电脑版生效)。屏幕太窄时自动隐藏。
热搜显示数量
设置搜索页面显示的热门搜索词数量 (0-50，设置为0关闭显示)
*
实际数量取决于源，可能少于设置值
播放背景与视觉特效
歌曲播放页背景 设置歌曲播放详情页背景的显示风格
底部播放栏 控制播放栏上方的实时波形显示。
详情页背景 歌词详情页（全屏模式）下的背景视觉特效。
渲染风格
设置全局视觉特效的渲染方式。
※
此风格主要影响条形阵列和频率脉冲效果。
全局透明度
0.5
歌词显示设置
歌词字体大小 设置播放详情页歌词显示的大小 (单位: rem)
1.2
歌词荧光效果 为当前播放的歌词添加荧光发光效果。
歌词实时滚动 开启后歌词会自动滚动到当前播放行；关闭后只同步高亮，不自动滚动。低配置电脑无需勾选。
低配置电脑无需勾选
自动朗读歌词 开启后会跟随当前歌词行自动朗读。普通用户也可以直接使用。
显示歌词翻译 如果歌曲有翻译，则在原词下方显示。
显示歌词罗马音 如果歌曲有罗马音，则在原词下方显示。
交换翻译与罗马音位置 开启后，罗马音将显示在翻译上方。
歌词字体 设置歌词显示的字体 (支持本地安装的字体，如 'SimHei', 'Microsoft YaHei')
字体预览
0123456789
The Quick Brown Fox Jumps Over The Lazy Dog
落霞与孤鹜齐飞，秋水共长天一色
播放逻辑
播放队列与列表
播放搜索歌曲时切换歌单
开启：播放搜索出的歌曲后，播放列表切换为搜索结果。
关闭：播放搜索出的歌曲后，播放列表切换为默认列表。
*
提示：所有搜索到的歌曲播放时都会自动加入默认列表
本地列表播放去重 当播放本地音乐（列表）时，若存在同 ID 但音质不同的歌曲文件，仅保留最高音质版本。说明有相同id歌曲，只播放最高音质歌曲。
播放歌单/排行榜歌曲时切换歌单
开启：播放歌单或排行榜中的单个歌曲后，播放列表切换为对应列表。
关闭：播放歌单或排行榜中的单个歌曲后，保持当前播放队列不变。
*
提示：所有歌单/排行榜歌曲播放时会自动加入默认列表
播放体验强化
音乐预读机制
开启：在一首歌曲开始播放时，系统将自动在后台预解析并读取下一首歌曲的播放内容。预读过程中会自动跳过无法播放的歌曲。
*
极大提升移动端后台播放的连续性，但可能会产生少量额外流量。
自动恢复进度 自动恢复最后播放的歌曲、进度及列表。会自动跳转到上次对应的歌单选项卡。
音频淡入淡出 切换歌曲时，音量平滑淡出和淡入，减少切换的突兀感。
保持屏幕常亮 防止由于系统自动息屏导致的播放中断，兼容绝大多数移动端设备。
播放失败处理策略
自动尝试降低音质
开启：当前音质解析失败，自动尝试查找并解析较低音质的版本。
关闭：不尝试降级音质。
自动切换平台
根据“歌名+歌手+时长”在全网精准匹配同名歌曲尝试播放。
*
开启：自动搜索其他平台备选源 |
关闭：当前平台源失效即报错
自动尝试换源
每次解析音频链接时，若当前的自定义解析脚本失败，是否自动尝试使用其他支持该平台的自定义源解析。
*
开启：依次尝试其他解析脚本 |
关闭：首个解析脚本失效即报错
失败自动下一首
当前歌曲播放失败后自动播放下一曲。
*
开启：自动尝试下一首 |
关闭：暂停播放
播放失败策略优先级
依次尝试失败恢复逻辑的优先级顺序，关闭的策略逻辑会被自动跳过。
*
切换平台 -> 降低音质：优先切换一次平台（仅一次），后续音质降级将在新平台执行。
降低音质 -> 切换平台：原平台所有音质均解析失败后，切换至新平台并读取偏好音质尝试解析一次，若再次失败则直接播放下一首。
系统交互与外设
SMTC 歌词显示
将当前播放的歌词行实时写入系统媒体控制 (SMTC/MediaSession) 的标题字段，使
Windows
任务栏、系统通知中心等能同步显示当前歌词。
* 原理：利用
Web Media
Session API 高频更新
metadata.title
为当前歌词行，标题会随歌词进度自动滚动。
关闭后恢复显示原始歌曲名称。
按键快捷方式 启用后可使用键盘快捷键控制音乐播放（仅电脑版）。
播放/暂停
Space
上一曲/下一曲
[
/ ]
音量加/减
↑
/ ↓
快进/后退
→
/ ←Hold
for smooth seek
切换页签
Alt
+ 1-6
歌词页开关
L
显示底部波形
F
显示详情波形
G
服务器缓存
H
下载管理
J
系统日志
暂无日志...
* 显示系统启动后的 Console 输出
正在加载评论...