主题

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 密码