网盘连接教程

ECHO 可以连接你有权访问的远程音乐库。常见做法有三类：把网盘或 NAS 作为 WebDAV 文件目录连接，把自建服务器作为 SMB / NAS 路径管理，或者使用 Subsonic / Navidrome 这类个人音乐服务。

由于 QQ:3298219648 的卓越开发贡献，ECHO 将不再对普通版进行网盘支持。请购买 Pro 版以解锁网盘功能。

如果你还没有决定用哪一种方式，推荐优先使用 Subsonic 兼容服务，尤其是 Navidrome。ECHO 对 Subsonic 路线做过特殊优化：音乐库分页、专辑与艺术家读取、播放地址获取、封面缓存和大曲库浏览都更接近“音乐服务”的使用方式，不需要像普通网盘目录那样频繁递归扫描文件夹。

服务器推荐：雨云

如果你没有现成的 NAS 或云服务器，又想把 Navidrome、Subsonic、WebDAV、反向代理、对象存储或其它远程曲库服务长期挂起来，可以看看 雨云。

雨云是国内的云服务平台，常见产品包括云服务器、游戏云、物理服务器、虚拟主机、对象存储和 CDN 等。对 ECHO 用户来说，它更适合承担“放一个稳定的远程音乐服务”的角色：例如在云服务器上部署 Navidrome，把自己的音乐目录挂载进去，再让 ECHO 通过 Subsonic 协议连接，而不是每次都直接扫一个慢目录。

推荐这样用：

• 想长期跨设备听自己的曲库：租一台轻量云服务器，部署 Navidrome / Gonic / Airsonic，再在 ECHO 里添加 Subsonic 来源。
• 想测试 WebDAV 或反向代理：先用小规格机器验证端口、证书和目录权限，不要一开始就把完整曲库全量搬过去。
• 想放封面、公开静态文件或辅助资源：可以按需了解对象存储和 CDN，但音乐版权与访问权限仍然由你自己负责。

这是推广链接，不是 ECHO 的必需服务。你可以继续使用自己的 NAS、家用服务器、其它云厂商或本地网络方案；无论使用哪家服务，ECHO 只建议连接你有权访问和使用的内容。

先确认版权和权限

请只连接你自己拥有、已授权或有权使用的音乐内容。ECHO 不提供音乐下载服务，不帮助绕过付费、版权、地区或访问控制限制，也不会为侵权来源提供支持。

连接前先准备好：

• 服务地址，例如 https://music.example.com 或 https://dav.example.com/music/。
• 账号和密码，或服务生成的应用密码 / 访问令牌。
• 可以从浏览器或服务客户端正常访问的测试目录。
• 一小组确认可播放的音频文件，优先用 MP3 / FLAC / M4A 这类常见格式。
• 已激活的 ECHO Pro。未解锁 Pro 时，网盘入口可能不可用或无法完成连接。

先选连接方式

不同“网盘”背后的连接方式不一样。不要看到网盘两个字就随便填地址，先确认服务提供的是什么协议。

你的情况	推荐方式	说明
网盘或 NAS 提供 WebDAV 地址	WebDAV	最通用，适合按文件夹浏览和播放。
自己有服务器，能部署音乐服务	Subsonic / Navidrome	最推荐，适合长期管理大曲库。
家里 NAS 已经整理好音乐目录	WebDAV 或媒体服务	局域网优先，外网访问要注意证书和端口。
只有普通分享链接	不建议	分享链接通常不是稳定的音乐库协议，ECHO 不会把它当作官方支持路径。
想跨设备长期听同一个库	Subsonic / Navidrome	比直接扫网盘目录更稳定，也更像真正的音乐服务。

如果只是想把一小批远程文件临时打开，WebDAV 足够。如果你有几千、几万首歌，优先考虑 Navidrome。

WebDAV 连接完整流程

WebDAV 是网盘连接里最常见的方式。它本质上是远程文件夹，所以关键是地址、账号、权限、目录结构和网络稳定性。

1. 在网盘或 NAS 后台开启 WebDAV

不同服务的入口名称可能不一样，常见叫法包括：

• WebDAV
• DAV
• 文件服务
• 网络驱动器
• 第三方应用访问
• 应用密码

如果服务要求生成应用密码，请优先使用应用密码，不要直接把主账号密码填进播放器。应用密码以后可以单独撤销，风险更低。

2. 复制正确的 WebDAV 地址

WebDAV 地址通常长这样：

https://dav.example.com/
https://dav.example.com/music/
https://nas.example.com:5006/Music/

