lsiodev/lazylibrarian

linuxserver/lazylibrarian

镜像概述和主要用途

LazyLibrarian 是一个用于跟踪作者并获取数字阅读所需元数据的程序，它结合Goodreads、Librarything以及可选的GoogleBooks作为作者信息和书籍信息的来源。本容器基于DobyTang分支构建，由LinuxServer.io团队维护，提供定期应用更新、简单的用户映射、自定义基础镜像及每周系统更新等特性。

!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/lazylibrarian-icon.png

核心功能和特性

• 元数据管理：自动从Goodreads、Librarything和GoogleBooks获取作者及书籍元数据
• 多架构支持：适配x86-64和arm64v8架构
• 灵活扩展：通过Docker Mods支持Calibredb导入和ffmpeg音频转换功能
• 用户权限控制：支持PUID/PGID用户映射，避免权限问题
• 定时更新：包含定期应用更新和安全补丁
• 轻量级设计：基于自定义s6 overlay基础镜像，减少空间占用

支持的架构

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

应用设置

基本访问

通过 http://<your-ip>:5299/home 访问Web界面，更多信息请查看Lazylibrarian官方文档。

Calibredb导入（仅64位）

如需启用Calibredb导入功能，可添加可选环境变量以拉取额外Docker层，实现电子书转换。在LazyLibrarian配置页面（Processing:Calibredb import program:）将转换器工具路径设置为 /usr/bin/calibredb。

ffmpeg支持

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

媒体文件夹说明

/books 被设为可选路径，便于快速上手，但可能失去硬链接（同一文件在多个位置存在但仅占用一份空间）和原子移动（即时文件移动而非复制+删除）功能。如不需要这些功能，可使用可选路径；如需了解高级路径配置，可参考servarr.com的路径规划指南。

使用方法

docker-compose（推荐）

yaml
---
version: "2.1"
services:
  lazylibrarian:
    image: lscr.io/linuxserver/lazylibrarian:latest
    container_name: lazylibrarian
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DOCKER_MODS=linuxserver/mods:universal-calibre|linuxserver/mods:lazylibrarian-ffmpeg #可选
    volumes:
      - /path/to/data:/config
      - /path/to/downloads/:/downloads
      - /path/to/data/:/books #可选
    ports:
      - 5299:5299
    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 `#optional` \
  -p 5299:5299 \
  -v /path/to/data:/config \
  -v /path/to/downloads/:/downloads \
  -v /path/to/data/:/books `#optional` \
  --restart unless-stopped \
  lscr.io/linuxserver/lazylibrarian:latest

参数说明

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

环境变量与Docker Secrets

可通过FILE__前缀从文件设置环境变量，例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

这将根据/run/secrets/mysecretvariable文件内容设置MYVAR环境变量。

Umask设置

可通过-e UMASK=022覆盖容器内服务的默认umask设置。注意umask是权限减法而非加法，详情参考umask说明。

用户/组ID

使用卷（-v标志）时，主机与容器可能存在权限问题。通过指定PUID（用户ID）和PGID（组ID），确保主机卷目录与指定用户拥有相同权限即可避免问题。使用id your_user命令获取当前用户的ID：

bash
id your_user

示例输出：

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

Docker Mods

https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=lazylibrarian&query=%24.mods%5B%27lazylibrarian%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([] https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml]([]

通过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
  

通过Watchtower自动更新（仅用于忘记原始参数时）

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

警告：不建议使用Watchtower作为容器自动更新工具，长期推荐使用Docker Compose。

镜像更新通知 - 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变体：

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

然后使用-f Dockerfile.aarch64指定Dockerfile。

版本历史

• 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：初始发布