onmomo/squeeze-plex-hub

Squeeze Plex Hub

概述

Squeeze Plex Hub 是连接 Plexamp（Plex）与 Logitech/Lyrion 音乐服务器生态系统的桥梁工具，使您能够在 Squeezebox（及兼容）播放器上播放 Plex 音频。

核心功能和特性

• 自动发现 LMS 实例和连接的 Squeeze 播放器
• 向 Plexamp 广播发现的 Squeeze 播放器，使其作为可选择的目标显示并支持完整的 Plexamp 控制
• 支持使用 Plexamp 控制 Squeezebox 播放器实现多房间音频播放
• 显示播放器和服务器元数据
• 基于 Docker 的简单部署
• 结合 https://github.com/onmomo/lms-squeeze-plex-hub 在 LMS 上实现完整曲目元数据支持

需求

• 运行中的 Lyrion 音乐服务器（前身为 Logitech Media Server），且至少连接一个播放器
  • 启用 LMS JSON/CLI 接口（默认启用）
  • （可选）启用 https://github.com/onmomo/lms-squeeze-plex-hub 以在 LMS 上获得完整曲目元数据支持
• 用于流媒体的 Plex 媒体服务器（需包含音频库），Lyrion 音乐服务器无需额外媒体
• 登录同一 Plex 账户的 Plexamp 客户端（桌面或移动版）
• 网络：Squeeze Plex Hub 必须能够访问 LMS 和 Plexamp 客户端（通常在同一局域网内）

使用方法

运行 Squeeze Plex Hub

sh
docker run -d \
   --network host \
   --name squeeze-plex-hub \
   onmomo/squeeze-plex-hub:latest

启动后：

1. 在浏览器中访问 http://localhost:3000 以打开 Squeeze Plex Hub 网页界面。
2. 应用程序将显示所有发现的 Squeezebox 播放器和 Lyrion 音乐服务器（前身为 Logitech Media Server）及其元数据。使用该界面确认哪些 Squeezebox 播放器可通过 Plexamp 控制。
3. 使用 Plexamp 选择发现的 Squeezebox 播放器进行播放。

安全说明

应用程序从不存储 Plex 凭据。它仅在本地网络中发现 LMS 和 Plex 服务，启动播放时会转发 Plex 令牌，使 Squeezebox 播放器能够直接从 Plex 媒体服务器流式传输。该令牌不会持久化存储，且会在一段时间后过期。

容器网络配置

Squeeze Plex Hub 通过端口 32412 监听来自 Plex 客户端的 UDP 广播，并响应发现的播放器。因此，确保其能够在该特定端口接收 UDP 请求至关重要：

• 为获得最佳效果，Plex 服务器（PMS）容器应运行在 host 或 bridge 网络模式下，且始终将 Squeeze Plex Hub 运行在 host 网络模式下。这确保连接到本地网络的移动设备上的 Plexamp 客户端能够发现 Squeezebox 播放器。Docker 不会将来自主机网络（如移动设备）的 UDP 数据包转发到桥接网络。
• 重要：如果 Plex 服务器运行在 host 模式下，务必先启动 Squeeze Plex Hub，再启动 Plex 服务器，以确保其始终绑定 UDP 端口 32412。如果 Plex 服务器先启动并绑定该端口，Squeeze Plex Hub 将无法正常工作并最终崩溃。
• 在 bridge 模式下，不要为 Plex 服务器绑定 UDP 端口 32412，此时启动顺序无关紧要。
• 如果无法绑定 UDP 端口 32412，Squeeze Plex Hub 容器将崩溃。