linuxserver/lazylibrarian

linuxserver/lazylibrarian

镜像概述和主要用途

Lazylibrarian 是一个用于跟踪作者并获取数字阅读所需元数据的程序。它结合Goodreads、Librarything以及可选的GoogleBooks作为作者信息和图书信息的来源。本容器基于DobyTang分支构建，由LinuxServer.io团队维护，提供稳定可靠的Docker化部署方案。

核心功能和特性

• 定期应用更新：确保应用始终保持最新版本
• 灵活用户映射：通过PUID/PGID实现容器内用户与宿主机用户权限映射
• 自定义基础镜像：集成s6 overlay进程管理系统
• 高效资源利用：每周基础OS更新，跨生态系统共享公共层，减少空间占用、 downtime和带宽消耗
• 定期安全更新：及时修复潜在安全漏洞
• 多架构支持：兼容x86-64和arm64架构

使用场景和适用范围

适用于需要管理个人数字图书库的用户，特别是：

• 希望自动跟踪喜爱作者新作的读者
• 需要统一管理不同来源图书元数据的用户
• 寻求将电子书导入Calibre库的数字阅读爱好者
• 需要 audiobook 转换功能的用户
• 希望通过Web界面便捷管理图书收藏的用户

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取lscr.io/linuxserver/lazylibrarian:latest即可自动获取适合当前架构的镜像，也可通过标签指定特定架构：

应用设置

基本访问

通过 http://<你的IP>:5299/home 访问Web界面，更多信息请参考Lazylibrarian官方文档。

容器默认设置 /books 为可选路径，便于快速开始使用。

Calibredb导入

仅64位系统支持：容器提供可选的Calibredb导入程序依赖，避免不必要的臃肿。如需使用此功能：

1. 添加下文"Docker Mods"部分所述的环境变量，拉取包含Calibre依赖的额外层
2. 在Lazylibrarian配置页面（处理:Calibredb导入程序）将转换器工具路径设置为 /usr/bin/calibredb

该可选层会在Calibre发布新版本时由CI管道自动重建，确保版本更新。

FFmpeg支持

通过将 linuxserver/mods:lazylibrarian-ffmpeg 添加到 DOCKER_MODS 环境变量，可在容器启动时安装ffmpeg，启用有声书转换功能。在Web界面中，通过 设置 > 处理 > 外部程序 将ffmpeg路径设置为 ffmpeg 即可启用。

使用方法

以下提供docker-compose和docker cli两种部署方式。除非标记为"可选"，否则所有参数为必填项。

Docker Compose（推荐）

yaml
---
services:
  lazylibrarian:
    image: lscr.io/linuxserver/lazylibrarian:latest
    container_name: lazylibrarian
    environment:
      - PUID=1000                # 用户ID
      - PGID=1000                # 组ID
      - TZ=Etc/UTC               # 时区
      - DOCKER_MODS=linuxserver/mods:universal-calibre|linuxserver/mods:lazylibrarian-ffmpeg # 可选，启用calibre和ffmpeg支持
    volumes:
      - /path/to/lazylibrarian/data:/config  # 配置文件目录
      - /path/to/downloads/:/downloads       # 下载目录
      - /path/to/data/:/books                # 图书目录（可选）
    ports:
      - 5299:5299                # Web界面端口
    restart: unless-stopped      # 重启策略

Docker CLI

bash
docker run -d \
  --name=lazylibrarian \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e DOCKER_MODS=linuxserver/mods:universal-calibre|linuxserver/mods:lazylibrarian-ffmpeg `# 可选` \
  -p 5299:5299 \
  -v /path/to/lazylibrarian/data:/config \
  -v /path/to/downloads/:/downloads \
  -v /path/to/data/:/books `# 可选` \
  --restart unless-stopped \
  lscr.io/linuxserver/lazylibrarian:latest

参数说明

容器运行时通过参数进行配置，格式为<外部>:<内部>。

环境变量配置

从文件加载环境变量

可通过特殊前缀FILE__从文件加载环境变量。例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这会将MYVAR环境变量的值设置为/run/secrets/mysecretvariable文件的内容。

应用Umask设置

所有镜像支持通过-e UMASK=022覆盖默认umask设置。注意umask是权限掩码，通过减法而非加法调整权限，详情参考umask说明。

用户/组标识符

