simojenki/bonob

Sonos-Navidrome桥接工具镜像

镜像概述

本Docker镜像提供Sonos音响系统与Navidrome音乐服务器之间的桥接功能，解决Sonos原生不支持直接访问Navidrome音乐资源的问题。通过该镜像，用户可在Sonos设备上发现、浏览并播放存储在Navidrome中的音乐，实现音乐库统一管理与跨平台播放控制。

核心功能和特性

• 设备集成：自动发现局域网内的Sonos设备，建立与Navidrome服务器的稳定连接
• 音乐库同步：同步Navidrome中的音乐元数据（艺术家、专辑、曲目信息）及播放列表至Sonos系统
• 播放控制：支持通过Sonos控制器（App/语音助手）对Navidrome音乐进行播放、暂停、上一曲/下一曲、音量调节等操作
• 多房间音频：兼容Sonos多房间音频功能，可在多个Sonos设备上同步播放Navidrome音乐
• 配置灵活：支持通过环境变量或配置文件自定义Navidrome连接参数、设备过滤规则等
• 轻量稳定：基于轻量基础镜像构建，资源占用低，运行稳定

使用场景和适用范围

适用场景

• 家庭音乐系统用户：需在Sonos设备上统一访问本地音乐与Navidrome云音乐资源
• Navidrome用户：希望通过Sonos音响播放存储在Navidrome中的音乐库
• 多设备协同场景：需通过Sonos控制器管理Navidrome音乐播放，实现跨设备控制

适用范围

• 运行环境：支持Docker的Linux、Windows、macOS系统
• 依赖条件：需已部署Sonos设备（同一局域网）及Navidrome服务器（可访问的API地址）

使用方法和配置说明

前置条件

1. 已安装Docker Engine（20.10+版本推荐）
2. 局域网内存在可正常工作的Sonos设备
3. Navidrome服务器已运行，且可通过网络访问（需获取API基础地址及访问凭证）

Docker Run命令示例

bash
docker run -d \
  --name sonos-navidrome-bridge \
  --net=host \  # 需使用host网络确保Sonos设备发现（部分环境必要）
  -e NAVIDROME_URL="http://navidrome-ip:4533" \  # Navidrome服务器API地址
  -e NAVIDROME_USER="your-navidrome-username" \  # Navidrome登录用户名
  -e NAVIDROME_PASSWORD="your-navidrome-password" \  # Navidrome登录密码或API密钥
  -e SONOS_DEVICE_FILTER="Living Room;Bedroom" \  # 可选，指定允许访问的Sonos设备（分号分隔）
  -v /path/to/local/config:/app/config \  # 挂载配置目录持久化设置
  --restart unless-stopped \
  [镜像名称:版本]  # 替换为实际镜像名称（如ghcr.io/username/sonos-navidrome-bridge:latest）

Docker Compose配置示例

yaml
version: '3'
services:
  sonos-navidrome-bridge:
    image: [镜像名称:版本]
    container_name: sonos-navidrome-bridge
    network_mode: host  # 推荐使用host网络确保Sonos发现功能
    restart: unless-stopped
    environment:
      - NAVIDROME_URL=http://navidrome-ip:4533  # 替换为实际Navidrome地址
      - NAVIDROME_USER=navidrome-user  # 替换为Navidrome用户名
      - NAVIDROME_PASSWORD=navidrome-pass  # 替换为Navidrome密码或API密钥
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - SONOS_DISCOVERY_INTERVAL=300  # Sonos设备发现间隔（秒）
      - SYNC_INTERVAL=3600  # 音乐库同步间隔（秒）
    volumes:
      - ./bridge-config:/app/config  # 本地目录挂载，保存配置文件

环境变量配置说明

启动后验证

1. 查看容器日志确认运行状态：

   bash
   docker logs sonos-navidrome-bridge
   

   正常日志应包含"Sonos devices discovered: [设备名称]"及"Navidrome connection established"等信息。

2. 打开Sonos控制器App，在"音乐源"中查找新增的Navidrome相关源（通常名为"Navidrome Bridge"）。

3. 选择该源，浏览音乐库并尝试播放，验证播放控制功能是否正常。

注意事项

• 网络要求：容器与Sonos设备需在同一局域网，推荐使用--net=host网络模式（部分Docker环境如macOS可能需调整端口映射）。
• Navidrome配置：确保Navidrome启用API访问（默认启用），建议使用API密钥代替密码进行认证。
• 防火墙设置：需允许容器访问Sonos设备端口（1400/UDP等）及Navidrome服务器端口。
• 持久化配置：挂载/app/config目录可避免容器重建后配置丢失，包含设备列表、同步状态等数据。