Docker-Calibre-Web：构建个人云端图书馆的完整指南

想要打造属于自己的数字书房吗？Docker-Calibre-Web项目为你提供完美解决方案！这个基于Python的开源工具通过Docker容器技术，让你轻松建立个人电子书管理系统，随时随地畅享阅读乐趣。

项目概述与核心功能

Docker-Calibre-Web是一个基于Docker的电子书管理解决方案，它提供了一个简洁的Web界面来浏览、阅读和下载电子书。该项目基于现有的Calibre数据库，支持Google Drive集成和元数据编辑。

智能书架管理

• 跨平台阅读体验：支持在任何设备上通过浏览器访问你的电子书库
• 元数据智能编辑：通过应用界面编辑元数据和你的Calibre图书馆
• 云端同步集成：无缝连接Google Drive，实现数据安全备份

格式转换专家

• 多格式兼容：支持EPUB、PDF、MOBI等主流电子书格式
• 批量处理能力：可选的电子书转换功能，支持利用Calibre进行电子书格式转换
• Kepubify工具集成：包含kepubify电子书转换工具，可将epub转换为kepub格式

技术架构与系统要求

支持的架构

该项目支持以下架构：

• x86-64 (amd64)
• arm64 (arm64v8)

版本标签

• latest：Calibre-Web的稳定发布版本
• nightly：Calibre-Web主分支的提交版本

部署与配置指南

环境准备

确保你的系统满足以下要求：

• Docker环境已安装并运行
• 足够的存储空间用于电子书库
• 稳定的网络连接

快速部署步骤

使用Docker Compose（推荐方式）

services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - DOCKER_MODS=linuxserver/mods:universal-calibre
      - OAUTHLIB_RELAX_TOKEN_SCOPE=1
    volumes:
      - /path/to/calibre-web/data:/config
      - /path/to/calibre/library:/books
    ports:
      - 8083:8083
    restart: unless-stopped

使用Docker CLI

docker run -d \
  --name=calibre-web \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e DOCKER_MODS=linuxserver/mods:universal-calibre \
  -e OAUTHLIB_RELAX_TOKEN_SCOPE=1 \
  -p 8083:8083 \
  -v /path/to/calibre-web/data:/config \
  -v /path/to/calibre/library:/books \
  --restart unless-stopped \
  lscr.io/linuxserver/calibre-web:latest

初始设置与使用

首次访问配置

Web界面可以通过 http://你的IP地址:8083 访问。在初始设置屏幕上，输入 /books 作为你的Calibre图书馆位置。

默认管理员登录信息：

• 用户名：admin
• 密码：admin123

重要配置说明

Unrar支持

Unrar已默认包含，需要在Calibre-Web管理页面（基本配置 > 外部二进制文件）中设置路径为 /usr/bin/unrar

电子书转换功能（仅64位）

项目提供了可选功能来启用电子书转换，如果你不需要这个功能，容器不会不必要地臃肿，但如果需要，它很容易获得。

要使用此选项，添加可选的环境变量来拉取额外的Docker层以启用电子书转换，然后在Calibre-Web管理页面（基本配置 > 外部二进制文件）中设置Calibre电子书转换器路径。

高级功能与定制

Docker Mods支持

项目支持各种Docker Mods来启用容器内的额外功能。可以通过动态徽章访问此镜像可用的Mods列表以及适用于我们任何镜像的通用Mods。

安全配置

• 支持从文件设置环境变量（Docker secrets）
• 可选的Umask设置用于运行应用程序
• 用户/组标识符配置以避免权限问题

维护与更新

容器监控

• 实时监控容器日志：docker logs -f calibre-web
• 获取容器版本号：docker inspect -f '{{ index .Config.Labels "build_version" }}' calibre-web

更新策略

大多数镜像都是静态的、版本化的，需要更新镜像并重新创建容器来更新内部应用程序。

通过Docker Compose更新

# 更新所有镜像
docker-compose pull

# 更新单个镜像
docker-compose pull calibre-web

# 重启所有容器
docker-compose up -d

通过Docker CLI更新

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

# 停止运行中的容器
docker stop calibre-web

# 删除容器
docker rm calibre-web

# 重新创建新容器

故障排除与支持

密码重置

如果被锁定或忘记密码，需要指定app.db类似这样：

docker exec -it calibre-web python3 /app/calibre-web/cps.py -p /config/app.db -s <用户名>:<密码>```

### 技术支持渠道
- Shell访问正在运行的容器：`docker exec -it calibre-web /bin/bash
- 实时监控容器日志
- 社区论坛支持

## 本地构建与开发

如果你想要对这些镜像进行本地修改以用于开发目的或仅自定义逻辑：

```bash
git clone https://gitcode.com/gh_mirrors/do/docker-calibre-web
cd docker-calibre-web
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/calibre-web:latest .

ARM变体可以在x86_64硬件上构建，反之亦然，使用lscr.io/linuxserver/qemu-static。

这个强大的电子书管理工具不仅功能丰富，而且安装简单，是构建个人数字图书馆的理想选择。立即开始你的云端阅读之旅吧！