本教程按 2026-09-22 的 Windows WinUI 预览版更新。服务器已提供 WebDAV 入口后，可以直接从播放器添加远端来源。旧 Tauri 和网页端的入口可能不同。
准备连接信息
从你的服务管理界面确认 WebDAV 地址、账号及音乐根目录。使用协议服务地址，不要填管理后台网页 URL。服务器部署步骤仍见对应搭建教程，这里说明播放器的实际连接流程。
在 WinUI 添加来源
- 点击左上角的来源选择器。
- 选择 添加远端来源…。
- 给连接起一个易于识别的名称。
- 类型选择 webdav。
- 填写服务地址、根路径（可选）、用户名和密码。
- 点击 测试连接，依据返回结果排查，然后保存。
根路径用于限定音乐位置；如果服务地址已经指向音乐目录，不要在两个字段中重复追加同一层路径。认证信息由你的服务器决定，不能把不同服务的账号格式直接照搬。
打开音乐库
重新打开来源菜单，选择刚保存的连接。若服务返回多个曲库，选择目标曲库，再浏览和播放。
列表出现曲目只证明枚举成功。点击曲目后还会解析并读取实际音频资源；认证、权限或资源地址的问题可能在这一阶段才出现。
大曲库
当前 WinUI 的 加载更多会扩大获取数量，上限为 5000 条，不是无限分页。出现截断时，不要把当前曲目数当成服务器总数。
按错误位置排查
| 现象 | 先检查 |
|---|---|
| 测试连接失败 | 服务是否运行、网络、协议地址、认证 |
| 连接成功但为空 | 根路径、目录权限、音乐所在的曲库 |
| 能看到歌曲但播放失败 | 源文件存在性、资源地址和读取权限 |
| 有些歌曲没有显示 | 格式、目录范围、服务端返回和加载上限 |
切回本地曲库播放一首已知文件，可以区分原生播放与远端服务的问题。进一步见远端音乐来源和常见问题。
Navidrome 用户
在同一个添加来源窗口中，Navidrome 使用 subsonic 类型，不要选择 webdav。按其服务提供的音乐库选择与认证信息连接。