svrooij/sonos2mqtt Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Sonos2mqtt

镜像概述和主要用途

Sonos2mqtt是一个Node.js应用，作为Sonos音箱与MQTT服务器之间的桥接工具。它能实时将所有Sonos设备的状态（如播放状态、音量、曲目信息等）发布到MQTT主题，并允许通过MQTT消息实现对Sonos音箱的控制。该工具旨在作为异构智能家居环境的构建块，适用于以MQTT消息代理作为中央消息总线的场景。

核心功能和特性

• 状态发布：自动发现Sonos设备并将其状态（播放/暂停、音量、当前曲目、艺术家等）实时发布到MQTT主题。
• MQTT控制：支持通过MQTT消息控制Sonos设备，包括播放/暂停、音量调节、曲目切换、播放模式调整等操作。
• 高级功能：集成通知和文本转语音（TTS）功能，可向Sonos音箱发送语音通知。
• 可靠依赖：基于开发者自主开发的node-sonos-ts库，确保与Sonos设备的稳定通信和功能扩展。

使用场景和适用范围

• 智能家居集成：将Sonos音箱无缝集成到以MQTT为核心的智能家居系统中，实现与其他智能设备的联动。
• 自动化场景：通过MQTT消息触发Sonos设备动作，如根据家庭活动状态自动调整音乐播放。
• 远程控制：通过MQTT协议实现对Sonos设备的远程监控和控制。

使用方法和配置说明

Docker部署

基本运行命令

bash
docker run -d \
  --name sonos2mqtt \
  --net=host \  # 推荐使用host网络以确保Sonos设备发现功能正常
  -e MQTT_HOST=your-mqtt-broker-ip \  # MQTT服务器地址（必填）
  -e MQTT_PORT=1883 \  # MQTT服务器端口（可选，默认1883）
  -e MQTT_USER=your-mqtt-username \  # MQTT认证用户名（可选）
  -e MQTT_PASSWORD=your-mqtt-password \  # MQTT认证密码（可选）
  svrooij/sonos2mqtt

Docker Compose配置示例

yaml
version: '3'
services:
  sonos2mqtt:
    image: svrooij/sonos2mqtt
    network_mode: host  # 确保Sonos设备发现正常
    environment:
      - MQTT_HOST=mqtt.example.com
      - MQTT_PORT=1883
      - MQTT_USER=mqtt-user
      - MQTT_PASSWORD=mqtt-pass
      - MQTT_PREFIX=sonos  # MQTT主题前缀（可选，默认"sonos"）
      - DEBUG=false  # 是否启用调试模式（可选，默认false）
    restart: unless-stopped

环境变量配置

MQTT主题说明

• 状态发布主题：sonos/<房间名>/state
  发布特定房间Sonos设备的状态信息（JSON格式），包含播放状态、音量、当前曲目等。

• 控制主题：sonos/<房间名>/set
  发送控制命令（JSON格式），例如：

  • 播放：{"state":"play"}
  • 暂停：{"state":"pause"}
  • 调整音量：{"volume":20}（0-100）
  • 文本转语音：{"tts":"欢迎回家"}

依赖说明

该工具依赖node-sonos-ts库，该库提供Sonos设备通信的核心功能，支持通知、文本转语音等高级特性。更多详细文档请访问官方文档。