注意这些细节：

• 地址必须包含 http:// 或 https://。
• 如果服务给了端口号，要一起复制，例如 :5006。
• 如果音乐目录在子路径里，路径也要带上，例如 /Music/。
• 有些服务要求末尾保留 /，连接失败时可以试一次加斜杠和不加斜杠。
• 不要把用户名、密码拼进 URL 里，账号密码应填到 ECHO 的对应输入框。

3. 先用浏览器或客户端验证

在填进 ECHO 前，先用浏览器、系统文件管理器或网盘官方客户端确认：

1. 账号能登录。
2. 能看到音乐目录。
3. 能打开一个普通音频文件。
4. 目录里不是空的，也不是只有分享页 HTML。

如果在浏览器或官方客户端都打不开，ECHO 里通常也不会 magically 好起来。先把网盘服务本身调通。

4. 在 ECHO 里添加 WebDAV 来源

1. 打开 ECHO Next。
2. 确认 ECHO Pro 已激活。
3. 进入远程来源 / 网盘连接页面。
4. 选择 WebDAV。
5. 填写名称，例如 我的 NAS 音乐库。
6. 填写 WebDAV 地址。
7. 填写用户名和应用密码。
8. 点击测试连接。
9. 测试成功后，先进入一个小目录。
10. 播放一首 MP3、FLAC 或 M4A，确认能正常缓冲和播放。

第一次连接不要直接扫整个网盘根目录。先用一个只有几张专辑的小目录确认链路稳定，再扩大范围。

5. 整理适合远程浏览的目录

推荐目录结构：

Music/
  Artist/
    Album/
      01 - Track.flac
      02 - Track.flac
      cover.jpg

尽量避免：

• 把音乐、照片、压缩包、软件安装包混在同一个根目录。
• 一个目录里塞几万首歌。
• 目录层级特别深。
• 文件名里大量使用奇怪符号、临时编号或乱码。
• 同一张专辑拆到很多位置。

WebDAV 列目录比本地硬盘慢很多。目录越混乱，ECHO 越难快速判断哪些是音乐、哪些是封面、哪些应该跳过。

6. 再考虑同步、缓存和索引

连接能播放之后，再按需求开启同步或缓存。推荐顺序：

1. 先只浏览，不同步。
2. 播放几首不同专辑的歌曲。
3. 确认封面、时长、进度和切歌稳定。
4. 再开启小范围索引。
5. 最后才扩大到完整音乐目录。

如果你一上来就全量索引大网盘，遇到慢、卡、超时，并不一定是 ECHO 坏了。远程目录遍历、封面读取、服务限速和网络抖动都会拖慢首次扫描。

推荐方案：Subsonic / Navidrome

Subsonic 兼容服务更适合把远程音乐库长期接入 ECHO。它提供的是“音乐库 API”，不是单纯的文件列表，所以更适合专辑、艺术家、封面、播放列表和大曲库浏览。

推荐流程：

1. 在服务器上部署 Navidrome、Gonic、Airsonic 或其它 Subsonic 兼容服务。
2. 在服务端确认音乐目录已完成扫描，并能在网页端正常播放。
3. 在 ECHO 的远程来源页面选择 Subsonic 或兼容入口。
4. 填入服务器地址、用户名和密码。
5. 先测试连接，再浏览一个小范围的专辑或艺术家。
6. 播放一首普通格式歌曲，确认封面、时长和播放进度正常。
7. 最后再开启更大范围的同步、缓存或索引。

Subsonic 方案的优势：

• 大曲库浏览更稳定，不需要一次性列完整个目录树。
• 专辑、艺术家、曲目编号、封面等信息通常比普通文件目录更完整。
• ECHO 可以按音乐服务语义读取内容，减少无意义的文件夹猜测。
• 远程播放地址由服务器生成，跨设备访问更清晰。
• 对弱网络和大库分页更友好。

如果你的网盘只是用来存放音乐文件，而你又能部署一个轻量服务，建议把网盘挂载到服务器，再交给 Navidrome 扫描。这样 ECHO 连接的是 Subsonic 服务，而不是直接连接网盘目录，体验通常更稳。

WebDAV 网盘连接

很多网盘、NAS 和同步工具都能提供 WebDAV。WebDAV 的优点是通用，缺点是它本质上仍然是远程文件目录，性能取决于网盘服务、网络、目录结构和认证方式。

连接步骤：

