跳转到内容
SingVerse

输入关键词搜索全部文档

↑ ↓ 选择Enter 打开Esc 关闭
GitHub开始部署

下载歌曲与资料包

使用自备音源把新歌曲下载到独立目录,或通过资料包复用已整理的信息。两条路径都保留明确的范围、预览和后台处理结果。

基于当前源码 · 功能以部署版本为准
路径 适合情况 结果
添加目录 / WebDAV 并扫描 已经有自己的媒体文件 读取文件名建立索引,不复制原媒体
下载歌曲 有自备可用音源,准备新增媒体 下载到指定本地可写目录,逐曲入库
导入资料包 另一处已整理相同曲库,希望复用资料 预览位置映射与资料,确认后复用,不是整库媒体迁移

“加歌 → 下载歌曲”需先绑定一个本地媒体库作为下载保存位置,也可在本地来源表单勾选“用于保存洛雪下载”。WebDAV 不能作为下载位置,全局只绑定一个目录。

  1. 准备后端可见的真实本地目录,Docker 默认提供 /downloads 持久卷。
  2. 在“歌曲来源”新增本地媒体库并选择该目录,按页面设置下载用途。
  3. 保存时服务端会实际创建并删除临时文件验证权限;需允许业务 UID/GID 10001:10001 写入与遍历。
  4. 原来的 /media 歌库继续保持只读;宿主 NAS 目录需要部署者提前挂载并配置权限。

有未完成下载批次时,不能清除绑定、修改目录或移除该媒体库;先完成或取消任务。更换位置只影响未来任务,不移动原文件。

管理音源可导入 UTF-8 .js 文件(最大 9 MB)或公网 HTTPS 链接,支持 LX 2.0 GoScript。可保存多份,启用一份;兼容模式默认 mobile,确需桌面环境的脚本选择 desktop。

应用不内置音源。初始化测试通过,只证明脚本初始化及能力声明成功,不能保证每首歌、每种音质可下载。音源正文与导入地址加密保存,不回显原密钥。

基础下载由 Go 执行,不依赖计算节点。音乐平台资料匹配与下载音源是两套配置,启用元数据平台不会自动获得下载能力。

  1. 搜索歌曲,或输入支持的公开歌单、专辑入口,等待真实目录结果。
  2. 核对平台、歌手、版本与已读取数量;平台只公开部分歌曲时,不把部分结果当整张歌单。
  3. “选择已读取歌曲”只选择当前已读且尚未下载的曲目。
  4. 确认数量、保存位置、音源与音质,再提交下载。

当前目录适配覆盖网易云、QQ、酷狗、酷我、咪咕,实际可选平台与音质取决于自备音源声明。自动音质按声明从高到低解析,明确不可用才尝试下一档;手动音质失败不会静默降级。

下载在后台执行,最多两首同时传输,刷新或离开网页不会取消。记录按排队、解析、传输、发布、入库及失败展示,不要在发布阶段把字节 100% 当作已入库。

  • 每首音频上限 512 MiB、总传输时间 5 分钟;格式结构校验不等于音质鉴定或完整解码。
  • 先写私有临时目录,完整后按“歌手 - 歌名”发布;同名追加标识,不覆盖原文件。
  • 尝试保存同名 LRC 与静态封面,附件失败不阻止音频入库,记录保留提示。
  • 取消可处理排队、解析和传输中项目,正在发布的完整文件会完成入库。
  • 重启后排队项继续,未完成传输标记中断,发布阶段核对后补入库;失败或中断可按页面重试。
  • 任务中心提供批次概览,取消、重试和查看歌曲回到下载记录执行。

资料包用于复用已经整理的歌名、歌手、封面、歌词等共享资料,原始音视频仍由自己的目录或 WebDAV 提供。它不是账号、数据库、主密钥或整套 NAS 备份。

  1. 从来源的资料包功能导出并保存整套文件,保留所有分包。
  2. 接收方准备实际可访问的对应媒体来源,选择导入完整 ZIP。
  3. 等待上传、校验与路径预览,核对相对目录和文件大小,再显式确认。
  4. 导入后抽查歌曲、附件及媒体可播放情况,有差异时先核对映射,不要直接覆盖人工资料。

新建 WebDAV 时可勾选“从已导出的资料包入库”,主操作变为“保存并导入资料包”。来源先按不扫描、不自动提取、不定时扫描保存,上传成功后进入预览与确认;失败可复用已建来源重试。

  • 导出按每片最多 5000 条歌曲记录及 32 MiB 预算拆分;完整上传最多 8 GiB,按页面选择完整文件。
  • 上传、预览和确认是不同步骤;仅上传成功不等于资料已生效。
  • 已有本机人工设置或明确清空的决定不会被共享更新直接覆盖。
  • 只核验目录与大小不等于媒体内容逐字节相同;版本不一致时应人工抽查。
  • 反向代理需允许对应大小的上传及足够处理时间,失败后先查业务提示与代理限制。

资料包、下载媒体、正式附件应分别纳入自己的保存策略。继续阅读:资料审核、备份与维护。