先搞清楚:你需要 Bridge 吗?播放、分组、逐房音量、语音、收藏与资料库浏览、播报后自动恢复——这些纯 Wi-Fi 都能用,不需要 Bridge。只有这几样才需要本地 Bridge:跨服务的「任意歌名」搜索、由 Apple Home 自动化触发 ZoneFoundry、以及「到家 / 离家」这类常驻在线才做得到的自动化。如果暂时用不上,大可跳过这篇。
开始前你需要
- 一台常开、装了 Docker 的机器:NAS(群晖、威联通)、Unraid、迷你主机或旧电脑都行,和 Sonos 在同一个本地网络
- ZoneFoundry iPhone app,已经能正常看到并控制你的 Sonos 房间
步骤
从哪里装？三条路装出来的是同一个 Bridge，差别只在「模板新不新」：
· 直接 Docker 命令（下面这条）—— 永远是最新镜像，推荐。
· 飞牛 fnOS 应用中心—— 我们持续更新，装完即是新版。
· Unraid App Store（Community Applications）—— 目前上架的是较早的模板版本，暂时没有跟进更新；用它装完之后，容器本身仍会通过 iOS app 的「升级」按钮拉到最新镜像，所以不影响使用。
用 Docker 跑起 Bridge 容器
Bridge 要用 host 网络模式(它靠本地网络发现你的 Sonos 音箱),并挂一个目录存配置。在你的机器上跑:
docker run -d \
--name zonefoundry-bridge \
--network host \
--restart unless-stopped \
--cap-drop ALL \
-e ZF_RELAY_URL=wss://relay.zonefoundry.dev/ws \
-e ZF_PAIR_CODE=<iOS app 里的 6 位配对码> \
-v /path/to/zf-bridge:/app/data \
-v /var/run/docker.sock:/var/run/docker.sock \
zonefoundry/bridge:latest把 /path/to/zf-bridge 换成你机器上真实的目录。三个要点:① 容器里的数据路径是 /app/data（配对凭证存这里，重启后不用再配对）；② 容器以非 root 用户 10001 运行，所以宿主目录要先 chown -R 10001:10001 /path/to/zf-bridge，否则起不来；③ 挂 docker.sock 是为了让 iOS app 里的「升级」按钮能直接拉新镜像 —— 不想要一键升级的话，把这行删掉，改成日后手动 docker pull 即可。
用 Unraid / 群晖 / 飞牛的图形界面装？照同样几项设即可:host 网络、映射 /app/data、填 ZF_RELAY_URL 和配对码。Unraid 还要在 Extra Parameters 加 --group-add 281（Unraid 的 docker 组 GID），一键升级才有权限调用 docker。
/app/data 卷、relay 地址。（此图为 Unraid 英文界面，各平台后台语言跟你自己的设定。）在 app 里连上这台 Bridge
容器跑起来后,打开 ZoneFoundry,到「设置 → 桥接」。同一网络下 app 通常会自动发现这台 Bridge;没自动出来就手动填它的本地 IP。连上后,状态会显示「已连接」。
确认 Bridge 带来的那几项已经生效
先说清楚:播放控制、多房间、音乐搜索、语音助手、场景、广播这些,本来就不用 Bridge,装之前装之后都一样。Bridge 真正带来的是这三件:① 房间进 Apple「家庭」——变成可开关的配件，Siri 和家庭自动化都能驱动;② 到家／离家自动触发场景;③ Apple Music 的电台与推荐架、Plex 个人资料库。另外日常操作会更快，因为指令走本地直连而不绕云。哪天关掉 Bridge，上面这三件会暂停，其余功能照常。
连不上?先确认三件事:① 容器是用 --network host 跑的(桥接网络发现不到 Sonos);② Bridge 机器和 Sonos、你的 iPhone 在同一个局域网、同一网段;③ 机器防火墙没挡住本地发现。三样齐了,自动发现基本都能成。
不想登云，也有得用
ZoneFoundry 支持局域网直连控制，不依赖 Sonos 云账号；想用云端功能再登也不迟。Bridge 是可选增强，不是入场券。