夸克网盘对接songloft

原理说明

SongLoft 原生不支持夸克网盘直连，但内置 WebDAV 数据源插件；夸克无官方 WebDAV 接口，必须通过 OpenList/AList 中转，把夸克转为标准 WebDAV 地址，再接入 SongLoft。

• OpenList 项目地址：https://doc.oplist.org/guide

本教程假设你已有 OpenList（之前部署在 ./openlist），复用现有服务，不用额外装 AList。

前置条件

• 服务器正常运行 OpenList，端口 5244 放行防火墙
• OpenList 后台成功挂载夸克网盘
• SongLoft 服务已正常启动（Docker / 二进制均可）
• 夸克网盘内音乐文件（mp3/flac/m4a/wav 等）分类存放

第一部分：OpenList 挂载夸克网盘（中转 WebDAV）

步骤 1：登录 OpenList 后台

浏览器访问：http://服务器IP:5244，账号 admin，密码为你设置的 OpenList 密码。

步骤 2：添加夸克网盘存储

1. 左侧菜单 → 存储 → 右上角【添加】
2. 驱动下拉选择：夸克网盘
3. 填写配置：
   • 挂载路径：/quark（自定义，后面 WebDAV 要用）
   • Cookie（核心）：
     1. Chrome/Edge 打开 pan.quark.cn 登录你的夸克账号
     2. F12 打开开发者工具 → 切换「网络 (Network)」→ 筛选 Fetch/XHR
     3. 刷新页面，任意一条请求点开，复制完整 Cookie 字符串
4. 缓存时长默认，点击【添加】，等待状态显示正常

步骤 3：给 admin 账号开启 WebDAV 权限

1. 左侧【用户】→ 编辑 admin 用户
2. 权限勾选：WebDAV 读取、WebDAV 管理（必须全勾）
3. 保存

步骤 4：获取夸克专属 WebDAV 地址

• 全局 WebDAV（所有存储）：

  http://服务器IP:5244/dav/

• 仅访问夸克网盘（推荐 SongLoft 使用，干净无其他文件）：

  http://服务器IP:5244/dav/quark/

WebDAV 账号密码 = OpenList 登录账号密码（admin + 你的密码）

第二部分：SongLoft 添加 WebDAV 音乐库（接入夸克）

网页后台添加（最简单）

1. 打开 SongLoft 网页端：http://SongLoftIP:端口
2. 左侧【媒体库 / 存储源】→ 点击「添加存储」
3. 存储类型选择：WebDAV
4. 填写 WebDAV 参数：
   • 名称：夸克音乐库（自定义）
   • 服务地址：http://服务器IP:5244/dav/quark/
   • 用户名：admin
   • 密码：你的 OpenList 登录密码
   • 缓存（可选）：开启加速扫描
5. 测试连接，提示连接成功后保存

评论

评论 1 - jsdwei

不知道为啥，添加openlist的webdav不成功，songloft和openlist都在一个电脑上，浏览器已经可以访问http://127.0.0.1:5244, songloft的webdav插件设置里服务器地址填入 http://127.0.0.1:5244/dav 密码和用户也没问题，测试连接不通过，提示connection refused

---

链接到 GitHub Issue