syphr/logitechmediaserver

Logitech Media Server Docker镜像

支持的标签及对应Dockerfile链接

• https://github.com/syphr42/docker-logitechmediaserver/blob/master/Dockerfile
• https://github.com/syphr42/docker-logitechmediaserver/blob/master/Dockerfile
• https://github.com/syphr42/docker-logitechmediaserver/blob/master/Dockerfile
• https://github.com/syphr42/docker-logitechmediaserver/blob/master/Dockerfile
• https://github.com/syphr42/docker-logitechmediaserver/blob/master/Dockerfile

镜像概述

Logitech Media Server是一款用于控制物理和虚拟音乐播放器（如Squeezebox）的软件系统。更多信息请参见：***。

该Docker镜像封装了Logitech Media Server，便于快速部署和管理，支持配置持久化、媒体文件挂载及多环境部署。

核心功能与特性

• 支持控制物理和虚拟音乐播放器
• 配置数据持久化存储
• 媒体文件外部挂载
• 提供Web管理界面（9000端口）和命令行接口（9090端口）
• 支持流传输和设备发现（3483端口TCP/UDP）
• 兼容Docker、NFS和Kubernetes部署环境

使用场景

• 家庭音乐中心搭建
• 多房间音频系统控制
• 个人媒体服务器部署
• 企业或组织内部音乐播放管理

使用方法

基本部署

创建容器时，需将/var/lib/squeezeboxserver目录挂载到主机卷以持久化配置，同时挂载媒体文件目录（如/data/media）供LMS设置时选择。

bash
docker run \
        --name logitechmediaserver \
        --publish 9000:9000/tcp \
        --publish 9090:9090/tcp \
        --publish 3483:3483/tcp \
        --publish 3483:3483/udp \
        --volume /data/lms:/var/lib/squeezeboxserver \
        --volume /data/media:/data/media \
        --detach \
        --restart always \
        syphr/logitechmediaserver

访问方式

• Web应用：http://localhost:9000
• 命令行接口：通过9090端口访问
• 流传输与发现：使用3483端口（TCP/UDP）

镜像地址：https://hub.docker.com/r/syphr/logitechmediaserver

NFS配置

若使用NFS挂载/var/lib/squeezeboxserver目录，且NFS导出配置了all_squash或root_squash选项，需覆盖镜像的默认命令或入口点。原因是默认入口点脚本会尝试使用非root用户（squeezeboxserver）对/var/lib/squeezeboxserver执行chown操作，而NFS的squash选项会阻止权限更改，导致容器启动失败。

同时，挂载点需指定为nocopy，避免Docker尝试复制容器内目录内容及权限（同样会因NFS权限限制失败）。

bash
docker run \
        --name logitechmediaserver \
        --publish 9000:9000/tcp \
        --publish 9090:9090/tcp \
        --publish 3483:3483/tcp \
        --publish 3483:3483/udp \
        --volume /data/lms:/var/lib/squeezeboxserver:nocopy \
        --volume /data/media:/data/media \
        --detach \
        --restart always \
        --entrypoint squeezeboxserver \
        syphr/logitechmediaserver

Kubernetes部署

通过Helm Chart可简化Kubernetes环境下的部署，详见https://github.com/syphr42/helm/tree/main/charts/logitech-media-server%E3%80%82%E6%9C%80%E6%96%B0%E7%89%88%E6%9C%AC%E5%AE%89%E8%A3%85%E5%91%BD%E4%BB%A4%EF%BC%9A

bash
helm install --repo https://syphr42.github.io/helm lms logitech-media-server