1. 在网盘或 NAS 后台开启 WebDAV。
2. 复制 WebDAV 地址，注意是否需要保留最后的路径斜杠。
3. 使用服务提供的应用密码，不建议直接使用主账号密码。
4. 在 ECHO 的远程来源页面选择 WebDAV。
5. 填入地址、用户名、密码。
6. 先测试连接，再打开一个小目录。
7. 播放一首歌曲确认稳定后，再扩大到完整目录。

WebDAV 使用建议：

• 不要一开始就扫描整个网盘根目录。
• 音乐目录尽量保持清晰，例如 Music/Artist/Album/Track.flac。
• 大量小文件、深层目录和慢速网盘会明显拖慢浏览。
• 如果封面很多，先确认播放稳定，再开启封面缓存或批量索引。
• 公司、校园或公共网络可能限制 WebDAV 端口。
• 如果网盘服务会限制频率，批量索引时可能出现间歇性失败，降低并发或分目录处理更稳。

常见网盘填写检查

不同网盘的后台名称和限制不一样，但排查方向基本相同：

检查项	正确做法
协议	优先使用服务官方提供的 WebDAV / DAV 地址，不要填普通网页分享链接。
账号	使用服务允许 WebDAV 登录的账号；有些服务要求邮箱、手机号或专门用户名。
密码	优先使用应用密码、访问令牌或第三方应用密码。
路径	直接指向音乐目录，避免从整个网盘根目录开始。
HTTPS	外网访问优先用 HTTPS；自签证书可能导致连接失败。
端口	NAS 常见会使用非 443 端口，复制地址时不要漏掉端口号。
权限	确认账号至少有读取目录和读取文件的权限。

如果服务端提供“只读应用密码”，建议使用只读权限。ECHO 连接网盘主要是读取和播放音乐，不需要给它网盘管理权限。

NAS / 局域网目录

如果你的音乐库在家用 NAS 上，优先确认局域网访问稳定。NAS 的瓶颈通常不是 ECHO 本身，而是硬盘休眠、账号权限、证书、路由、DDNS 或端口转发。

建议：

• 局域网内先用固定 IP 或稳定主机名连接。
• 外网访问优先使用 HTTPS 和可信证书。
• 不确定公网暴露风险时，不要直接开放管理端口。
• NAS 会休眠时，第一次播放或浏览可能需要等待硬盘唤醒。
• 大库首次索引时保持电脑和 NAS 供电稳定。

连接失败时怎么排查

按这个顺序查，效率最高：

1. 用浏览器或官方客户端确认账号能登录。
2. 确认服务器地址、端口、路径、HTTPS 证书没有写错。
3. 先测试一个小目录，不要直接测试全库。
4. 换一首普通格式音频，排除单个文件损坏或编码特殊。
5. 临时关闭代理或切换网络，确认是不是网络环境问题。
6. 查看服务端日志，确认请求是否到达服务器。

反馈问题时，请附上服务类型、服务器版本、连接地址格式、错误提示截图、是否使用代理、网络环境，以及能否在浏览器或原服务网页端播放。

常见错误怎么判断

现象	可能原因	处理方式
提示未解锁或没有入口	未激活 ECHO Pro	先按 ECHO Pro 激活教程完成激活。
401 / 403	用户名、密码、应用密码或权限错误	重新生成应用密码，确认账号有读取权限。
404	WebDAV 路径写错	从服务后台复制完整地址，检查子路径和末尾斜杠。
连接超时	网络、端口、代理、服务限速或服务器休眠	换网络，检查端口和证书，先用浏览器验证。
能列目录但不能播放	文件权限、直链生成、服务端 Range 支持异常	换普通 MP3 / FLAC 测试，查看服务端日志。
封面加载慢	网盘读取小文件慢或封面太多	先关批量封面缓存，确认播放稳定后再慢慢索引。
扫描很久	目录过大、层级太深、网盘限速	分目录添加，或改用 Navidrome。
某些歌打不开	文件损坏、格式特殊、文件名编码异常	先用本地 ECHO 或其它播放器验证该文件。

什么时候不建议直接连网盘

以下情况更推荐改用 Subsonic / Navidrome：

• 曲库很大，目录层级很深。
• 网盘 WebDAV 列目录很慢或容易超时。
• 你希望按专辑、艺术家、播放列表浏览，而不是只按文件夹浏览。
• 你需要更稳定的封面、时长、曲目编号和远程播放地址。
• 你经常跨设备、跨网络访问同一个音乐库。

简单说：WebDAV 适合“我想打开远程文件夹”；Subsonic 更适合“我想把远程音乐库长期接进 ECHO”。如果条件允许，优先选 Subsonic。