Übersicht

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.

Laufzeit-Argumente

Netzwerk: host
Shell: sh
Privilegiert: false
Extra Params: --cap-drop ALL --read-only --tmpfs /tmp:rw,nosuid,nodev,size=16m --group-add 281

Konfiguration der Vorlage

Relay URLVariable

ZoneFoundry cloud relay WebSocket URL.

Ziel: ZF_RELAY_URL
Standard: wss://relay.zonefoundry.dev/ws
Wert: 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.

Ziel: 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.

Ziel: ZF_USER_ID

Agent Secret (override)Variable

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

Ziel: ZF_AGENT_SECRET

Connector ID (override)Variable

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

Ziel: 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).

Ziel: /app/data
Standard: /mnt/user/appdata/zonefoundry-bridge
Wert: /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.

Ziel: /var/run/docker.sock
Standard: /var/run/docker.sock
Wert: /var/run/docker.sock

Links

Vorlage Unterstützung Docker-Hub Project

Einzelheiten

Repository

zonefoundry/bridge:latest

Registry

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

Zuletzt aktualisiert2026-05-03

Erstmals gesehen2026-05-06

Führen Sie zf-bridge-unraid auf Unraid aus.

zf-bridge-unraid ist gelistet in Community Apps für Unraid OS. Erkunden Sie Unraid, um einen flexiblen Heimserver, ein NAS oder ein Heimlabor aufzubauen.

Erkunden Sie Unraid OS

zf-bridge-unraid