svasek/calibre-web

Calibre Web

镜像概述和主要用途

Calibre Web 是一个Web应用，提供干净的界面用于浏览、阅读和下载电子书，需使用现有Calibre数据库。本Docker镜像基于Alpine构建，运行Calibre Web应用，支持自动更新、电子书格式转换等功能，适合个人或小型团队管理电子书库。

!https://github.com/svasek/docker-calibre-web/actions/workflows/docker-publish.yml/badge.svg !Docker Stars !Docker Pulls !镜像信息 !版本信息

核心功能和特性

Calibre Web 应用功能

• Bootstrap 3 HTML5界面
• 全图形化设置
• 用户管理
• 管理员界面
• 支持多语言：英语、法语、德语、波兰语、简体中文、西班牙语
• OPDS feed支持，供电子书阅读器应用使用
• 按标题、作者、标签、系列和语言过滤与搜索
• 创建自定义书籍集合（书架）
• 支持编辑电子书元数据
• 支持将EPUB格式转换为Kindle格式（mobi/azw）
• 限制仅登录用户可下载电子书
• 支持公开用户注册
• 一键发送电子书到Kindle设备
• 支持在浏览器中直接阅读电子书（.txt、.epub、.pdf格式）
• 支持上传PDF、epub、fb2格式的新书籍
• 支持Calibre自定义列
• 细粒度的每用户权限控制
• 自我更新能力

Docker镜像特性

• 运行Calibre Web应用
• 容器（重新）启动时自动更新（如需要）
• 容器内不使用NGINX，仅作为单一应用运行，无监控进程
• 精简集成：禁用GoogleDrive/Kobo/GoodReads集成、ldap、oauth以减小镜像体积
• 支持Calibre ebook-convert工具进行MOBI格式转换
• Calibre ebook-convert使用glibc，因此安装了https://github.com/sgerrand/alpine-pkg-glibc

使用场景和适用范围

• 个人电子书库管理，通过Web界面随时随地访问
• 小型团队或家庭共享电子书资源
• 需要将电子书转换为不同格式（尤其是Kindle格式）的用户
• 使用电子书阅读器（如Kindle、Kobo）通过OPDS feed同步书籍的场景

详细使用方法和配置说明

提示与技巧

• 如需SSL支持（类似原始Docker容器https://hub.docker.com/r/janeczku/calibre-web/%EF%BC%89%EF%BC%8C%E8%AF%B7%E4%BD%BF%E7%94%A8%E9%A2%9D%E5%A4%96%E7%9A%84NGINX%E6%88%96Apache HTTP Server作为反向代理，例如https://hub.docker.com/r/jwilder/nginx-proxy/
• Synology用户注意：不要将NAS的顶级卷目录映射为/books卷（如/volume1/books），这会导致目录权限问题。应在/volume1/books下创建子目录calibre，然后将/volume1/books/calibre映射为/books卷

首次启动配置

1. 在浏览器中访问http://主机名:<HTTP端口>，例如http://hostname:8083
2. 如需更改Calibre书籍文件夹位置，访问http://hostname:8083/admin/dbconfig，设置为容器中挂载Calibre文件夹的路径，默认为/books

默认管理员登录信息：

• 用户名： admin
• 密码： admin123

成功登录后，请更改默认密码并设置电子邮件地址。

要访问OPDS目录 feed，将电子书阅读器指向http://主机名:<HTTP端口>/opds

转换器配置

在管理员 -> 基本配置 -> 电子书转换器中设置要使用的转换器：

• 对于使用calibre的ebook converter选项，将转换器工具路径设置为/opt/calibre/ebook-convert，在关于页面中会显示Calibre converter ebook-convert (calibre 5.9.0)

已知问题

1. 若映射旧的/现有应用卷（如-v /volume1/docker/apps/calibre-web/app:/calibre-web/app），启动时会出现以下问题：

[INFO] Checkout the latest Calibre-Web version ...
[INFO] Autoupdate is active, try to pull the latest sources for Calibre-Web ...
[INFO] ... current git status is
fatal: not a git repository (or any parent up to mount point /calibre-web)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
[INFO] ... pulling sources
fatal: not a git repository (or any parent up to mount point /calibre-web)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).
[INFO] ... git status after update is
fatal: not a git repository (or any parent up to mount point /calibre-web)
Stopping at filesystem boundary (GIT_DISCOVERY_ACROSS_FILESYSTEM not set).

