Calibre-Web：书的数量超过一百本之后，你需要一个书架

电子书存在硬盘里的样子通常是：一个叫「kindle」的文件夹，几十个文件名各式各样的 EPUB。

想找一本书，得靠记文件名；想看看自己有什么，翻半天。

Calibre-Web 把这些文件变成一个有封面的书架。

装

services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    ports: ["8083:8083"]
    volumes:
      - ./calibre/config:/config
      - /vol1/books:/books
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    restart: unless-stopped

打开 http://NAS地址:8083，第一次登录：用户名 admin，密码 admin123（默认的，进去第一件事就是改掉）。

然后去「管理设置 → 基本配置」，把书库路径指向 /books。

关键：元数据

Calibre-Web 依赖 Calibre 的元数据文件（metadata.db）。有两种情况：

情况一：你已经有 Calibre 桌面版的库 直接把整个目录挂进去就行，元数据、封面、标签都在。

情况二：你只有一堆裸文件 两种办法：

1. 在网页里逐本添加，手动填书名、作者、封面；
2. 用 Calibre 桌面版批量导入一次（它会自动从网上抓元数据），再把整个库拷到 NAS。

推荐第二种。桌面版抓元数据的能力强得多，尤其对中文书。

三个核心用法

一、网页直接读

点开一本书 → 在线阅读。EPUB 阅读器能用，支持字号、背景色、目录跳转。手机浏览器也能读。

二、推到 Kindle

配置里填你的 Kindle 邮箱（@kindle.com 那个），之后点"发送到 Kindle"，它会把书邮件发过去。

前提：亚马逊后台把你的发件邮箱加入白名单，而且这台 NAS 能发邮件（配 SMTP）。

三、OPDS 目录

它提供 OPDS 源，能用 Calibre Companion、Moon+ Reader、iOS 的 KyBook 连上，等于一个私人书库接口。

元数据怎么补

中文书最大的问题是元数据不准。几个办法：

• 豆瓣 API 已经关闭，别指望它自动抓中文书；
• 用 Calibre 桌面版 + 插件（比如豆瓣插件、亚马逊中国区）；
• 或者接受手动填：一本书两分钟，一百本也就几个小时。

封面可以手动上传，找一张干净的图拖进去就行。

会踩的坑

进不去，提示数据库不兼容 Calibre 版本差异。用 linuxserver/calibre-web 的话，挂载的库要匹配版本，日志里会提示怎么处理。

上传的书不显示 上传目录和库目录不是同一个。设置里"上传"路径要指到库里面。

中文书名乱码 文件名编码问题。批量转成 UTF-8，或者只用桌面版导入。

不能删书 默认权限只读。设置里打开"允许删除"，但小心误操作。

内存占用 小（几百兆）。但书多、封面多的时候首次加载会慢。

它适合谁

• 电子书超过几十本，需要管理的；
• 想让家里人在手机、平板上直接读的；
• 有 Kindle，想扔掉数据线传书的。

不适合：只有几本书的（文件夹就够）；主要看 PDF 扫描件的（它的 PDF 阅读体验一般，不如专门的 PDF 工具）。

最后

书和电影不一样：电影你会反复看，书大部分只读一次。

但"只想读一次"的书，恰恰最需要能快速找到——因为你不会记得它叫什么。

Calibre-Web 解决的就是这个。

有问题留言。