飞牛NAS部署Calibre-Web：电子书管理系统

为什么选择 Calibre-Web？

很多朋友在 NAS 上存了大量电子书，但用文件夹管理实在痛苦——想找某本书时得翻半天，更别提跨设备同步阅读进度了。Calibre-Web 是一个基于 Web 的电子书管理工具，它完美解决了这个痛点。它不依赖 Calibre 桌面版，独立运行，界面清爽，支持在线阅读、格式转换、多用户管理等特性，是飞牛NAS上搭建个人书库的不二之选。

相比其他方案，Calibre-Web 的优势在于：部署极简（一个 Docker 容器搞定）、资源占用低（512MB 内存即可流畅运行）、中文支持完善，而且它的 OPDS 功能可以让你在手机阅读 APP 里直接浏览书库，体验非常顺滑。

准备工作

在开始之前，请确保你的飞牛NAS已经开启了 Docker 功能（fnOS 自带，无需额外安装）。建议在文件管理器中提前创建好两个目录，用于存放数据：

/vol1/docker/calibre-web/config —— 存放配置和数据库
/vol1/docker/calibre-web/books —— 存放电子书文件

如果你已有 Calibre 桌面版的书籍库，可以直接将整个书库文件夹挂载到 books 目录，Calibre-Web 会自动识别。

第一步：拉取镜像

打开飞牛NAS的 Docker 应用，在「镜像」页面点击「拉取镜像」，输入 lscr.io/linuxserver/calibre-web 并选择 latest 标签。这个镜像由 LinuxServer.io 维护，更新及时，稳定性好。

如果你更喜欢命令行操作，也可以通过 SSH 登录 NAS 后执行：

docker pull lscr.io/linuxserver/calibre-web:latest

第二步：创建容器

这里推荐使用 Docker Compose 方式部署，方便日后管理和升级。在飞牛NAS的「项目」功能中新建一个项目，填入以下内容：

services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
      - DOCKER_MODS=linuxserver/mods:universal-calibre # 可选，启用电子书转换功能
    volumes:
      - /vol1/docker/calibre-web/config:/config
      - /vol1/docker/calibre-web/books:/books
    ports:
      - 8083:8083
    restart: unless-stopped

注意几点：PUID 和 PGID 建议填写你常用用户的 UID/GID（可在 SSH 里执行 id 查看），避免文件权限问题。端口映射中，宿主机 8083 可以改成你喜欢的任意未占用端口。DOCKER_MODS 环境变量用于安装 Calibre 转换工具，如果你不需要在线格式转换，可以删掉这行。

如果不想用 Compose，也可以在 Docker 图形界面里手动创建容器，环境变量和挂载点参照上面的配置即可。

第三步：初始化配置

容器启动后，在浏览器中访问 http://你的NASIP:8083。首次打开会进入配置向导，需要设置两个关键路径：

数据库位置：填写 /books
书籍目录：同样填写 /books

这里要注意，容器内的 /books 对应你宿主机上的书籍文件夹。如果你的书籍文件已经按 Calibre 的标准目录结构存放（即作者/书名/格式），Calibre-Web 会自动扫描导入。如果是散乱的文件，建议先用 Calibre 桌面版整理一次，或者使用 Calibre-Web 的「上传」功能从零开始建立书库。

默认管理员账号为 admin，密码为 admin123，登录后请立即在「管理权限」里修改密码。

第四步：进阶配置与使用技巧

启用在线转换：如果你在 Compose 中加入了 DOCKER_MODS，容器启动时会自动安装 Calibre 转换工具。之后在任何书籍详情页，都可以选择转换为 EPUB、MOBI、PDF 等格式，非常方便。

配置 OPDS 服务：在「管理界面」-「功能配置」中勾选「启用 OPDS」，然后在手机端安装诸如「KyBook」或「阅读」等支持 OPDS 的 APP，添加书库地址 http://你的NASIP:8083/opds，即可实现无线局域网内随时阅读。

多用户管理：Calibre-Web 支持创建多个用户，可以为家人或朋友分配不同权限。比如只读用户无法下载书籍，管理员可以上传和编辑元数据。在「管理用户」页面即可创建。

自动定时扫描：如果你经常往书籍目录里丢新书，可以在「管理界面」-「编辑基本配置」中设置「自动扫描时间间隔」，比如每 60 分钟扫描一次新书，省去手动刷新的麻烦。

美化界面：系统自带多套主题，在「外观」设置中可以切换。如果你喜欢更现代的风格，可以下载社区主题包放到 /config 目录下，然后在主题选项中选择。

常见问题与解决

如果打开页面出现 500 错误，多半是数据库路径不对或权限不足，检查挂载路径是否正确、PUID/PGID 是否匹配。

上传书籍时提示格式不支持，请确认是否启用了 DOCKER_MODS，未启用时只能上传 EPUB/PDF 等常见格式，无法处理 AZW3 或 MOBI 的转换。

手机阅读时无法下载书籍，检查 OPDS 是否开启，以及是否设置了正确的用户权限（下载权限需要在用户设置中单独赋予）。

总结

通过以上四步，你就拥有了一套功能完整的个人电子书管理系统。Calibre-Web 的部署难度极低，但带来的体验提升是巨大的——统一管理、多端同步、在线转换，彻底告别散落各处的电子书文件。飞牛NAS的性能足以流畅运行它，即使同时有 5-6 个用户在线阅读也毫无压力。后续你可以根据使用习惯，慢慢探索它的更多细节功能，比如书评、标签管理、阅读进度同步等。如果你手头有大量电子书资源，强烈建议今天就部署起来，相信你会爱上这种整理书库的乐趣。