下载歌曲与资料包
使用自备音源把新歌曲下载到独立目录,或通过资料包复用已整理的信息。两条路径都保留明确的范围、预览和后台处理结果。
两条加歌路径怎么选
Section titled “两条加歌路径怎么选”| 路径 | 适合情况 | 结果 |
|---|---|---|
| 添加目录 / WebDAV 并扫描 | 已经有自己的媒体文件 | 读取文件名建立索引,不复制原媒体 |
| 下载歌曲 | 有自备可用音源,准备新增媒体 | 下载到指定本地可写目录,逐曲入库 |
| 导入资料包 | 另一处已整理相同曲库,希望复用资料 | 预览位置映射与资料,确认后复用,不是整库媒体迁移 |
设置独立的下载位置
Section titled “设置独立的下载位置”“加歌 → 下载歌曲”需先绑定一个本地媒体库作为下载保存位置,也可在本地来源表单勾选“用于保存洛雪下载”。WebDAV 不能作为下载位置,全局只绑定一个目录。
- 准备后端可见的真实本地目录,Docker 默认提供
/downloads持久卷。 - 在“歌曲来源”新增本地媒体库并选择该目录,按页面设置下载用途。
- 保存时服务端会实际创建并删除临时文件验证权限;需允许业务 UID/GID
10001:10001写入与遍历。 - 原来的
/media歌库继续保持只读;宿主 NAS 目录需要部署者提前挂载并配置权限。
有未完成下载批次时,不能清除绑定、修改目录或移除该媒体库;先完成或取消任务。更换位置只影响未来任务,不移动原文件。
导入并启用自备音源
Section titled “导入并启用自备音源”管理音源可导入 UTF-8 .js 文件(最大 9 MB)或公网 HTTPS 链接,支持 LX 2.0 GoScript。可保存多份,启用一份;兼容模式默认 mobile,确需桌面环境的脚本选择 desktop。
应用不内置音源。初始化测试通过,只证明脚本初始化及能力声明成功,不能保证每首歌、每种音质可下载。音源正文与导入地址加密保存,不回显原密钥。
基础下载由 Go 执行,不依赖计算节点。音乐平台资料匹配与下载音源是两套配置,启用元数据平台不会自动获得下载能力。
搜索、歌单与专辑预览
Section titled “搜索、歌单与专辑预览”- 搜索歌曲,或输入支持的公开歌单、专辑入口,等待真实目录结果。
- 核对平台、歌手、版本与已读取数量;平台只公开部分歌曲时,不把部分结果当整张歌单。
- “选择已读取歌曲”只选择当前已读且尚未下载的曲目。
- 确认数量、保存位置、音源与音质,再提交下载。
当前目录适配覆盖网易云、QQ、酷狗、酷我、咪咕,实际可选平台与音质取决于自备音源声明。自动音质按声明从高到低解析,明确不可用才尝试下一档;手动音质失败不会静默降级。
下载进度、取消和恢复
Section titled “下载进度、取消和恢复”下载在后台执行,最多两首同时传输,刷新或离开网页不会取消。记录按排队、解析、传输、发布、入库及失败展示,不要在发布阶段把字节 100% 当作已入库。
- 每首音频上限 512 MiB、总传输时间 5 分钟;格式结构校验不等于音质鉴定或完整解码。
- 先写私有临时目录,完整后按“歌手 - 歌名”发布;同名追加标识,不覆盖原文件。
- 尝试保存同名 LRC 与静态封面,附件失败不阻止音频入库,记录保留提示。
- 取消可处理排队、解析和传输中项目,正在发布的完整文件会完成入库。
- 重启后排队项继续,未完成传输标记中断,发布阶段核对后补入库;失败或中断可按页面重试。
- 任务中心提供批次概览,取消、重试和查看歌曲回到下载记录执行。
导出与导入曲库资料包
Section titled “导出与导入曲库资料包”资料包用于复用已经整理的歌名、歌手、封面、歌词等共享资料,原始音视频仍由自己的目录或 WebDAV 提供。它不是账号、数据库、主密钥或整套 NAS 备份。
- 从来源的资料包功能导出并保存整套文件,保留所有分包。
- 接收方准备实际可访问的对应媒体来源,选择导入完整 ZIP。
- 等待上传、校验与路径预览,核对相对目录和文件大小,再显式确认。
- 导入后抽查歌曲、附件及媒体可播放情况,有差异时先核对映射,不要直接覆盖人工资料。
新建 WebDAV 时可勾选“从已导出的资料包入库”,主操作变为“保存并导入资料包”。来源先按不扫描、不自动提取、不定时扫描保存,上传成功后进入预览与确认;失败可复用已建来源重试。
资料包限制与冲突
Section titled “资料包限制与冲突”- 导出按每片最多 5000 条歌曲记录及 32 MiB 预算拆分;完整上传最多 8 GiB,按页面选择完整文件。
- 上传、预览和确认是不同步骤;仅上传成功不等于资料已生效。
- 已有本机人工设置或明确清空的决定不会被共享更新直接覆盖。
- 只核验目录与大小不等于媒体内容逐字节相同;版本不一致时应人工抽查。
- 反向代理需允许对应大小的上传及足够处理时间,失败后先查业务提示与代理限制。