Vue d'ensemble

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.

Arguments d'exécution

Réseau: host
Coquille: sh
Privilégié: false
Paramètres supplémentaires: --cap-drop ALL --read-only --tmpfs /tmp:rw,nosuid,nodev,size=16m --group-add 281

Configuration du modèle

Relay URLVariable

ZoneFoundry cloud relay WebSocket URL.

Cible: ZF_RELAY_URL
Défaut: wss://relay.zonefoundry.dev/ws
Valeur: 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.

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

Cible: ZF_USER_ID

Agent Secret (override)Variable

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

Cible: ZF_AGENT_SECRET

Connector ID (override)Variable

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

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

Cible: /app/data
Défaut: /mnt/user/appdata/zonefoundry-bridge
Valeur: /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.

Cible: /var/run/docker.sock
Défaut: /var/run/docker.sock
Valeur: /var/run/docker.sock

Liens

Modèle Soutien Hub Docker Proprojet

Détails

Référentiel

zonefoundry/bridge:latest

Registre

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

Dernière mise à jour2026-05-03

Première vue2026-05-06

Exécutez zf-bridge-unraid sur Unraid.

zf-bridge-unraid est listé dans Community Apps pour Unraid OS. Explorez Unraid pour créer un serveur domestique flexible, un NAS ou un laboratoire domestique.

Explorez Unraid OS

zf-bridge-unraid