远程与在线源

远程库是你自己的 NAS 或媒体服务器，不是网上搜歌。网上找来的封面和歌词只是补全。官方不提供网易云、QQ 音乐、Spotify 的搜索、登录、在线播放或下载。

DMCA 与版权声明

ECHO 严格遵守 DMCA 以及适用的版权法律。ECHO 官方不提供任何音乐下载服务，不提供用于获取音乐内容的下载功能，不托管、分发、售卖或镜像受版权保护的音频内容，也不提供绕过版权保护、破解会员权限或规避访问控制的功能。

你接入的 WebDAV、NAS、Jellyfin、Emby、Subsonic、云盘、代理、插件或任何第三方来源，都应只用于你有权访问和使用的内容。用户需要自行确保来源合法、账号合法、网络访问合法。

如果某个第三方来源、插件、脚本或用户自填 URL 涉及侵权内容，它不代表 ECHO 官方行为，也不在 ECHO 支持范围内。第三方来源产生的法律责任由接入者、使用者、插件作者或服务提供方自行承担，ECHO 项目和维护者不承担相关法律责任。

能力边界

不同来源提供的能力不同：

类型	作用	边界
WebDAV / NAS	浏览和播放你自有服务器上的文件	速度取决于服务器、网络和认证配置
Jellyfin / Emby	浏览媒体库、读取元数据、播放授权内容	目录层级和转码行为由服务器决定
Subsonic / Navidrome	访问个人音乐服务	需要用户自己的服务和账号
在线元数据	补全标题、艺术家、专辑、封面、歌词候选	只能作为候选或弱补全，不应覆盖高可信本地数据
插件	扩展连接方式或自动化流程	插件行为受权限和来源限制

ECHO 官方文档不会指导用户获取侵权内容，也不会为不可公开验证的第三方服务提供适配承诺。

完整声明见 下载与插件音源法律边界。

文档或设置里出现酷狗、网易云、QQ 音乐等字样，通常只代表歌词、元数据候选或历史兼容——不代表官方会提供这些平台的播放源或下载。

DLNA / UPnP 投送与 AirPlay 1 投送见 DLNA / 数播串流教程 与 AirPlay 支持边界。输出路径总览见 连接前端播放设备。远程曲库仅负责读取文件，不承担音频投送。

先弄清你要连的是哪一种

远程库不是“网上随便搜歌”。它是把你自己已经有的服务接到 ECHO 里。

你手里有什么	在 ECHO 里选什么	适合谁
NAS 或网盘开了 WebDAV	WebDAV	目录就是普通文件夹
家里有 Jellyfin	Jellyfin	已经用 Jellyfin 管电影和音乐
家里有 Emby	Emby	和 Jellyfin 类似的媒体服务器
自己架了 Navidrome / Subsonic	Subsonic	专门用来听自己的远程音乐库
局域网共享文件夹	SMB / NAS	资源管理器里已经能打开的共享盘

还没有服务器、想先架 Navidrome 或 WebDAV，看 云盘 / Subsonic 教程。网盘类入口可能需要 ECHO Pro。

添加远程库：按这个顺序点

不要先填一堆高级选项。按最短路径做：

1. 打开左边的 远程曲库。
2. 选择来源类型。不确定就先看上表，不要瞎选。
3. 填一个你自己看得懂的名称，例如 家里 NAS 或 Navidrome。
4. 填完整地址。注意 http 和 https，注意端口，注意有没有多余斜杠。
5. 填账号、密码或 token。能在浏览器里先登录成功再回来填。
6. 同步模式先选“仅浏览”或小范围索引。
7. 点测试连接。
8. 测试成功后再保存。
9. 先打开一个小目录，播放一首普通 MP3 或 FLAC。
10. 这首能播，再考虑建索引、补封面。

测试失败时，先别建索引。连不上就索引，只会多出一堆失败任务。

地址和账号怎么填才不容易错

项目	常见写法	常见错误
地址	https://music.example.com	漏了端口，或把网页登录页地址整段贴进来
WebDAV 目录	https://dav.example.com/music/	填到了网站首页，没有指到音乐目录
账号	服务里真实能登录的用户	填了路由器管理员账号
密码	应用密码或访问令牌	复制时多了空格、少了最后一位
证书	浏览器能正常打开的 https	家里自签证书没处理，测试会失败

能先在电脑浏览器打开同一个地址，再回 ECHO 填，成功率高很多。浏览器都打不开，ECHO 也帮不了。

同步模式怎么选

模式	含义	什么时候用
仅浏览	先看目录，不急着写入完整索引	第一次连接、还不熟
建立索引	把远程曲目写入曲库索引，播放时再取文件	地址已经测通，准备长期用
大范围全量同步	对很大的远程目录做完整补全	最后再做，不要第一天做

远程库慢，经常不是 ECHO 卡。家里宽带、NAS 休眠、服务器转码、证书校验、Wi-Fi 都不稳时，都会慢。先用 10 首歌证明能播，再谈整库。

连上以后怎么听

1. 在远程库页面点进你刚加的来源。
2. 先打开一个小专辑或小文件夹。
3. 双击一首常见格式的歌。
4. 看底部播放器会不会走，听会不会出声。
5. 能播之后，再回本地 歌曲 看它有没有按你的同步模式出现。

本地曲库和远程库是两条来源。不要以为添加远程库后，原来的本地歌会消失。只是你现在多了一个入口。

远程源使用建议

首次连接远程源时，按这个顺序确认：

1. 测试账号、地址、端口和证书。
2. 先浏览根目录或一个小目录。
3. 播放一首普通格式的音频。
4. 再开启索引、封面、歌词或后台同步。
5. 最后再扩大到完整目录。

不要一开始就对整个 NAS 或媒体服务器做全量索引。远程目录很大时，同步慢、封面加载慢、部分文件需要等待都是正常现象。

在线元数据

在线元数据适合补全缺失信息，例如封面、歌词候选、艺术家、专辑名或年份。它不应该替代本地标签事实：

• 手动编辑优先于在线结果。
• 嵌入标签优先于在线结果。
• 同目录封面优先于在线封面。
• 在线结果应尽量可预览、可撤销、可小范围应用。

批量应用在线元数据前，请先在少量歌曲上确认效果。

网络和代理

远程源问题经常来自网络环境：

• 家庭 NAS 可能受内网、DDNS、端口转发和证书影响。
• 校园网、公司网可能限制 WebDAV、媒体服务器或代理。
• 代理可能影响在线元数据、封面和歌词访问。
• 服务器转码、限速或休眠会影响播放稳定性。

反馈远程源问题时，请截图连接状态、目录页面、错误信息和同步进度，并说明服务类型、服务器版本、网络环境和是否使用代理。

不支持范围

以下情况不属于 ECHO 官方支持范围：

• 任何侵权、盗版、绕过付费或规避访问控制的内容来源。
• 第三方下载站、资源站、脚本、爬虫或灰色插件。
• 用户自改服务端、非公开接口、失效 API 或需要抓包逆向的来源。
• 需要 ECHO 帮用户获取、搜索、下载受版权保护内容的请求。
• 试图把 ECHO 插件接口当作官方背书、官方音源或法律责任转移对象的请求。
• 网易云、QQ 音乐、Spotify、YouTube、Bilibili、酷狗等第三方流媒体平台的搜索、登录、解析、播放或下载请求。

ECHO 可以帮助你管理和播放你有权使用的内容，但不会提供下载服务，也不会帮助规避版权或平台规则。