linuxserver/lazylibrarian

Lazylibrarian 是一款用于跟踪作者并获取数字阅读所需元数据的程序。它结合Goodreads、Librarything，还可选择GoogleBooks作为作者信息和书籍信息的来源。本容器基于DobyTang分支构建。

!lazylibrarian

支持的架构

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

核心功能与特性

• 跟踪作者并自动获取书籍元数据（支持Goodreads、Librarything、GoogleBooks）
• 支持多架构部署，适配不同硬件环境
• 可选集成Calibre工具（仅x86-64），实现电子书转换与管理
• 基于LinuxServer.io基础镜像，提供定期应用更新、用户/组权限映射、安全更新等特性
• 支持Docker Mods扩展功能，按需增强容器能力

适用范围

• 数字阅读爱好者，需要自动化跟踪作者新作
• 电子书管理员，批量管理书籍元数据
• 希望通过Web界面集中管理数字书籍库的用户

使用方法

Docker 命令行

docker
docker create \
  --name=lazylibrarian \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e DOCKER_MODS=linuxserver/calibre-web:calibre `#可选，仅x86-64` \
  -p 5299:5299 \
  -v <数据路径>:/config \
  -v <下载路径>:/downloads \
  -v <书籍路径>:/books \
  --restart unless-stopped \
  linuxserver/lazylibrarian

Docker Compose

兼容docker-compose v2架构：

yaml
---
version: "2.1"
services:
  lazylibrarian:
    image: linuxserver/lazylibrarian
    container_name: lazylibrarian
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - DOCKER_MODS=linuxserver/calibre-web:calibre #可选，仅x86-64
    volumes:
      - <数据路径>:/config
      - <下载路径>:/downloads
      - <书籍路径>:/books
    ports:
      - 5299:5299
    restart: unless-stopped

参数说明

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

环境变量文件（Docker Secrets）

可通过特殊前缀 FILE__ 从文件中读取环境变量，例如：

docker
-e FILE__PASSWORD=/run/secrets/mysecretpassword

上述命令会将 /run/secrets/mysecretpassword 文件内容作为 PASSWORD 环境变量的值。

用户/组ID

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

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

bash
id username
# 示例输出：uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

应用设置

1. 通过 http://<你的IP>:5299/home 访问Web界面
2. 更多使用说明请参考 Lazylibrarian***文档

Calibre扩展配置（仅x86-64）

若需启用电子书转换功能：

1. 添加可选环境变量 DOCKER_MODS=linuxserver/calibre-web:calibre
2. 在Lazylibrarian配置页面（处理：Calibredb导入程序）中，将转换器工具路径设置为 /usr/bin/calibredb

Docker Mods

LinuxServer.io提供多种Docker Mods以扩展容器功能，上述链接可查看本镜像支持的Mods列表。

支持信息

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

更新说明

大部分镜像为静态版本，需更新镜像并重建容器以更新应用。以下是更新方法：

通过Docker Run/Create

bash
# 更新镜像
docker pull linuxserver/lazylibrarian
# 停止容器
docker stop lazylibrarian
# 删除容器
docker rm lazylibrarian
# 用原参数重建容器（配置通过卷保留）
docker create [原参数] linuxserver/lazylibrarian
# 启动新容器
docker start lazylibrarian
# 清理旧镜像
docker image prune

通过Docker Compose

bash
# 更新所有镜像（或指定镜像）
docker-compose pull
# 或 docker-compose pull lazylibrarian
# 更新容器
docker-compose up -d
# 或 docker-compose up -d lazylibrarian
# 清理旧镜像
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进行管理。

本地构建

如需本地修改或开发：

bash
git clone [***]
cd docker-lazylibrarian
docker build \
  --no-cache \
  --pull \
  -t linuxserver/lazylibrarian:latest .

在x86_64硬件上构建ARM变体：

bash
# 注册qemu-user-static
docker run --rm --privileged multiarch/qemu-user-static:register --reset
# 使用对应架构的Dockerfile构建
docker build -f Dockerfile.aarch64 -t linuxserver/lazylibrarian:arm64v8-latest .

版本历史

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