parkr/airconnect

AirPlay for Sonos Docker镜像

镜像概述

该Docker镜像为Sonos设备提供AirPlay协议支持，使Sonos扬声器能够接收来自iOS设备、macOS、Windows及其他支持AirPlay的设备的音频流，无需对Sonos设备进行固件修改，简化多设备音频投射体验。

核心功能与特性

• AirPlay协议支持：兼容AirPlay 1及AirPlay 2标准，支持主流设备的音频投射
• 自动设备发现：自动识别局域网内的Sonos扬声器，无需手动配置设备IP
• 低延迟传输：优化音频传输延迟，确保播放同步性
• 多房间支持：可将音频同时投射到多个Sonos扬声器（需Sonos系统支持）
• 轻量化设计：镜像体积小，资源占用低，适合长期运行

使用场景

• 家庭音频系统：将手机、平板等设备的音频无线投射到Sonos扬声器
• 多房间音频同步：在不同房间的Sonos设备上同步播放同一音频源
• 办公环境：会议室Sonos音响接收电脑或移动设备的演示音频
• 智能家居集成：作为家庭自动化系统的音频输出节点

使用方法

基本部署（docker run）

bash
docker run -d \
  --name airplay-sonos \
  --net=host \
  --restart=unless-stopped \
  -e AIRPLAY_NAME="Sonos AirPlay" \
  -e LOG_LEVEL=info \
  your-registry/airplay-sonos:latest

Docker Compose配置

yaml
version: '3'
services:
  airplay-sonos:
    image: your-registry/airplay-sonos:latest
    container_name: airplay-sonos
    network_mode: host
    restart: unless-stopped
    environment:
      - AIRPLAY_NAME="Living Room Sonos"  # AirPlay设备显示名称
      - LOG_LEVEL=info                    # 日志级别：debug/info/warn/error
      - DISCOVERY_INTERVAL=30             # Sonos设备发现间隔（秒）
      - PORT=5000                         # AirPlay服务端口

环境变量说明

注意事项

• 必须使用--net=host网络模式，以确保设备发现和音频传输正常
• 容器需与Sonos设备在同一局域网内
• 首次启动可能需要30秒-1分钟完成Sonos设备发现
• 支持大多数Sonos扬声器型号，包括One、Play:5、Arc等

故障排除

• 设备未发现：检查容器网络模式是否为host，Sonos设备是否在线
• 音频卡顿：尝试降低网络负载，或调整DISCOVERY_INTERVAL增大间隔
• 连接失败：检查防火墙是否阻止了5000端口（或自定义端口）的UDP/TCP流量