Visión general

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.

Argumentos en tiempo de ejecución

Red: host
Concha: sh
Privilegiado: false
Parámetros adicionales: --cap-drop ALL --read-only --tmpfs /tmp:rw,nosuid,nodev,size=16m --group-add 281

Configuración de plantillas

Relay URLVariable

ZoneFoundry cloud relay WebSocket URL.

Objetivo: ZF_RELAY_URL
Por defecto: wss://relay.zonefoundry.dev/ws
Valor: 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.

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

Objetivo: ZF_USER_ID

Agent Secret (override)Variable

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

Objetivo: ZF_AGENT_SECRET

Connector ID (override)Variable

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

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

Objetivo: /app/data
Por defecto: /mnt/user/appdata/zonefoundry-bridge
Valor: /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.

Objetivo: /var/run/docker.sock
Por defecto: /var/run/docker.sock
Valor: /var/run/docker.sock

Enlaces

Plantilla Ayuda Centro Docker Project

Detalles

Repositorio

zonefoundry/bridge:latest

Registro

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

Última actualización2026-05-03

Visto por primera vez2026-05-06

Ejecute zf-bridge-unraid en Unraid.

zf-bridge-unraid se encuentra en Community Apps para Unraid OS. Explore Unraid para crear un servidor doméstico flexible, un NAS o un laboratorio doméstico.

Explore Unraid OS

zf-bridge-unraid