Lyrion Music Server Docker镜像文档

镜像概述和主要用途

Lyrion Music Server是由LMS社区提供的Docker镜像（Dockerfile），用于运行Lyrion Music Server音乐服务器，其前身为logitechmediaserver。该镜像提供稳定、便捷的音乐服务器部署方式，支持音乐文件管理、播放控制、插件扩展等功能。

核心功能和特性

• 多版本支持：提供latest（最新发布版）、stable（基于最新发布的修复分支）和dev（开发版）三个标签，满足不同稳定性和功能需求
• 数据持久化：支持配置文件、音乐文件和播放列表的持久化存储
• 灵活配置：可自定义时区、主机名、用户/组ID，支持传递额外启动参数
• 网络兼容性：支持多种网络模式，可适配不同网络环境（如NAS设备）
• 插件扩展：支持手动安装插件，满足个性化功能需求

标签说明

• latest：最新发布版本，当前为v9.0.3
• stable：基于最新发布的修复分支，当前为v9.0.4
• dev：开发版本，包含新功能，稳定性可能较低，当前为v9.1.0

使用场景和适用范围

适用于需要搭建个人或家庭音乐服务器的用户，尤其适合：

• 音乐爱好者搭建本地音乐库和流媒体服务
• 需要跨设备访问音乐收藏的场景
• NAS设备（如Synology、QNAP）用户部署音乐服务
• 开发人员测试最新功能或自定义插件

安装和使用方法

基本安装

使用docker run命令部署：

bash
docker run -it \
      -v "<本地路径>":"/config":rw \
      -v "<本地路径>":"/music":ro \
      -v "<本地路径>":"/playlist":rw \
      -v "/etc/localtime":"/etc/localtime":ro \
      -v "/etc/timezone":"/etc/timezone":ro \
      -p 9000:9000/tcp \
      -p 9090:9090/tcp \
      -p 3483:3483/tcp \
      -p 3483:3483/udp \
      lmscommunity/lyrionmusicserver

注意：HTTP端口（9000）和CLI端口（9090）必须1:1映射，不可使用-p 9002:9000此类非1:1映射。如需使用非9000的HTTP端口，需同时设置HTTP_PORT环境变量，例如：

bash
docker run -it \
      -v "<本地路径>":"/config":rw \
      -v "<本地路径>":"/music":ro \
      -v "<本地路径>":"/playlist":rw \
      -v "/etc/localtime":"/etc/localtime":ro \
      -v "/etc/timezone":"/etc/timezone":ro \
      -p 9002:9002/tcp \
      -p 9090:9090/tcp \
      -p 3483:3483/tcp \
      -p 3483:3483/udp \
      -e HTTP_PORT=9002 \
      lmscommunity/lyrionmusicserver

Docker Compose配置

yaml
version: '3'
services:
  lms:
    container_name: lms
    image: lmscommunity/lyrionmusicserver
    volumes:
      - /<本地路径>:/config:rw  # 配置文件目录（读写）
      - /<本地路径>:/music:ro   # 音乐文件目录（只读）
      - /<本地路径>:/playlist:rw # 播放列表目录（读写）
      - /etc/localtime:/etc/localtime:ro # 时区配置（只读）
      - /etc/timezone:/etc/timezone:ro   # 时区配置（只读）
    ports:
      - 9000:9000/tcp    # HTTP端口
      - 9090:9090/tcp    # CLI端口
      - 3483:3483/tcp    # 服务端口（TCP）
      - 3483:3483/udp    # 服务端口（UDP）
    environment:
      - HTTP_PORT=9000    # HTTP端口设置（需与映射端口一致）
    restart: always      # 容器自动重启

自定义配置

设置主机名

默认使用容器ID作为服务器名称，可通过以下方式自定义：

• docker run：添加-h my-preferred-hostname参数
• docker compose：在服务配置中添加hostname: my-preferred-hostname（与container_name同级）

指定用户和组ID

可通过环境变量指定运行服务的用户ID（PUID）和组ID（PGID）：

• docker run：添加-e PUID=1000 -e PGID=1000
• docker compose：在environment中添加- PUID=1000 - PGID=1000

高级配置说明

无法映射/etc/localtime或/etc/timezone时

部分系统（如Unraid）可能限制外部目录映射，此时可通过TZ环境变量设置时区：

bash
-e TZ=Europe/Zurich  # 例如设置为欧洲/苏黎世时区

Synology上的Docker使用注意事项

• 使用/etc/TZ代替/etc/timezone进行时区映射
• 建议使用非9000端口（Synology传统使用9002端口运行Lyrion Music Server），需确保端口映射和HTTP_PORT设置一致
• 网络配置：
  • 推荐使用host网络模式自动暴露服务
  • 或添加EXTRA_ARGS环境变量指定服务器IP：EXTRA_ARGS="--advertiseaddr=192.168.0.100"（替换为NAS的实际IP）

手动安装插件

开发者可在插件发布到内置插件管理器前手动安装：将插件文件放入[配置目录]/cache/Plugins，重启服务后即可在插件列表中看到。

传递额外启动参数

v8.4及以上版本支持通过EXTRA_ARGS环境变量传递额外启动参数，例如禁用Web界面：

bash
-e EXTRA_ARGS="--noweb"

定义服务IP地址

部分插件（如Sounds & Effects）需要播放器知道服务器IP。默认bridge网络模式下，容器内部IP与外部可见IP不同，可通过以下方式指定宣告IP：

bash
-e EXTRA_ARGS=--advertiseaddr=192.168.0.100  # 替换为服务器实际IP

容器内使用Local Player插件

需挂载主机音频设备（仅支持有音频硬件的主机，多数NAS设备不支持）：

• docker run：添加--device /dev/snd参数
• docker compose：在服务配置中添加：

  yaml
  devices:
    - /dev/snd:/dev/snd
  

启动前运行自定义脚本（v8.2.0+）

可在配置目录中放置custom-init.sh脚本，服务启动前将自动执行。例如安装ffmpeg：

bash
# custom-init.sh内容示例
apt-get update -qq
apt-get install --no-install-recommends -qy ffmpeg