linuxserver/lidarr

概述

Lidarr 是一款面向 Usenet 和 BitTorrent 用户的音乐收藏管理器。它能够监控多个 RSS 源以获取您喜爱艺术家的新曲目，并自动抓取、分类和重命名这些文件。此外，当更高质量的格式可用时，它还可以配置为自动升级已下载文件的质量。

LinuxServer.io 团队提供的此容器具有以下特点：

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

支持的架构

我们利用 Docker 清单实现多平台支持。只需拉取 lscr.io/linuxserver/lidarr:latest 即可获取适合您架构的正确镜像，也可通过标签拉取特定架构的镜像。

此镜像支持的架构：

版本标签

此镜像提供多种版本，可通过标签获取。使用不稳定或开发标签时请谨慎。

应用设置

通过 <your-ip>:8686 访问 Web UI，更多信息请查看 Lidarr。

特别说明：按照我们当前的文件夹结构，由于下载目录和音乐目录位于不同卷，可能导致无法从下载目录硬链接到音乐目录。要支持硬链接，只需确保音乐和下载数据位于单个卷上。例如，如果您有 /mnt/storage/Music 和 /mnt/storage/downloads/completed/Music，则卷映射应为 /mnt/storage:/media。然后可以从 /media/downloads/completed 硬链接到 /media/Music。

另一个注意事项是，在 Lidarr 中，您需要将下载客户端文件夹映射到 Lidarr 文件夹：设置 -> 下载客户端 -> 高级 -> 远程路径映射。输入下载客户端的主机名（与定义的下载客户端匹配），远程路径为 /downloads/Music（相对于容器内部路径），本地路径为 /media/downloads/completed/Music（假设您有文件夹分隔不同的下载数据类型）。

媒体文件夹

我们将 /music 和 /downloads 设置为可选路径，这是最简便的入门方式。虽然易于使用，但存在一些缺点，主要是在处理内容时无法硬链接（TL;DR：一种使文件在同一文件系统的多个位置存在但仅占用一个文件空间的方式）或原子移动（TL;DR：即时文件移动，而非复制+删除）文件。

如果您不了解或不需要硬链接/原子移动，请使用可选路径。

servarr.com 的团队撰写了一篇关于如何开始使用的优秀文章。

使用方法

以下是一些示例代码片段，帮助您开始创建容器。

docker-compose（推荐，点击此处了解更多信息）

---
version: "2.1"
services:
  lidarr:
    image: lscr.io/linuxserver/lidarr:latest
    container_name: lidarr
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/appdata/config:/config
      - /path/to/music:/music #可选
      - /path/to/downloads:/downloads #可选
    ports:
      - 8686:8686
    restart: unless-stopped

docker cli（点击此处了解更多信息）

docker run -d \
  --name=lidarr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 8686:8686 \
  -v /path/to/appdata/config:/config \
  -v /path/to/music:/music `#可选` \
  -v /path/to/downloads:/downloads `#可选` \
  --restart unless-stopped \
  lscr.io/linuxserver/lidarr:latest

参数

容器镜像通过运行时传递的参数进行配置（如上所示）。这些参数用冒号分隔，表示 <外部>:<内部>。例如，-p 8080:80 会将容器内部的端口 80 暴露出来，可通过主机 IP 的端口 8080 访问。

来自文件的环境变量（Docker 密钥）

您可以使用特殊的前缀 FILE__ 从文件中设置任何环境变量。

例如：

-e FILE__PASSWORD=/run/secrets/mysecretpassword

这会根据 /run/secrets/mysecretpassword 文件的内容设置环境变量 PASSWORD。

应用程序运行的 Umask

对于我们所有的镜像，您可以使用可选的 -e UMASK=022 设置来覆盖容器内启动的服务的默认 umask 设置。请记住，umask 不是 chmod，它基于其值减去权限，而不是添加权限。在请求支持之前，请先了解相关知识。

用户/组标识符

使用卷（-v 标志）时，主机 OS 和容器之间可能会出现权限问题，我们通过允许您指定用户 PUID 和组 PGID 来避免此问题。

确保主机上的任何卷目录都归您指定的同一用户所有，任何权限问题都将迎刃而解。

在此示例中 PUID=1000 和 PGID=1000，要查找您的 PUID 和 PGID，请使用 id user 命令：

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

