linuxserver/libresonic

linuxserver/libresonic

镜像概述和主要用途

此镜像已废弃。请使用Airsonic镜像 linuxserver/airsonic

https://github.com/Libresonic/libresonic 是一款免费的基于Web的媒体流服务器，提供对音乐的随时随地访问。可用于与朋友共享音乐，或在工作时收听自己的音乐库。支持同时向多个播放器流传输，例如厨房和客厅的播放器可同时播放。

核心功能和特性

LinuxServer.io 镜像特性

• 定期及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带s6 overlay的自定义基础镜像
• 每周基础OS更新，通过整个LinuxServer.io生态系统的通用层最小化空间占用、 downtime和带宽
• 定期安全更新

Libresonic 核心功能

• 基于Web的音乐流访问界面
• 多播放器同时流传输支持
• 音乐库管理与共享能力
• 跨设备访问支持

使用场景和适用范围

• 个人音乐库集中管理与远程访问
• 家庭多设备音乐同步播放（如厨房、客厅播放器）
• 小型团队或朋友间音乐共享
• 替代本地音乐播放器，实现跨平台、跨网络访问

支持的架构

镜像支持多种架构，如 x86-64、arm64 和 armhf，通过Docker manifest实现多平台识别。直接拉取 linuxserver/libresonic 即可获取对应架构的镜像，也可通过标签指定特定架构：

详细使用方法和配置说明

Docker Run 部署示例

bash
docker create \
  --name=libresonic \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e CONTEXT_PATH=<URL_BASE> `#可选` \
  -p 4040:4040 \
  -v </path/to/config>:/config \
  -v </path/to/music>:/music \
  -v </path/to/playlists>:/playlists \
  -v </path/to/podcasts>:/podcasts \
  -v </path/to/other media>:/media `#可选` \
  --restart unless-stopped \
  linuxserver/libresonic

Docker Compose 部署示例

兼容docker-compose v2架构：

yaml
---
version: "2"
services:
  libresonic:
    image: docker.xuanyuan.run/linuxserver/libresonic
    container_name: libresonic
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - CONTEXT_PATH=<URL_BASE> #可选
    volumes:
      - </path/to/config>:/config
      - </path/to/music>:/music
      - </path/to/playlists>:/playlists
      - </path/to/podcasts>:/podcasts
      - </path/to/other media>:/media #可选
    ports:
      - 4040:4040
    restart: unless-stopped

配置参数说明

容器运行时通过参数配置，格式为 <外部>:<内部>。以下是详细参数说明：

用户/组标识符

使用卷（-v 标志）时，主机OS与容器可能出现权限问题。通过指定 PUID（用户ID）和 PGID（组ID）可避免此问题。确保主机上的卷目录所有者与指定的ID一致，权限问题将自动解决。

默认 PUID=1000、PGID=1000，可通过以下命令获取当前用户的ID：

bash
$ id username
  uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

应用设置

1. 通过 <你的IP>:4040 访问WebUI
2. 默认用户名/密码：admin/admin

支持信息

• 容器运行中获取Shell访问：docker exec -it libresonic /bin/bash
• 实时监控容器日志：docker logs -f libresonic
• 查看容器版本号：
  docker inspect -f '{{ index .Config.Labels "build_version" }}' libresonic
• 查看镜像版本号：
  docker inspect -f '{{ index .Config.Labels "build_version" }}' linuxserver/libresonic

更新信息

大多数镜像为静态版本，需更新镜像并重建容器以更新应用（Nextcloud、Plex等少数例外）。不建议在容器内直接更新应用。

通过 Docker Run/Create 更新

1. 更新镜像：docker pull docker.xuanyuan.run/linuxserver/libresonic
2. 停止运行中的容器：docker stop libresonic
3. 删除容器：docker rm libresonic
4. 使用原参数重建容器（若卷映射正确，/config 文件夹及设置将保留）
5. 启动新容器：docker start libresonic
6. 清理旧镜像：docker image prune

通过 Taisun 自动更新器

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock docker.xuanyuan.run/taisun/updater \
  --oneshot libresonic

清理旧镜像：docker image prune

通过 Docker Compose 更新

1. 更新所有镜像：docker-compose pull（或单个镜像：docker-compose pull libresonic）
2. 重建并启动容器：docker-compose up -d（或单个容器：docker-compose up -d libresonic）
3. 清理旧镜像：docker image prune

版本历史

• 24.03.19： 切换到新基础镜像，迁移至arm32v7标签
• 15.01.19： 从GitHub拉取war包，添加多架构构建流水线
• 05.01.19： 修复代码规范问题
• 27.08.18： 基于Ubuntu Bionic重建
• 12.12.17： 基于Alpine 3.7重建
• 11.07.17： 基于Alpine 3.6重建
• 12.05.17： 添加注解超时（主要针对armhf和低功耗主机）
• 08.02.17： 基于Alpine 3.5重建
• 04.12.16： 更新Jetty Runner版本
• 29.11.16： 切换到基于v6.1稳定版的发布标签构建
• 17.11.16： 初始发布