音乐源连不上、登录失败或扫描不到歌曲怎么办

第一步：运行音乐源体检

1. 打开 设置 › 音乐源管理。
2. 在出问题的音乐源上长按，选择「音乐源体检」；也可以向左滑动后点「体检」。Mac 上在音乐源的菜单中选择「音乐源体检」。
3. 等待「正在检查连接和扫描条件...」结束，查看「检查项」中的「配置」「凭据」「连接」等项目。

结果有三种：「可以扫描」「可用但有提醒」「需要处理」。处理完后点「重新体检」确认。

按提示处理

地址和网络

添加或编辑来源时，如果连接失败，界面会显示「连接失败」和实际尝试的地址，并给出提示：

• 这是一个内网地址，只有连着同一个网络才通。
• 用域名访问时，端口通常是 443 或 80；服务自己的端口多半只在内网开着。
• 这个公网地址走的是不加密连接，很多服务器会直接拒绝。
• 这条走的是厂商中转，先确认设备在线、远程访问已经打开。

可以点「修改地址」直接修改。首次连接局域网设备时，系统会请求本地网络权限：Primuse 需要访问本地网络以发现和连接您的 NAS 设备、媒体服务器及其他音乐源。 如果之前拒绝过，请在系统设置的隐私权限中为 Primuse 重新开启本地网络。

HTTPS 证书

服务器使用自签名证书或证书与主机名不符时，连接时会请你确认证书。确认后会固定到该证书；证书更换后会提示「服务器证书已更换」：服务器当前证书与上次确认的证书不同。请核对后再更新信任。

已信任的项目在 设置 › 受信任的域名（「安全」分组）中管理：手动添加的端点仍会在首次连接时要求核对证书；已确认项固定到证书指纹，换证会再次询问。左滑可移除。

公网 HTTP

局域网地址可以直接用 HTTP。公网主机使用 HTTP 时会提示「允许不安全的 HTTP 连接？」，需要点「仍然允许 HTTP」才能连接。未允许时会显示：主机「…」尚未获准使用公网 HTTP。请改用 HTTPS，或在安全设置中明确允许该主机。iPhone、iPad 上已允许的主机在 受信任的域名 › 允许 HTTP 的主机 中：仅这些公网主机可使用明文 HTTP。连接不会加密，账号、密码、会话和媒体数据可能被截获；请优先使用 HTTPS。

登录失败

后台同步时如果服务器拒绝密码，会弹出「音乐源登录失败」，提示「登录失败,请检查账号密码或 NAS 状态。」。点「重新输入密码」重新输入即可。SMB 来源也可能显示「SMB：用户名或密码错误」。启用了两步验证的服务器（如群晖）请重新连接一次。

能连上但没有歌曲

• 体检提示目录为空：可能是空文件夹、被过滤的视图，或当前账号没有足够权限。
• SMB、NFS 请先固定共享目录或导出路径（先连接并选择共享目录，后续扫描会更稳定。）。
• 扫描在后台可能会暂停，回到前台会继续。详见 扫描、刷新和整理资料库。

仍然无法解决

请按 收集并发送诊断信息给作者 提交诊断，并写明来源类型、是局域网还是公网访问，以及出问题的时间。

相关文章

• 添加和管理音乐源：类型总览、入口与日常操作
• 连接 NAS 与网络共享：Synology、QNAP、SMB、WebDAV、FTP、SFTP、NFS、S3、UPnP
• 连接媒体服务器：Jellyfin、Emby、Plex、Subsonic/Navidrome、Audiobookshelf、飞牛音乐等
• 连接网盘：百度网盘、阿里云盘、Google Drive、OneDrive、Dropbox、123 云盘、光鸭云盘、pCloud、Drime、InfiniCLOUD
• 相关问答：「我的音乐服务器只有 HTTP，为什么需要额外确认？」、「音乐源能看到歌曲，为什么仍可能播放失败？」、「S3 连接检查通过，为什么扫描后还是 0 首歌？」、「切到后台后扫描暂停，音乐还在播为什么也不能一直扫描？」、「提示请求过多或稍后重试，反复刷新有用吗？」

连接失败通常是以下原因之一：设备与服务器不在同一网络、地址或端口不对、HTTPS 证书无法验证、公网地址使用了未加密的 HTTP、密码或令牌失效、云盘授权过期、所选目录无法读取，或服务方临时限流。