独立说明：ZoneFoundry 不是 Sonos、Spotify 或 Apple 的官方产品。本页只说明 Sonos 官方 App 的内容服务和音乐库设置；服务、套餐、曲库与音质会随国家和账号变化。獨立說明：ZoneFoundry 並非 Sonos、Spotify 或 Apple 的官方產品。本頁只說明 Sonos 官方 App 的內容服務及音樂庫設置；服務、計劃、曲庫及音質會因國家及賬號而異。Independent guide: ZoneFoundry is not a Sonos, Spotify, or Apple product. This page covers the official Sonos content-service and music-library setup. Service availability, plans, catalogs, and quality vary by country and account.
你要走边条路？先选对你要走邊條路？先選對Which path do you need? Choose first
Spotify、Apple Music 以及其他在线提供商属于 Content Services（内容服务）。Sonos 不会把整个在线曲库存入你的音箱；它保存授权，并在播放时向服务请求内容。NAS 音乐库属于 Music Library（音乐库）。Sonos 扫描 SMB 共享内的文件和元数据，建立可浏览的本地索引。在线服务登录失败时应检查账号、套餐和地区；NAS 不显示歌曲时则应检查共享协议、权限、路径和索引。Spotify、Apple Music 及其他網上供應商屬於 Content Services（內容服務）。Sonos 不會把整個網上曲庫儲存在音箱內；它會保存授權，並在播放時向服務要求內容。NAS 音樂庫屬於 Music Library（音樂庫）。Sonos 掃描 SMB 共享內的檔案及元資料，建立可瀏覽的本地索引。網上服務登入失敗時應檢查賬號、計劃及地區；NAS 未顯示歌曲時則應檢查共享協議、權限、路徑及索引。Spotify, Apple Music, and other online providers are Content Services. Sonos does not copy their catalogs into your speakers; it stores authorization and requests content at playback time. A NAS belongs to Music Library. Sonos scans files and metadata in an SMB share and builds a local browse index. When an online service fails, investigate account, plan, and region. When NAS tracks are missing, investigate share protocol, credentials, path, and indexing. Treating both as the same “add music” problem wastes time.
如果你刚建立系统，先确认一间房能正常播放，再添加内容。若房间本身不稳定，服务授权成功也无法证明网络正确。完整基础流程见 第一次设置 Sonos；旧产品则先用 S1 / S2 指南确定 App 和 SMB 代际。如果你剛建立系統，先確認一個房間能正常播放，再加入內容。如房間本身不穩定，服務授權成功也不能證明網絡正確。完整基礎流程見 第一次設置 Sonos；舊產品則先用 S1 / S2 指南確定 App 及 SMB 世代。If the system is new, verify stable playback in one room before adding content. A successful login does not prove the room’s network path is healthy. Use the first-time Sonos setup guide for the foundation, and check S1 vs S2 before connecting a NAS to older hardware because the SMB requirements differ.
添加 Spotify、Apple Music 或其他在线服务加入 Spotify、Apple Music 或其他網上服務Add Spotify, Apple Music, or another online service
添加前检查加入前檢查Before adding a service
- 确认提供商在 Sonos 账号所在地区可用，订阅层级支持你想使用的功能。確認供應商在 Sonos 賬號所屬地區可用，訂閱級別支援你需要的功能。Confirm the provider is available in the Sonos account’s region and the subscription tier supports the features you expect.
- 在手机上先登录提供商官方 App，确认账号和付款状态正常。先在手機登入供應商官方 App，確認賬號及付款狀態正常。Sign in to the provider’s own mobile app first and confirm the account and billing status.
- 使用拥有 Sonos 系统管理权限的账号打开 Sonos App。使用擁有 Sonos 系統管理權限的賬號開啟 Sonos App。Open Sonos with an account that has permission to manage the system.
打开内容服务列表開啟內容服務清單Open the Content Services list
在当前 Sonos App 打开账户菜单，选择 Content Services（内容服务），进入 Connected Services（已连接服务），再点 Add Content Service（添加内容服务）。搜索或浏览提供商。服务未出现不一定是 App 故障：Sonos 官方说明可用性取决于所在地区、服务自身政策及订阅类型。在目前的 Sonos App 開啟賬號選單，選擇 Content Services（內容服務），進入 Connected Services（已連接服務），再按 Add Content Service（加入內容服務）。搜尋或瀏覽供應商。服務未顯示不一定是 App 故障：Sonos 官方說明可用性取決於所在地區、服務本身政策及訂閱類型。In the current Sonos app, open the account menu, choose Content Services, open Connected Services, then select Add Content Service. Search or browse for the provider. A missing service is not automatically an app defect: Sonos notes that availability depends on region, the provider’s policy, and subscription type.
完成提供商授权完成供應商授權Complete provider authorization
选择服务后点 Add to Sonos（添加到 Sonos），按提示登录。授权可能在网页、提供商 App 或设备码页面完成。Apple Music 的部分流程要求在 iOS 或 Android 上安装并登录 Apple Music App；Spotify 则支持在 Spotify App 里直接选择 Sonos 作为播放目标。不要把提供商密码输入非官方弹窗，也不要把授权码交给其他人。選擇服務後按 Add to Sonos（加入 Sonos），按指示登入。授權可能在網頁、供應商 App 或裝置代碼頁面完成。Apple Music 的部分流程要求在 iOS 或 Android 上安裝並登入 Apple Music App；Spotify 則支援在 Spotify App 內直接選擇 Sonos 作為播放目標。不要把供應商密碼輸入非官方視窗，也不要把授權碼交給其他人。Select the service, choose Add to Sonos, and follow the sign-in prompts. Authorization may complete in a web page, the provider’s app, or a device-code screen. Some Apple Music flows require its mobile app to be installed and signed in on iOS or Android. Spotify also supports direct control by selecting Sonos from the Spotify app. Never type a provider password into an unofficial dialog or share a device code with another person.
命名账号并测试搜索命名賬號並測試搜尋Name the account and test search
Sonos 支持为同一服务添加多个账号。若家庭成员都使用 Spotify 或 Apple Music，请用能辨认的显示名，例如“Sam Spotify”或“家庭 Apple Music”，不要都保留为“我的账号”。完成后先从该服务自己的浏览入口播放，再用 Sonos 搜索同一首歌。这样能分别验证授权和跨服务搜索。Sonos 支援為同一服務加入多個賬號。如家庭成員均使用 Spotify 或 Apple Music，請使用容易辨認的顯示名稱，例如「Sam Spotify」或「家庭 Apple Music」，不要全部保留為「我的賬號」。完成後先由該服務本身的瀏覽入口播放，再用 Sonos 搜尋同一首歌。這樣可分別驗證授權及跨服務搜尋。Sonos supports multiple accounts for the same service. If several people use Spotify or Apple Music, give each connection a recognizable display name such as “Sam Spotify” or “Family Apple Music” instead of leaving every entry as “My account.” First play from that service’s own browse area, then search for the same track in Sonos. This separates authorization testing from cross-service search testing.
Spotify 有边两个控制入口？Spotify 有邊兩個控制入口？What are the two ways to control Spotify?
Spotify 可以从 Sonos App 内浏览和搜索，也可以从 Spotify App 使用 Spotify Connect 选择 Sonos 房间。后者并不等于 AirPlay：Spotify 把播放会话交给 Sonos，手机可离开播放页而音箱继续获取流。免费和 Premium 账号在 Sonos 上的可用功能可能不同；具体限制以 Spotify 和 Sonos 当前服务页为准。Spotify 可由 Sonos App 內瀏覽及搜尋，也可在 Spotify App 使用 Spotify Connect 選擇 Sonos 房間。後者並不等同 AirPlay：Spotify 會把播放工作階段交給 Sonos，手機離開播放頁後音箱仍會繼續取得串流。免費及 Premium 賬號在 Sonos 上可用的功能可能不同；具體限制以 Spotify 及 Sonos 目前的服務頁為準。Spotify can be browsed and searched inside Sonos, or controlled from the Spotify app by choosing a Sonos room through Spotify Connect. That second path is not AirPlay: Spotify hands the playback session to Sonos, which continues fetching the stream after the phone leaves the playback screen. Free and Premium behavior can differ. Treat the current Spotify and Sonos service pages as the authority for plan-specific limits rather than assuming an old feature matrix still applies.
若 Spotify App 能看到房间，但 Sonos App 内的 Spotify 无法浏览，通常应先重新授权内容服务，而不是重置音箱。反过来，Sonos App 能播放但 Spotify Connect 看不到房间，则更像是手机局域网发现、VPN 或 Spotify App 会话的问题。用两个入口对照，可以快速缩小范围。如 Spotify App 能看到房間，但 Sonos App 內的 Spotify 無法瀏覽，通常應先重新授權內容服務，而非重設音箱。相反，如 Sonos App 能播放但 Spotify Connect 看不到房間，則較可能是手機區域網絡發現、VPN 或 Spotify App 工作階段的問題。以兩個入口對照，可迅速縮小範圍。If the Spotify app sees a room but Spotify cannot browse inside Sonos, reauthorize the content service before resetting hardware. If Sonos plays Spotify but Spotify Connect cannot see rooms, the stronger suspects are phone-side local discovery, a VPN, or the Spotify app session. Comparing the two control paths narrows the fault domain quickly.
Apple Music 点解同账号地区有关？Apple Music 點解同賬號地區有關？Why does Apple Music depend on account region?
Apple Music 在 Sonos 中是独立的内容服务授权，不是只要 iPhone 登录 Apple ID 就一定自动可用。先在 Apple Music App 确认订阅有效、所在地区正确并能播放完整歌曲，再从 Sonos 添加服务。若家庭共享包含多个成员，每个人仍应明确自己在 Sonos 中授权的是哪个 Apple Music 账号。收藏、资料库和个性化推荐属于被授权账号，不属于某台 Sonos 音箱。Apple Music 在 Sonos 中是獨立的內容服務授權，並非只要 iPhone 登入 Apple ID 便一定自動可用。先在 Apple Music App 確認訂閱有效、所在地區正確並能播放完整歌曲，再由 Sonos 加入服務。如家人共享包括多位成員，每人仍應清楚自己在 Sonos 中授權的是哪個 Apple Music 賬號。收藏、資料庫及個人化建議屬於獲授權賬號，而非某一部 Sonos 音箱。Apple Music is authorized as a separate Sonos content service. Merely having an Apple ID signed in on the iPhone does not guarantee the Sonos connection is active. Confirm the subscription, storefront region, and full-track playback in the Apple Music app before adding it to Sonos. With Family Sharing, each person should still know which Apple Music identity they authorized in Sonos. Library content, favorites, and personalized recommendations belong to that account, not to a particular speaker.
如果 Apple Music 更换密码、订阅或地区后停止工作，优先使用 Sonos 的重新授权流程。删除并重新添加服务前先确认家庭成员是否也依赖这个授权，避免把多人使用误判为“没有影响的单人登录”。如 Apple Music 在更改密碼、訂閱或地區後停止運作，應優先使用 Sonos 的重新授權流程。刪除並重新加入服務前，先確認家人是否也依賴此授權，避免把多人使用誤判為「沒有影響的單人登入」。If Apple Music stops working after a password, subscription, or region change, use Sonos reauthorization first. Before removing and adding the service again, determine whether other household members rely on that connection. What looks like a harmless single-user login can be a shared household dependency.
一家人共用，音乐账号应该用边个？一家人共用，音樂賬號應該用邊個？Whose account should you connect in a shared home?
把音乐服务接入 Sonos 前，先确定账号属于个人还是家庭。个人推荐、播放历史和显式内容设置可能跟随服务账号，而房间本身属于 Sonos 家庭系统。客人不应把私人长期账号永久留在别人家。家庭管理员也不应使用以后会离职、搬走或停用的邮箱作为唯一授权来源。为同一服务添加多个账号后，要训练家庭成员在播放前选择正确的账号。把音樂服務接入 Sonos 前，先確定賬號屬於個人還是家庭。個人建議、播放記錄及成人內容設定可能跟隨服務賬號，而房間本身屬於 Sonos 家庭系統。訪客不應把私人長期賬號永久留在別人家中。家庭管理員亦不應使用日後會離職、搬走或停用的電郵地址作為唯一授權來源。為同一服務加入多個賬號後，應讓家人清楚在播放前選擇正確賬號。Decide whether a music identity belongs to one person or the household before connecting it. Personal recommendations, listening history, and explicit-content settings may follow the service account, while the rooms belong to the Sonos household. A guest should not leave a long-lived private login permanently in someone else’s home. The system owner should not rely on an email address that will disappear when a resident, employee, or tenant leaves. When several accounts for one provider are added, household members need to select the intended identity before playback.
更换家庭管理员或转让设备时，先在 Sonos 中移除不再授权的内容服务，再到提供商安全页面撤销旧设备会话。仅在手机上退出 Spotify 或 Apple Music 不一定会撤销 Sonos 已保存的令牌。把“在提供商端撤销”和“在 Sonos 端删除”都做完，才算真正结束访问。更換家庭管理員或轉讓裝置時，先在 Sonos 中移除不再授權的內容服務，再到供應商的保安頁面撤銷舊裝置工作階段。只在手機退出 Spotify 或 Apple Music 不一定會撤銷 Sonos 已保存的權杖。完成「在供應商端撤銷」及「在 Sonos 端刪除」，才算真正終止存取。When ownership changes or hardware is transferred, remove content services that are no longer authorized in Sonos, then revoke old-device sessions from the provider’s security page. Signing out of Spotify or Apple Music only on the phone may not invalidate the token already stored for Sonos. Access is truly ended only after both provider-side revocation and Sonos-side removal are complete.
添加 NAS 或电脑共享音乐库加入 NAS 或電腦共享音樂庫Add a NAS or computer-shared music library
当前 Sonos App 的本地音乐库要求 SMB 2 或 SMB 3 共享。Sonos S1 则依赖较旧的 SMB 1 / CIFS，这也是旧系统需要单独评估的安全原因。不要为了让 S1 读取音乐而在整个 NAS 上无差别开启 SMB 1；如果必须保留旧系统，隔离共享、限制账号权限，并理解协议风险。目前的 Sonos App 本地音樂庫要求 SMB 2 或 SMB 3 共享。Sonos S1 則依賴較舊的 SMB 1 / CIFS，這也是舊系統需要獨立評估的安全原因。不要只為讓 S1 讀取音樂而在整部 NAS 上無差別開啟 SMB 1；如必須保留舊系統，應隔離共享、限制賬號權限，並了解協議風險。The current Sonos app expects an SMB 2 or SMB 3 share for a local music library. Sonos S1 depends on older SMB 1/CIFS, which is one reason legacy systems need a separate security decision. Do not enable SMB 1 across an entire NAS merely to make S1 browse music. If a legacy system must remain, isolate the share, restrict the account, and understand the protocol risk.
创建最小权限共享建立最小權限共享Create a least-privilege share
在 NAS 创建专门用于音乐的共享文件夹和只读账号。确认路径采用 UNC 形式，例如 \\NAS-NAME\Music 或 \\192.168.1.20\Music。名称解析不稳定时 IP 路径更直接，但如果 NAS 地址会由 DHCP 改变，应先为它设置 DHCP 保留地址。账号只需读取音乐目录，不应拥有 NAS 管理员权限。在 NAS 建立專供音樂使用的共享資料夾及唯讀賬號。確認路徑採用 UNC 格式，例如 \\NAS-NAME\Music 或 \\192.168.1.20\Music。名稱解析不穩定時使用 IP 路徑較直接，但如 NAS 地址會由 DHCP 改變，應先為其設定 DHCP 保留地址。賬號只須讀取音樂目錄，不應擁有 NAS 管理員權限。Create a dedicated music share and a read-only NAS account. Use a UNC path such as \\NAS-NAME\Music or \\192.168.1.20\Music. An IP path avoids unreliable name resolution, but reserve that address in DHCP so it does not move. The Sonos library account needs read access to music, not NAS administrator privileges.
在 Sonos 添加共享文件夹在 Sonos 加入共享資料夾Add the shared folder in Sonos
在当前移动 App 进入 Settings → Music Library，选择 Add Shared Folder，输入网络路径、用户名和密码。桌面控制器可从 Manage → Music Library Settings 添加共享。添加后 Sonos 会建立索引；大型库需要时间，期间不要休眠或关闭存放音乐的电脑/NAS。在目前的流動 App 進入 Settings → Music Library，選擇 Add Shared Folder，輸入網絡路徑、使用者名稱及密碼。桌面控制器可由 Manage → Music Library Settings 加入共享。加入後 Sonos 會建立索引；大型音樂庫需要時間，期間不要讓存放音樂的電腦／NAS 進入睡眠或關機。In the current mobile app, go to Settings → Music Library, choose Add Shared Folder, then enter the network path, username, and password. On desktop, use Manage → Music Library Settings. Sonos builds an index after the share is added. Large libraries need time; keep the computer or NAS awake and reachable during the scan.
更新索引并验证元数据更新索引並驗證元資料Update the index and verify metadata
添加或删除文件后运行 Scan for New Content（扫描新内容）。桌面设置也可以安排每日自动更新。Sonos 本地音乐库最多约 65,000 首曲目，但复杂元数据可能更早耗尽可用内存。随机检查中文、英文、专辑艺术、光盘编号和多艺术家专辑；“文件能播放”不等于标签一定正确。加入或刪除檔案後執行 Scan for New Content（掃描新內容）。桌面設定亦可安排每日自動更新。Sonos 本地音樂庫最多約 65,000 首曲目，但複雜元資料可能較早耗盡可用記憶體。隨機檢查中文、英文、專輯封面、光碟編號及多位藝人專輯；「檔案能播放」不等於標籤一定正確。After adding or deleting files, run Scan for New Content. Desktop settings can also schedule a daily update. Sonos documents a music-library ceiling of about 65,000 tracks, although complex metadata can exhaust available memory earlier. Sample titles in multiple scripts, album art, disc numbers, and multi-artist albums. “The file plays” does not prove its tags are organized correctly.
验收：不要只看“已连接”驗收：不要只看「已連接」Acceptance: do not stop at “connected”
- 在线服务：从服务页播放、从全局搜索播放、切换房间播放，各完成一次。網上服務：由服務頁播放、由全域搜尋播放、切換房間播放，各完成一次。Online service: complete playback from its browse page, from global search, and after changing the target room.
- Spotify：同时验证 Sonos App 内控制和 Spotify Connect，确认看到的是正确家庭与房间。Spotify：同時驗證 Sonos App 內控制及 Spotify Connect，確認顯示的是正確家庭及房間。Spotify: verify both in-Sonos control and Spotify Connect, confirming the intended household and room.
- Apple Music：测试个人资料库歌曲和目录歌曲，确认显示的账号、收藏与推荐属于预期用户。Apple Music：測試個人資料庫歌曲及目錄歌曲，確認顯示的賬號、收藏及建議屬於預期使用者。Apple Music: test a library item and a catalog item, confirming account identity, favorites, and recommendations.
- NAS：播放一首短歌和一首长歌，跳转进度，待 NAS 重启后再次播放。NAS：播放一首短歌及一首長歌，跳轉進度，待 NAS 重新啟動後再次播放。NAS: play a short and a long track, seek within one, restart the NAS, and play again after it returns.
- 多房间：把已验证内容临时编组到第二间房，检查同步和独立音量。多房間：把已驗證內容臨時分組至第二個房間，檢查同步及獨立音量。Multi-room: group the validated source into a second room and check synchronization and per-room volume.
修改最少原则：单个服务失效时先重新授权该服务；NAS 单个目录缺失时先修正共享或标签。不要因为内容问题就重置整个 Sonos 系统。最少改動原則：單一服務失效時先重新授權該服務；NAS 單一目錄缺失時先修正共享或標籤。不要因內容問題而重設整個 Sonos 系統。Minimum-change rule: reauthorize one failed service, or repair one NAS share/tag problem. Do not factory-reset an entire Sonos system for a content-layer failure.
服务加不进去、反复要求登录、或者搜得到播不了?先定位卡在哪一关:服務加不進去、反覆要求登入、或者搜得到播不了?先定位卡在哪一關:If a service will not add, keeps asking you to sign in, or finds tracks but will not play, locate the failing gate first: 音乐服务连不上或播不了音樂服務連不上或播不了Music service won't connect or play
官方资料官方資料Official references
- 向 Sonos 添加内容服务向 Sonos 加入內容服務Add a content service to Sonos
- 无法添加内容服务無法加入內容服務Unable to add a content service
- Sonos 上的 SpotifySonos 上的 SpotifySpotify on Sonos
- 添加本地音乐库加入本地音樂庫Add your music library
- 在 Sonos 使用 NAS在 Sonos 使用 NASUse a NAS drive with Sonos
- 更新音乐库索引更新音樂庫索引Update the Sonos music library
几个音乐 App，可以一次搜完幾個音樂 App，可以一次搜完Search every music service at once
Apple Music、Spotify、网易云、QQ 音乐在 ZoneFoundry 里共用同一个搜索框，找到就直接推到 Sonos，不用来回切 App 再投一次。Apple Music、Spotify、網易雲、QQ 音樂在 ZoneFoundry 裏共用同一個搜尋框，找到就直接推去 Sonos，不用來回切 App 再投一次。Apple Music, Spotify, NetEase and QQ Music share one search box in ZoneFoundry. Find a track and it goes straight to Sonos — no switching apps to cast it again.
下一步下一步Next
完成第一次 Sonos 系统设置 →完成第一次 Sonos 系統設置 →Complete first-time Sonos setup →
把音乐正确分配到编组、立体声或家庭影院 →把音樂正確分配至分組、立體聲或家庭影院 →Choose groups, stereo, or home theater correctly →
了解 S1 的 NAS 与服务限制 →了解 S1 的 NAS 及服務限制 →Understand S1 service and NAS limits →
音乐服务已在 Sonos 端正常工作后，ZoneFoundry 可作为第三方入口补充跨服务搜索和多房间控制；它不替代提供商订阅或 Sonos 的服务授权。音樂服務已在 Sonos 端正常運作後，ZoneFoundry 可作為第三方入口，補充跨服務搜尋及多房間控制；它不會取代供應商訂閱或 Sonos 的服務授權。Once a service works in Sonos, ZoneFoundry can add a third-party search and multi-room control surface. It does not replace the provider subscription or Sonos authorization.