WebDAV 远程音乐

WebDAV 是一种网络存储协议，允许你通过网络访问远程服务器上的文件。瓜子音乐支持挂载 WebDAV 存储，直接播放远程服务器上的音乐文件，无需先下载到本地。

适用场景

场景	说明
NAS 设备	家里有 NAS 存储音乐，可以通过内网 WebDAV 直接播放
云盘	部分网盘支持 WebDAV 协议（如坚果云、TeraCloud）
远程服务器	自有服务器存放音乐文件，随时随地访问
多设备共享	一份音乐文件，多台设备流式播放，节省本地存储

WebDAV 不需要插件

WebDAV 播放属于本地音乐范畴，不需要 在线播放插件。即使插件未安装或失效，WebDAV 音乐也能正常播放。

配置 WebDAV

1. 进入 设置 → WebDAV

2. 填写连接信息：

   字段	说明	示例
   服务器地址	WebDAV 服务地址	https://dav.jianguoyun.com/dav/
   用户名	WebDAV 账号用户名	your@email.com
   密码	WebDAV 账号密码（部分平台为应用专用密码）	app-specific-password

3. 点击 测试连接，确认信息正确

4. 连接成功后，可以在 本地音乐 → WebDAV 标签页查看远程目录

坚果云用户注意

坚果云的 WebDAV 密码不是登录密码，需要在坚果云网页版「安全选项 → 第三方应用管理」中生成应用专用密码。

扫描远程目录

在 WebDAV 标签页中，点击添加目录 → 浏览远程文件夹 → 点击文件夹旁的扫描按钮。

扫描分两个阶段：

阶段	说明	进度提示
收集文件	遍历目录树，列出所有音频文件	"找到 X 首音频"
解析元数据	逐个读取文件头部，提取歌名/艺人/时长/封面	"解析元数据：歌曲名"

浏览与播放

连接成功后：

1. 切换到 本地音乐 页面的 WebDAV 标签
2. 浏览远程服务器上的目录结构（点击文件夹进入子目录）
3. 点击歌曲即可播放（通过网络流式传输，不下载完整文件）
4. 悬浮歌曲行可点击 ℹ️ 信息按钮 查看文件格式、大小、时长、远程路径

音质标签

播放详情页会根据文件格式显示 WebDAV·MP3 / WebDAV·FLAC / WebDAV·WAV 等音质标签。

歌词支持

WebDAV 歌曲支持与本地音乐相同的歌词来源优先级（遵循 设置 → 歌词 → 歌词来源优先级）：

优先级	来源	说明
内嵌歌词	文件标签中提取	ID3v2 / Vorbis / MP4 内嵌歌词
旁路歌词	同目录 .lrc 文件	自动从 WebDAV 远程拉取
在线搜索	网络匹配	按歌名 + 艺人搜索在线歌词

自动模式

设置为「自动」时，会依次尝试内嵌 → 旁路 → 在线搜索，找到即停止，与本地音乐逻辑一致。

歌曲时长

扫描阶段会自动解析音频文件头部，提取准确时长。对于无法通过头部确定的文件，会自动根据比特率和文件大小估算。

音谱动效

WebDAV 歌曲 暂不支持音谱动效（封面可视化）。悬浮封面上会显示提示。

流式播放

WebDAV 播放采用 HTTP Range 请求按需加载，不需要等整个文件下载完成。即使是高码率 FLAC 文件，缓冲几秒后即可开始播放。

添加 WebDAV 文件到歌单

与本地文件一样，WebDAV 上的歌曲可以：

• 添加到播放队列
• 收藏到「我喜欢的音乐」
• 加入自定义歌单
• 从歌单中移除

WebDAV 歌曲在歌单中会标注来源，方便区分。

注意事项

• WebDAV 播放依赖网络速度，本地网络（NAS）体验最佳
• 首次打开远程目录可能需要等待文件列表加载
• 密码会安全保存在本地系统中，不会泄露
• 如果要连接多个 WebDAV 账号，需要切换账号信息（当前版本不支持同时连接多个 WebDAV 服务器）
• 远程文件名包含特殊字符可能导致播放失败，建议使用英文命名

常见问题

测试连接失败？

• 检查服务器地址是否正确（注意 http 与 https、端口号、末尾斜杠）
• 检查用户名和密码是否正确（坚果云用应用专用密码）
• 确认服务器启用了 WebDAV 服务
• 检查防火墙是否开放对应端口
• 部分服务商有 IP 白名单限制，需将本机 IP 加入白名单

远程文件播放卡顿？

• 可能是网络延迟导致，尝试在网络更好的环境使用
• 高码率文件（如 FLAC 无损）在网络不佳时可能缓冲较慢
• 考虑将高码率文件下载到本地后再播放
• 内网 NAS 建议用千兆网络连接

WebDAV 目录显示不全？

• 部分服务器对单次列出的文件数量有限制
• 检查 WebDAV 账号是否有该目录的读取权限
• 尝试刷新目录列表

连接超时？

• 检查网络连接是否稳定
• 服务器响应慢时可能超时，尝试重试
• 国外 WebDAV 服务可能需要更稳定的网络环境

常见 WebDAV 服务配置参考

坚果云

字段	值
服务器地址	https://dav.jianguoyun.com/dav/
用户名	坚果云登录邮箱
密码	应用专用密码（非登录密码）

NextCloud / ownCloud

字段	值
服务器地址	https://your-domain.com/remote.php/dav/files/USERNAME/
用户名	NextCloud 账号
密码	NextCloud 密码或应用专用密码

群晖 NAS

字段	值
服务器地址	https://your-nas-ip:5006/
用户名	群晖账号
密码	群晖密码

AList

字段	值
服务器地址	http://your-ip:5244/dav/
用户名	AList WebDAV 账号
密码	AList WebDAV 密码