lucapisciotta/calibre

lucapisciotta/calibre

镜像概述

lucapisciotta/calibre 是一个基于 Calibre 服务器的 Docker 镜像，用于构建个人电子书管理服务。该镜像封装了 Calibre 官方功能，支持电子书的阅读、下载与管理，并特别优化了对电子墨水屏（e-Ink）设备（如 Amazon Kindle）浏览器的兼容性，解决了其他类似项目在电子墨水屏设备上的适配问题。

核心功能与特性

• 官方兼容性：基于 Debian Unstable 系统和 Calibre 官方包构建，确保功能与官方版本同步。
• 多架构支持：兼容 x86_64 和 arm64 架构；arm32 架构已不再支持。
• 双 WebUI 版本：提供标准 WebUI（适合普通设备）和移动/电子墨水屏兼容版本（优化显示效果）。
• 灵活的库管理：支持挂载自定义电子书库，初始包含示例电子书便于快速体验。
• 本地网络添加：允许通过 WebUI 直接添加新电子书，仅限本地网络（192.168.0.0/16、172.16.0.0/12、10.0.0.0/8 子网）访问。
• 可配置认证：支持启用用户认证，通过环境变量和挂载用户数据库实现。

适用场景

• 电子墨水屏设备用户：需兼容 Amazon Kindle 等电子墨水屏设备浏览器的电子书管理服务。
• 个人/家庭电子书库：本地网络或远程访问的个人电子书库搭建，支持书籍分类、标签管理。
• 简单部署需求：通过 Docker 快速部署，无需复杂配置即可使用核心功能。

使用方法

部署准备

• 确保 Docker 或 Docker Compose 环境已安装。
• 准备电子书库目录（本地路径），用于持久化存储电子书（可选，初始可使用镜像内置示例库）。
• 如需启用认证，准备用户数据库存储路径（可选，初始可使用默认配置）。

Docker Compose 部署

创建 docker-compose.yml 文件，示例配置如下：

yaml
---
version: '3.8'
services:
  calibre:
    image: lucapisciotta/calibre
    container_name: calibre
    user: 1002:1002  # 替换为实际的用户ID:组ID，解决权限问题
    environment:
      - ADMIN_PASSWORD=yourpassword  # 管理员密码，默认值为ChangeMe!
      - ENABLE_AUTH=true  # 启用认证，默认不启用
      - TZ=Europe/Rome  # 时区，如Asia/Shanghai
    volumes:
      - /path/to/calibre/library:/books  # 挂载自定义电子书库（可选）
      - /path/to/users/database:/srv/calibre/users.sqlite  # 挂载用户数据库（可选）
    ports:
      - 8085:8085  # WebUI端口映射
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

Docker CLI 部署

直接使用命令行启动容器：

bash
docker run -d \
  --name=calibre \
  -e ADMIN_PASSWORD=yourpassword \  # 管理员密码
  -e ENABLE_AUTH=true \             # 启用认证
  -e TZ=Asia/Shanghai \             # 时区设置
  -p 8085:8085 \                    # 端口映射
  -u 1002:1002 \                    # 用户ID:组ID
  -v /path/to/calibre/library:/books \  # 电子书库目录
  -v /path/to/users/database:/srv/calibre/users.sqlite \  # 用户数据库
  --restart unless-stopped \
  lucapisciotta/calibre

配置参数详解

高级配置

访问 WebUI

• 标准版本：部署后通过 http://<主机IP>:8085 访问。
• 移动/电子墨水屏版本：通过 http://<主机IP>:8085/mobile 访问，优化电子墨水屏显示。

认证配置

• 启用认证：设置环境变量 ENABLE_AUTH=true。
• 默认管理员密码：未指定 ADMIN_PASSWORD 时，默认密码为 ChangeMe!，建议首次登录后修改。
• 自定义用户数据库：通过 -v /path/to/users.sqlite:/srv/calibre/users.sqlite 挂载现有用户数据库，支持多用户管理。

电子书添加限制

通过 WebUI 添加新电子书仅允许本地网络访问，支持的子网包括：

• 192.168.0.0/16
• 172.16.0.0/12
• 10.0.0.0/8

用户与权限

容器运行时可能因主机目录权限导致无法访问挂载的电子书库或用户数据库，需确保：

1. 挂载目录的所有者与容器内运行用户的 UID/GID 一致。
2. 通过 id <用户名> 命令获取主机用户的 UID 和 GID（如 uid=1000(user) gid=1000(group)），并在部署时通过 -u 1000:1000 指定。

相关资源

• Docker 镜像仓库：https://github.com/lucapisciotta/calibre
• Calibre 官方仓库：https://github.com/kovidgoyal/calibre