使用卷挂载(-v参数)时，可能出现宿主机与容器间的权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此类问题。确保宿主机上的卷目录由指定用户拥有。

通过以下命令获取当前用户的PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

Docker Mods是用于扩展容器功能的额外模块。本镜像支持的Mods包括：

• linuxserver/mods:universal-calibre：添加Calibredb支持
• linuxserver/mods:lazylibrarian-ffmpeg：添加ffmpeg支持

通过DOCKER_MODS环境变量指定要启用的mods，多个mods用|分隔。

支持信息

容器内Shell访问

bash
docker exec -it lazylibrarian /bin/bash

实时日志监控

bash
docker logs -f lazylibrarian

容器版本查询

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lazylibrarian

镜像版本查询

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/lazylibrarian:latest

更新信息

大多数镜像为静态版本，需通过更新镜像并重建容器来更新应用。以下是更新容器的方法：

使用Docker Compose更新

• 更新镜像：

  • 所有镜像：

    bash
    docker-compose pull
    

  • 单个镜像：

    bash
    docker-compose pull lazylibrarian
    

• 更新容器：

  • 所有容器：

    bash
    docker-compose up -d
    

  • 单个容器：

    bash
    docker-compose up -d lazylibrarian
    

• 清理旧镜像：

  bash
  docker image prune
  

使用Docker Run更新

• 更新镜像：

  bash
  docker pull lscr.io/linuxserver/lazylibrarian:latest
  

• 停止运行中的容器：

  bash
  docker stop lazylibrarian
  

• 删除容器：

  bash
  docker rm lazylibrarian
  

• 使用相同参数重建容器（配置文件位于宿主机卷中，将被保留）

• 清理旧镜像：

  bash
  docker image prune
  

镜像更新通知 - Diun

推荐使用Diun工具接收镜像更新通知。不建议使用自动更新容器的工具。

本地构建

如需本地修改或开发，可按以下步骤构建镜像：

bash
git clone https://github.com/linuxserver/docker-lazylibrarian.git
cd docker-lazylibrarian
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/lazylibrarian:latest .

在x86_64硬件上构建ARM变体需使用lscr.io/linuxserver/qemu-static：

bash
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

然后使用-f Dockerfile.aarch64指定架构对应的Dockerfile。

版本历史

• 14.08.24: - 重新基于Ubuntu Noble构建
• 07.10.23: - 从LinuxServer仓库安装unrar，切换到Python虚拟环境，添加Levenshtein
• 10.08.23: - 将unrar更新至6.2.10版本
• 01.07.23: - 弃用armhf架构（如公告所述）
• 07.12.22: - 重新基于Ubuntu Jammy构建，迁移至s6v3，使用pyproject.toml管理依赖，从源码构建unrar
• 27.09.22: - 切换到Levenshtein，为armhf添加cmake构建依赖
• 07.05.22: - 重新基于Ubuntu Focal构建
• 22.05.21: - 优化路径说明，移除可选卷
• 17.05.21: - 添加linuxserver wheel索引
• 23.10.19: - 修改GitLab下载链接
• 23.10.19: - 添加Python模块Pillow
• 31.07.19: - 添加pyopenssl，移除构建时的git依赖
• 09.07.19: - 重新基于Ubuntu Bionic构建，支持Calibre docker mod
• 28.06.19: - 重新基于Alpine 3.10构建
• 23.03.19: - 切换到新基础镜像，迁移至arm32v7标签
• 05.03.19: - 添加apprise Python包
• 22.02.19: - 重新基于Alpine 3.9构建
• 10.12.18: - 迁移至Pipeline构建系统
• 16.08.18: - 重新基于Alpine 3.8构建
• 05.01.18: - 弃用cpu_core例程（缺乏扩展性）
• 12.12.17: - 重新基于Alpine 3.7构建
• 21.07.17: - 内部git拉取替代运行时拉取
• 25.05.17: - 重新基于Alpine 3.6构建
• 07.02.17: - 重新基于Alpine 3.5构建
• 30.01.17: - 编译libunrar.so以支持.cbr格式文件读取
• 12.01.17: - 添加ghostscript包，支持杂志封面创建等功能
• 14.10.16: - 添加版本层信息
• 03.10.16: - 修复非持久化设置问题，创建日志文件夹
• 28.09.16: - 初始发布