linuxserver/calibre-web

LinuxServer.io docker-calibre-web 容器介绍

LinuxServer.io 容器特点

LinuxServer.io 团队推出的容器具有以下核心特性：

• 定期及时的应用更新
• 简单的用户映射（通过 PGID、PUID 配置权限）
• 基于 s6 覆盖层的自定义基础镜像
• 每周基础系统更新，通过统一层设计减少存储空间占用、 downtime 和带宽消耗
• 定期安全更新

calibre-web 简介

calibre-web 是一款基于 Web 的电子书管理工具，可通过现有 Calibre 数据库提供电子书浏览、阅读和下载功能。支持集成 Google Drive，也可直接通过界面编辑元数据和管理 Calibre 库。该软件基于 library 项目开发，采用 GPL v3 协议开源。

支持架构

通过 docker 镜像清单实现多平台支持，拉取 lscr.io/linuxserver/calibre-web:latest 即可自动匹配对应架构。也可通过标签指定架构：

版本标签

应用设置

1. 初始访问：Web 界面地址为 `[]
2. 库路径配置：首次设置时，输入 /books 作为 Calibre 库路径
3. 默认登录信息：
   • 用户名：admin
   • 密码：admin123
4. 密码重置：若忘记密码，需通过命令行指定数据库文件重置（需替换 <user> 和 <pass>）：
   CODE_TOKEN_0
5. Unrar 配置：默认已集成 unrar，需在管理界面（基础配置 > 外部程序）设置路径为 /usr/bin/unrar
6. 电子书转换功能（仅 64 位架构）：
   • 添加环境变量 DOCKER_MODS=linuxserver/mods:universal-calibre 启用转换依赖
   • 版本 0.6.21 及以下：在管理界面设置“Calibre 转换工具路径”为 /usr/bin/ebook-convert
   • 版本 0.6.22 及以上：设置路径为 /usr/bin/
7. kepubify 配置：默认集成 epub 转 kepub 工具，在管理界面设置路径为 /usr/bin/kepubify

使用方法

docker-compose（推荐）

创建 docker-compose.yml 文件，填入以下内容（替换 <路径> 为实际目录）：

CODE_TOKEN_1

启动容器：
CODE_TOKEN_2

docker cli

直接执行命令（替换 <路径> 为实际目录）：

CODE_TOKEN_3

参数说明

环境变量与权限配置

从文件读取环境变量

通过 FILE__变量名 格式可从文件加载环境变量，例如：
CODE_TOKEN_4

Umask 设置

通过 -e UMASK=022 自定义容器内服务的文件权限掩码（默认值 022，详见 umask 说明）。

用户/组ID（PUID/PGID）

为避免权限问题，需确保主机目录所有者的 UID/GID 与容器内 PUID/PGID 一致。通过 id 用户名 命令获取当前用户的 UID/GID：

bash
id your_user  # 示例输出：uid=1000(your_user) gid=1000(your_user)

Docker Mods

可通过 Docker Mods 扩展容器功能，支持的 mods 包括：

• calibre-web 专用 mods：查看列表
• 通用 mods：查看列表

支持与维护

容器管理命令

• 进入容器终端：

  bash
  docker exec -it calibre-web /bin/bash
  

• 实时查看日志：

  bash
  docker logs -f calibre-web
  

• 查看容器版本：

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

• 查看镜像版本：

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

更新容器

通过 docker-compose

bash
# 拉取最新镜像
docker-compose pull calibre-web

# 更新容器（保留配置）
docker-compose up -d calibre-web

# 清理旧镜像
docker image prune

通过 docker run

bash
# 拉取最新镜像
docker pull lscr.io/linuxserver/calibre-web:latest

# 停止并删除旧容器
docker stop calibre-web && docker rm calibre-web

# 重新创建容器（使用原参数，配置会保留）
docker run -d [原参数] lscr.io/linuxserver/calibre-web:latest

本地构建

如需自定义镜像，可克隆源码并构建：

bash
git clone [] docker-calibre-web

# 构建x86-64镜像
docker build --no-cache --pull -t lscr.io/linuxserver/calibre-web:latest .

# 构建ARM镜像（需先安装qemu-static）
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
docker build -f Dockerfile.aarch64 --no-cache --pull -t lscr.io/linuxserver/calibre-web:arm64v8-latest .

版本历史

---

更多资源：

• LinuxServer.io 博客（教程与指南）
• （实时支持）
• 论坛（社区讨论）
• GitHub（源码仓库）
• Open Collective（支持我们的开发）