Docker Mods

我们发布了各种 Docker Mods，以启用容器内的其他功能。可通过上方的动态徽章访问此镜像可用的 Mods 列表（如有）以及可应用于我们任何镜像的通用 Mods。

支持信息

• 容器运行时的 Shell 访问：docker exec -it lidarr /bin/bash
• 实时监控容器日志：docker logs -f lidarr
• 容器版本号
  • docker inspect -f '{{ index .Config.Labels "build_version" }}' lidarr
• 镜像版本号
  • docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/lidarr:latest

更新信息

我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器才能更新内部的应用程序。除了一些例外（如 nextcloud、plex），我们不建议或支持在容器内更新应用程序。请查阅上面的应用设置部分，了解是否推荐对此镜像进行应用程序更新。

以下是更新容器的说明：

通过 Docker Compose

• 更新所有镜像：docker-compose pull
  • 或更新单个镜像：docker-compose pull lidarr
• 让 Compose 按需更新所有容器：docker-compose up -d
  • 或更新单个容器：docker-compose up -d lidarr
• 您还可以删除旧的悬空镜像：docker image prune

通过 Docker Run

• 更新镜像：docker pull lscr.io/linuxserver/lidarr:latest
• 停止运行中的容器：docker stop lidarr
• 删除容器：docker rm lidarr
• 使用上述相同的 docker run 参数重新创建新容器（如果正确映射到主机文件夹，您的 /config 文件夹和设置将被保留）
• 您还可以删除旧的悬空镜像：docker image prune

通过 Watchtower 自动更新器（仅在您不记得原始参数时使用）

• 拉取其标签的最新镜像并在一次运行中替换为相同的环境变量：

  docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once lidarr
  

• 您还可以删除旧的悬空镜像：docker image prune

注意： 我们不认可使用 Watchtower 作为自动更新现有 Docker 容器的解决方案。事实上，我们通常不鼓励自动更新。但是，如果您忘记了原始参数，这是一个有用的一次性手动更新容器的工具。从长远来看，我们强烈建议使用 Docker Compose。

镜像更新通知 - Diun（Docker 镜像更新通知器）

• 我们推荐 Diun 用于更新通知。不建议或支持其他自动更新容器的工具。

本地构建

如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑：

git clone [***]
cd docker-lidarr
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/lidarr:latest .

ARM 变体可以使用 multiarch/qemu-user-static 在 x86_64 硬件上构建

docker run --rm --privileged multiarch/qemu-user-static:register --reset

注册后，您可以使用 -f Dockerfile.aarch64 指定要使用的 dockerfile。

版本历史

• 17.01.23： - 将主分支重新基于 Alpine 3.17，迁移到 s6v3。
• 06.06.22： - 将主分支重新基于 Alpine 3.15。
• 06.05.22： - 将主分支重新基于 Focal。
• 06.05.22： - 将开发分支重新基于 Alpine。
• 04.02.22： - 将夜间分支重新基于 Alpine，弃用 nightly-alpine 分支。
• 30.12.21： - 添加 nightly-alpine 分支。
• 01.08.21： - 添加 libchromaprint-tools。
• 11.07.21： - 向用户明确路径。
• 18.04.21： - 将 latest 标签切换到 .NET Core 版本。
• 25.01.21： - 发布 develop 标签。
• 20.01.21： - 用 baseimage 中的 UMASK 替代 UMASK_SET，详见上文。
• 18.04.20： - 从 Dockerfiles 中移除 /downloads 和 /music 卷。
• 05.04.20： - 将应用移至 /app。
• 01.08.19： - 重新基于 Linuxserver LTS mono 版本。
• 13.06.19： - 添加用于设置 umask 的环境变量。
• 23.03.19： - 切换到新的基础镜像，迁移到 arm32v7 标签。
• 08.03.19： - 重新基于 Bionic，使用 libchromaprint 的提议端点。
• 26.01.19： - 添加流水线逻辑和多架构支持。
• 22.04.18： - 切换到测试版构建。
• 17.03.18： - 在 Dockerfile 中添加 ENV XDG_CONFIG_HOME="/config/xdg" 以修复 signalr 问题。
• 27.02.18： - 使用 json 查询新版本。
• 23.02.18： - 初始发布。