解决方法：在创建和启动容器前，删除-v /volume1/docker/apps/calibre-web/app:/calibre-web/app路径下的旧文件。

创建和启动容器

创建容器：

docker create --name=calibre-web --restart=always \
-v <你的Calibre书籍文件夹>:/books \
[-v <你的Calibre Web应用文件夹>:/calibre-web/app] \
[-v <你的Calibre Web配置文件夹>:/calibre-web/config \]
[-e APP_REPO=https://github.com/janeczku/calibre-web.git \]
[-e APP_BRANCH=master \]
-p <HTTP端口>:8083 \
svasek/calibre-web

示例：

docker create --name=calibre-web --restart=always \
-v /volume1/books/calibre:/books \
-v /etc/localtime:/etc/localtime:ro \
-p 8083:8083 \
svasek/calibre-web

或

docker create --name=calibre-web --restart=always \
-v /volume1/books/calibre:/books \
-v /volume1/docker/apps/calibre-web/config:/calibre-web/config \
-e TZ=Europe/Prague \
-p 8083:8083 \
svasek/calibre-web

启动容器：

docker start calibre-web

参数说明

介绍

参数分为两部分，以冒号分隔。左侧描述主机，右侧描述容器。例如端口定义格式为-p external:internal，表示将容器内部端口映射到主机外部端口。如-p 8080:80表示将容器内的80端口映射到主机的8080端口，通过http://主机IP:8080可访问容器内80端口的服务。

详细参数

• -p 8083 - Web用户界面的HTTP端口
• -v /books - 本地路径，包含Calibre书籍及存储书籍元信息的metadata.db文件
• -v /calibre-web/app - Calibre Web应用文件的本地路径；如需使用Google Drive，需设置此卷
• -v /calibre-web/config - Calibre Web配置文件的本地路径，如app.db和gdrive.db
• -e APP_REPO - Calibre Web的GitHub仓库地址；默认使用https://github.com/janeczku/calibre-web.git - 可选
• -e APP_BRANCH - 要使用的Calibre Web GitHub仓库分支，默认master - 可选

容器时区

设置环境变量TZ即可：

示例：

• UTC - 未设置时的默认值
• Europe/Prague
• America/New_York
• ...

附加操作

• 容器运行时的Shell访问：docker exec -it calibre-web /bin/bash
• 升级到最新版本的Calibre Web：docker restart calibre-web
• 实时监控容器日志：docker logs -f calibre-web
• 监控Calibre Web日志：docker exec -it calibre-web tail -f /calibre-web/app/calibre-web.log
• 查看Calibre Web基础镜像版本号：docker inspect -f '{{ index .Config.Labels "image.base.version" }}' calibre-web
• 查看Calibre Web镜像版本号：docker inspect -f '{{ index .Config.Labels "image.version" }}' calibre-web

Synology NAS用户说明

登录DSM Web管理界面：

• 打开控制面板
• 控制面板 > 权限 > 群组，创建名为“docker”的新群组
• 为该群组添加“downloads”、“video”等目录的权限
• 禁止该群组使用应用程序的权限
• 控制面板 > 权限 > 用户，创建名为“docker”的新用户，并将其分配到“docker”群组

通过SSH连接到NAS：

• 连接成功后，通过以下命令切换到root账户：

sudo -i

或

sudo su -

密码与SSH认证使用的密码相同。

• 在卷上创建“docker”目录（如不存在）：

mkdir -p /volume1/docker/
chown root:root /volume1/docker/

• 拉取Docker镜像：

docker pull svasek/calibre-web

• 创建Docker容器（注意用户ID和组ID，根据需要更改时区和端口）：

docker create --name=calibre-web --restart=always \
-v /volume1/books/calibre:/books \
-e TZ=Europe/Prague \
-e PGID=65539 -e PUID=1029 \
-p 8083:8083 \
svasek/calibre-web

• 检查容器是否创建成功：

docker ps -a
CONTAINER ID        IMAGE                           COMMAND                CREATED             STATUS              PORTS               NAMES
40cc1bfaf7be        svasek/calibre-web      "/bin/bash -c /init/s" 8 seconds ago       Created 

• 启动Docker容器：

docker start calibre-web