搬瓦工搭建 Calibre-Web 电子书管理服务器完整教程

Calibre-Web 是基于 Calibre 数据库的 Web 前端，提供了一个清晰美观的界面用于浏览、阅读和管理电子书。它支持在线阅读 EPUB 和 PDF 格式、Kindle 推送、OPDS 目录协议以及多用户权限管理。本文将介绍如何在搬瓦工 VPS 上通过 Docker 快速部署 Calibre-Web，打造你的私人在线图书馆。

一、准备工作

1.1 系统要求

操作系统：Ubuntu 20.04+（推荐 Ubuntu 22.04）。
内存：512MB 起步，1GB 以上更佳（取决于书库大小）。
磁盘空间：程序约 200MB，电子书按需准备。
Docker：需提前安装，参考 Docker 安装教程。

1.2 创建目录并初始化书库

mkdir -p /opt/calibre-web/config
mkdir -p /opt/calibre-web/books

Calibre-Web 需要一个 Calibre 格式的数据库文件（metadata.db）。如果你还没有现成的 Calibre 书库，可以创建一个空的数据库。LinuxServer 的 Docker 镜像在首次启动时会自动生成该文件。

二、Docker Compose 部署

2.1 创建配置文件

cd /opt/calibre-web
cat > docker-compose.yml <<'EOF'
version: '3.8'

services:
  calibre-web:
    image: linuxserver/calibre-web:latest
    container_name: calibre-web
    restart: unless-stopped
    ports:
      - "8083:8083"
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - DOCKER_MODS=linuxserver/mods:universal-calibre
    volumes:
      - ./config:/config
      - ./books:/books
EOF

DOCKER_MODS=linuxserver/mods:universal-calibre 会在容器中安装 Calibre 的命令行工具（ebook-convert），用于支持电子书格式转换功能。

2.2 启动服务

docker compose up -d

首次启动需要下载 Calibre 工具，可能需要几分钟。查看日志确认启动进度：

docker compose logs -f calibre-web

2.3 初始登录

浏览器访问 http://你的服务器IP:8083，使用默认凭据登录：

用户名：admin
密码：admin123

首次登录后，系统会提示设置 Calibre 数据库的路径，填写 /books。登录后请立即修改管理员密码。

三、基本配置

3.1 管理设置

进入「管理」→「基本配置」，检查以下选项：

Calibre 数据库路径：确认为 /books。
启用上传：勾选后允许通过 Web 界面上传电子书。
启用格式转换：如果安装了 Calibre 工具，可以启用 EPUB 到 MOBI/PDF 等格式的转换。

3.2 启用 OPDS

OPDS（Open Publication Distribution System）是一种标准的电子书分发协议。在「管理」→「基本配置」→「特性配置」中启用 OPDS，启用后客户端可以通过 http://你的服务器IP:8083/opds 获取电子书目录。支持 OPDS 的阅读器包括 KOReader、Moon+ Reader、FBReader 等。

四、上传与管理电子书

4.1 通过 Web 界面上传

在管理设置中启用上传功能后，点击右上角的上传按钮即可添加电子书。支持的格式包括 EPUB、PDF、MOBI、AZW3、FB2、TXT 等。上传时可以编辑书名、作者、标签等元数据。

4.2 批量导入

如果有大量电子书需要导入，建议使用 Calibre 桌面版先整理好书库，然后将整个书库目录上传到服务器：

rsync -avz --progress /本地Calibre书库/ root@你的服务器IP:/opt/calibre-web/books/

上传完成后，重启容器使 Calibre-Web 重新读取数据库：

docker compose restart

4.3 在线阅读

Calibre-Web 内置了 EPUB 和 PDF 的在线阅读器。点击书籍详情页的「阅读」按钮即可在浏览器中直接阅读。EPUB 阅读器支持字体大小调整、主题切换和阅读进度记忆。

五、格式转换与推送

5.1 电子书格式转换

安装了 Calibre 工具后，可以在书籍详情页进行格式转换。常见的转换场景：

EPUB → MOBI/AZW3（适合 Kindle 设备）
EPUB → PDF（适合打印或大屏阅读）
TXT/FB2 → EPUB（标准化格式）

5.2 Kindle 推送

Calibre-Web 支持将电子书直接推送到 Kindle 设备。在「管理」→「基本配置」→「邮件服务器」中配置 SMTP 信息，然后在用户设置中填写 Kindle 邮箱地址（xxx@kindle.com）即可使用推送功能。

六、多用户权限

在「管理」→「用户」页面可以创建多个用户账户。每个用户可以独立配置以下权限：

是否允许下载电子书。
是否允许上传电子书。
是否允许编辑书籍元数据。
是否允许使用 Kindle 推送。
可访问的书架和标签范围。

七、Nginx 反向代理

server {
    listen 443 ssl http2;
    server_name library.example.com;

    ssl_certificate /etc/letsencrypt/live/library.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/library.example.com/privkey.pem;

    client_max_body_size 200M;

    location / {
        proxy_pass http://127.0.0.1:8083;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Script-Name "";
    }
}

八、维护与备份

8.1 更新 Calibre-Web

cd /opt/calibre-web
docker compose pull
docker compose up -d

8.2 备份书库

# 备份配置和数据库
tar -czf calibre-web-backup.tar.gz -C /opt/calibre-web config/ books/metadata.db

最关键的是 metadata.db 文件（包含所有书籍元数据）和 config 目录。电子书文件建议使用 rsync 定期同步到备份存储。

总结

Calibre-Web 是管理和阅读电子书的绝佳工具，通过 Docker 部署在搬瓦工 VPS 上可以轻松打造一个功能完整的在线图书馆。配合 OPDS 协议和各种阅读客户端，随时随地都可以访问你的电子书收藏。如果你还需要管理有声书，可以参考 Audiobookshelf 有声书服务器教程。选购搬瓦工 VPS 请参考全部方案，购买时使用优惠码 NODESEEK2026 可享受 6.77% 的循环折扣。如遇问题，可前往搬瓦工官网提交工单。