音樂來源連不上、登入失敗或掃描不到歌曲怎麼辦

第一步：執行音樂來源體檢

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、密碼或權杖失效、雲端硬碟授權過期、所選目錄無法讀取，或服務方臨時限流。