logicwar/logitechmediaserver

Logitech Media Server Docker容器

概述

本Docker镜像基于phusion/baseimage构建，用于运行最新版本的Logitech Media Server 8.3.1。Logitech Media Server（前身为SlimServer、SqueezeCenter和Squeezebox Server）是由Logitech（前Slim Devices）支持的流媒体音频服务器，专为支持其Squeezebox系列数字音频接收器而开发。该软件为免费开源项目，遵循GNU通用公共许可证。

核心功能和特性

• 支持Squeezebox系列数字音频接收器的流媒体服务
• 提供Web管理界面，用于配置服务器、管理音乐库和播放列表
• 支持本地音乐文件和播放列表的挂载与管理
• 可通过环境变量配置用户权限、时区等参数
• 支持软件升级功能，无需等待Docker镜像更新

使用场景和适用范围

• 家庭音频流媒体服务搭建
• Squeezebox设备用户的音频服务器部署
• 需要集中管理音乐库和播放设备的场景
• 希望通过Docker简化服务器部署和管理的用户

使用方法

基本部署命令

bash
docker create --name=lms \ 
              -v <配置文件路径>:/config \
              -v <音乐文件路径>:/music:ro \
              -v <播放列表路径>:/playlist:ro \
              -e PGID=<组ID> \
              -e PUID=<用户ID> \
              -e TZ=<时区> \
              -p 9000:9000 \
              -p 3483:3483 \
              -p 3483:3483/udp \
              logicwar/logitechmediaserver

参数说明

端口映射

• -p 9000:9000：Web界面和Squeezebox播放器流传输端口
• -p 3483:3483：Squeezebox设备控制通道端口（显示、红外等）
• -p 3483:3483/udp：旧版SLIMP3播放器的控制和流传输端口

数据卷

• -v /config：LMS配置文件和日志文件存储路径
• -v /music：本地音乐文件路径（只读）
• -v /playlist：本地播放列表路径（只读）

环境变量

• -e PGID：组ID，用于权限控制（见下文用户/组ID说明）
• -e PUID：用户ID，用于权限控制（见下文用户/组ID说明）
• -e TZ：时区信息，如Europe/London、Europe/Zurich、America/New_York等（时区列表参考tz数据库时区列表）

容器内Shell访问

运行中的容器可通过以下命令进入Shell：

bash
docker exec -it lms /bin/bash

用户/组ID设置

为避免数据卷（-v参数）的权限问题，建议创建专用"docker"用户并配置适当权限。可通过id <用户>命令获取用户ID（PUID）和组ID（PGID）：

bash
$ id <dockeruser>
  uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

示例中PUID=1001，PGID=1001，部署时需指定相应值。

应用设置

初始配置通过访问http://服务器IP:9000完成，在Web界面中可进行音乐库设置、设备管理等操作。

软件升级

当LMS有新版本发布时，Web界面状态栏会显示更新提示。升级步骤：

1. 点击状态栏更新链接或进入"设置->高级->软件更新"，点击"立即检查更新"
2. 点击"点击此处获取更多信息"，查看升级指南（LMS会后台下载deb包）
3. 通过docker exec -it lms /bin/bash进入容器终端，按照指南执行升级步骤
4. 完成后停止并重启容器

版本历史

• V0.5：更新至8.3.1-***，基于phusion/baseimage focal-1.2.0
• V0.4：更新至8.1.1-***，基于phusion/baseimage focal-1.0.0
• V0.3：更新至7.9.2-***
• V0.2：更新至7.9.1-***
• V0.1：初始版本7.9.1-***