Logitech Media Server Docker镜像文档

1. 镜像概述和主要用途

Logitech Media Server Docker镜像是用于运行Logitech Media Server（曾用名：SqueezeCenter、SqueezeboxServer、SlimServer）的容器化解决方案。该镜像提供了便捷的部署方式，旨在简化Logitech Media Server的安装与管理流程。

主要用途：作为流媒体服务器，支持将音频等媒体文件流式传输至Logitech Squeezebox系列设备及其他兼容客户端，实现家庭或小型网络内的媒体共享与播放控制。

2. 核心功能和特性

• 系统自动更新：容器重启时会自动应用安全更新及Linux系统更新，保障运行环境安全性。
• 版本支持：基于Logitech Media Server 8.5版本构建，兼容最新功能特性。
• Web管理界面：提供HTTP（9000端口）和HTTPS（9090端口）两种Web管理接口，便于配置服务器参数、管理媒体库及设备。
• 持久化存储：支持配置文件与媒体文件的持久化存储，通过卷挂载确保数据不丢失。
• 跨平台兼容：原生支持Unraid系统，可通过Unraid Community Applications（CA）一键安装。

3. 使用场景和适用范围

适用场景

• 家庭或小型网络环境中搭建私有音频流媒体服务器。
• 需要通过Logitech Squeezebox设备（如Squeezebox Touch、Radio等）播放本地媒体库的场景。
• 追求简化部署流程，避免复杂系统配置的用户。

适用范围

• 硬件环境：支持Docker的x86_64架构设备（优先推荐Unraid服务器）。
• 用户群体：家庭用户、小型媒体中心管理员、Logitech Squeezebox设备用户。

4. 使用方法和配置说明

4.1 快速启动（Unraid环境）

通过docker run命令直接部署：

docker run -d \
  --name="LogitechMediaServer" \
  --net="bridge" \
  -p 3483:3483/tcp \  # 服务器通信端口
  -p 9000:9000/tcp \  # HTTP Web管理端口
  -p 9090:9090/tcp \  # HTTPS Web管理端口
  -e PUID="99" \       # 容器内运行用户ID（Unraid默认用户ID）
  -e PGID="100" \      # 容器内运行组ID（Unraid默认用户组ID）
  -e TZ="America/New_York" \  # 时区设置（需替换为实际时区，如Asia/Shanghai）
  -v "/mnt/user/appdata/LogitechMediaServer":"/config":rw \  # 配置文件存储目录
  -v "/mnt/user/Music":"/music":rw \  # 媒体文件目录（需替换为实际媒体路径）
  dlandon/logitechmediaserver

4.2 Docker Compose配置示例

创建docker-compose.yml文件，内容如下：

version: '3'
services:
  logitechmediaserver:
    image: dlandon/logitechmediaserver
    container_name: LogitechMediaServer
    network_mode: bridge
    ports:
      - "3483:3483/tcp"
      - "9000:9000/tcp"
      - "9090:9090/tcp"
    environment:
      - PUID=99          # 用户ID（根据实际环境调整，如Unraid默认99）
      - PGID=100         # 组ID（根据实际环境调整，如Unraid默认100）
      - TZ=Asia/Shanghai # 时区（例如：Asia/Shanghai、Europe/London等）
    volumes:
      - "/mnt/user/appdata/LogitechMediaServer:/config:rw"  # 配置文件目录
      - "/mnt/user/Music:/music:rw"                        # 媒体文件目录
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

启动命令：docker-compose up -d

4.3 参数说明

4.3.1 端口映射

4.3.2 环境变量

4.3.3 卷挂载

4.4 Unraid CA安装（推荐）

在Unraid系统中，可通过Community Applications（CA）商店搜索“Logitech Media Server”，点击安装并根据向导配置参数（如卷路径、时区等），实现一键部署。

5. 注意事项

• 权限配置：确保宿主机挂载目录（如/mnt/user/appdata/LogitechMediaServer、/mnt/user/Music）的权限与PUID/PGID匹配，避免容器无权限访问文件。
• 媒体库更新：新增媒体文件后，需在Web管理界面（http://<宿主机IP>:9000）手动触发媒体库扫描，或配置自动扫描周期。
• 时区设置：正确配置TZ参数可确保日志时间、计划任务等功能正常运行。
• 端口冲突：确保宿主机的3483、9000、9090端口未被其他服务占用，避免启动失败。