概述

ZoneFoundry Bridge — connects your Sonos system to ZoneFoundry's iOS app, voice assistant, and IM bots (Telegram, WeChat, QQ) via the cloud relay. First launch: pair with a one-time code from your iOS app, container persists credentials in /app/data and reuses on restart. 1-tap updates: the iOS app's Bridges screen surfaces "升级" / "Apply Update" when a new bridge image is published — tap once and the bridge pulls the new image via the mounted docker socket and restarts itself. No SSH or Container Manager interaction needed. Host network mode is required so the bridge can SSDP-discover Sonos speakers on your LAN. Container runs as non-root user (UID 10001) with --cap-drop ALL — make sure the host data path is chowned 10001:10001. The docker socket mount and --group-add 281 (Unraid's docker group GID) grant the bridge permission to pull new images for self-update; remove them if you prefer manual updates only.

运行时参数

网络: host
外壳: sh
特权: false
额外参数: --cap-drop ALL --read-only --tmpfs /tmp:rw,nosuid,nodev,size=16m --group-add 281

模板配置

Relay URLVariable

ZoneFoundry cloud relay WebSocket URL.

目标: ZF_RELAY_URL
默认值: wss://relay.zonefoundry.dev/ws
价值: wss://relay.zonefoundry.dev/ws

Pair Code (first launch only)Variable

One-time 6-letter code from your iOS app's Add Bridge screen. Only needed for first launch — once paired, container caches credentials in /app/data and you can clear this field.

目标: ZF_PAIR_CODE

User ID (override)Variable

Advanced: explicit user_id from existing pairing (skips pair-code redeem). Leave empty to use pair code instead.

目标: ZF_USER_ID

Agent Secret (override)Variable

Advanced: explicit secret matching User ID. Leave empty to use pair code instead.

目标: ZF_AGENT_SECRET

Connector ID (override)Variable

Advanced: explicit connector identity for multi-bridge users. Leave empty for default-legacy.

目标: ZF_CONNECTOR_ID

Data VolumePathrw

Persistent data: cached pairing credentials. Must be chowned 10001:10001 on host (chown -R 10001:10001 /mnt/user/appdata/zonefoundry-bridge).

目标: /app/data
默认值: /mnt/user/appdata/zonefoundry-bridge
价值: /mnt/user/appdata/zonefoundry-bridge

Docker Socket (1-tap update)Pathrw

Mounts the host's docker socket so the bridge can pull and apply its own image updates when you tap '升级' / 'Apply Update' in the iOS app's Bridges screen. Combined with --group-add 281 in Extra Parameters, the non-root bridge user gets permission to talk to Docker. Remove this mount and the --group-add flag if you prefer to update manually via Apply Update on this template.

目标: /var/run/docker.sock
默认值: /var/run/docker.sock
价值: /var/run/docker.sock

类别

Home Automation Other

下载统计数据

152

下载总数

链接

模板支持 Docker Hub Pro连接

详细信息

存储库

zonefoundry/bridge:latest

登记处

https://hub.docker.com/r/zonefoundry/bridge

最后更新2026-05-03

初见2026-05-06

在Unraid 上运行 zf-bridge-unraid 。

zf-bridge-unraid 已被列入Unraid OS 的社区应用程序。探索Unraid ，构建灵活的家庭服务器、NAS 或家庭实验室。

探索Unraid OS