前言
喜欢收藏电子书的朋友，大概都有过这样的烦恼：下载的书籍散落在各个文件夹里，想找一本特定的书翻半天；想在手机、平板和电脑之间同步阅读进度，却苦于没有统一的管理工具。今天，我们就在飞牛NAS上通过Docker部署Calibre-Web，把散落的电子书统一管理起来，搭建一个随时随地都能访问的个人线上图书馆。
Calibre-Web是Calibre的网页版管理界面，它本身不处理电子书格式转换（那是Calibre的强项），但它能提供漂亮的书籍封面展示、多用户权限控制、在线阅读和OPDS订阅功能。配合飞牛NAS的大容量存储，非常适合作为家庭或小团队的电子书共享平台。
一、准备工作
在开始之前，请确保你的飞牛NAS已经开启Docker服务，并且有足够的存储空间。建议为电子书单独建立一个文件夹，方便备份和管理。我习惯在存储空间里建一个/vol1/1000/books的目录，你也可以根据自己NAS的目录结构灵活调整。
另外，我们需要准备两个持久化目录：一个用于存放Calibre-Web的配置数据，另一个用于存放电子书文件。
二、Docker部署步骤
1. 拉取镜像
打开飞牛NAS的「Docker」应用，进入「镜像」页面，搜索calibre-web。推荐使用linuxserver/calibre-web这个镜像，维护活跃且文档齐全。点击「下载」并选择latest标签。
如果你喜欢命令行操作，也可以通过SSH连接NAS后执行：
docker pull linuxserver/calibre-web:latest
2. 创建容器
在「容器」页面点击「创建」，进行如下配置：
基础设置：容器名称填写calibre-web，镜像选择刚才下载的。
端口映射：容器内部端口8083映射到NAS的某个未被占用的端口，比如18083。格式为18083:8083。这样以后访问http://你的NAS地址:18083就能打开Calibre-Web。
存储空间映射：这里需要建立两个映射。第一个映射将/vol1/1000/books挂载到容器内的/books目录（这是电子书存放位置）。第二个映射将/vol1/1000/docker/calibre-web挂载到容器内的/config（这是配置和数据目录）。注意：/config目录必须是空的或者不存在，首次启动时容器会自动初始化。
环境变量：建议设置PUID和PGID为0（root用户），或者你NAS上常用的非root用户ID，这样可以避免文件权限问题。时区设置为Asia/Shanghai。
配置完成后，点击「创建」并启动容器。
3. 首次启动与初始化
容器启动后，打开浏览器访问http://你的NAS地址:18083。首次访问会进入数据库初始化界面，这里需要指定/books路径下的一个metadata.db文件。如果没有这个文件，我们需要先在NAS上创建。
通过SSH进入NAS，在/vol1/1000/books目录下执行：
cd /vol1/1000/books
touch metadata.db
然后在Web页面输入/books/metadata.db作为数据库路径，点击「初始化」。稍等片刻，就会进入登录页面。默认管理员账号是admin，密码是admin123，登录后请立即修改密码。
三、基础配置与使用
1. 设置中文界面
登录后，点击右上角的「管理」图标，进入「编辑基本配置」。在「界面语言」下拉框中选择简体中文，保存后刷新页面即可。
2. 添加电子书
Calibre-Web支持两种方式添加书籍：
方式一：Web界面上传。在「书籍」页面点击「添加书籍」，选择本地文件上传。这种方式适合少量添加。
方式二：直接放入文件夹。把电子书文件直接复制到NAS的/vol1/1000/books目录下，然后在Calibre-Web的「管理」页面点击「重新扫描书籍文件夹」。这种方式适合批量导入。
支持的格式包括EPUB、MOBI、PDF、TXT等常见格式。建议优先使用EPUB格式，在网页阅读时体验最佳。
3. 配置在线阅读
Calibre-Web内置了在线阅读器，无需额外配置。在书籍详情页点击「阅读」按钮，即可在浏览器中直接打开。对于EPUB格式，阅读器支持书签、目录跳转和字体大小调整；PDF格式则调用浏览器的内置阅读器。
4. 多用户管理
在「管理」->「用户」页面，可以创建多个用户账号。可以为每个用户设置不同的权限，比如仅限借阅、可以上传、或完全管理。这是家庭共享或小团队使用的关键功能，避免所有人共用管理员账号。
四、进阶技巧
1. 开启OPDS订阅
OPDS（开放出版物分发系统）可以让支持该协议的阅读器（如Android上的Lithium、iOS上的KyBook）直接订阅你的书库。在「管理」->「编辑基本配置」->「功能配置」中，勾选「启用OPDS」，保存后阅读器端配置http://你的NAS地址:18083/opds即可。
2. 定时扫描书籍文件夹
如果你经常通过SMB或WebDAV向/books目录添加新书，可以在「管理」->「定时任务」中设置自动扫描。建议每天凌晨执行一次，这样新书会自动入库，无需手动干预。
3. 使用Calibre桌面版做精细管理
Calibre-Web适合日常管理和阅读，但如果需要对书籍元数据进行批量编辑、转换格式或合并系列，建议在电脑上安装Calibre桌面版，编辑完成后将书库文件同步到NAS。Calibre-Web会直接读取这些元数据。
五、常见问题排查
问题一：登录后无法上传书籍，提示权限不足。 这通常是/books目录权限问题。检查容器环境变量中PUID和PGID是否与你NAS上对/vol1/1000/books目录有写权限的用户一致。
问题二：网页阅读器打不开EPUB文件。 确认文件本身没有损坏，且格式标准。某些从第三方网站下载的EPUB可能包含不规范的CSS，可以尝试用Calibre桌面版重新转换一次。
问题三：数据库损坏如何恢复。 如果metadata.db文件损坏，可以先将它备份，然后删除后重启容器，系统会生成一个新的空数据库。书籍文件不会丢失，重新扫描即可。
总结
通过简单的Docker部署，飞牛NAS就变身成了一台功能完善的电子书服务器。Calibre-Web不仅解决了书籍杂乱无章的问题，还提供了跨设备阅读、多用户共享等实用功能。配合NAS的定时备份，你的书库数据也能得到安全保障。后续如果觉得网页阅读体验不够好，还可以部署Kavita或Jellyfin等媒体服务器来补充漫画和有声书支持。希望这篇教程能帮助你构建一个称心的数字书库。