如果你是一个爱书之人,手头攒了成千上万本 EPUB、PDF、MOBI,却苦于找不到一个统一的管理和阅读入口,那么 Calibre-Web 会是你的理想选择。它是一款基于 Web 的电子书管理工具,界面清爽,支持在线阅读、元数据编辑、书评、多用户权限管理,还能与 Calibre 数据库无缝对接。今天,我们就手把手在飞牛NAS(fnOS)上,用 Docker 把它部署起来。
为什么选择 Calibre-Web
飞牛NAS 自带的应用中心虽然方便,但电子书管理类应用并不丰富。Calibre-Web 的优势在于:完全免费开源,轻量级,占用资源少,支持 OPDS 协议(方便手机阅读器直接订阅),并且可以多用户共享书架。配合飞牛NAS 的硬件转码和磁盘阵列,你的私人图书馆就能随时在线。
准备工作
在开始之前,请确保你的飞牛NAS 已经开启 Docker 服务(fnOS 默认自带 Docker 引擎,无需额外安装)。另外,建议为电子书单独创建一个共享文件夹,比如在“存储空间1”下新建 books 目录,里面再分 data(存放 Calibre-Web 配置)和 library(存放电子书文件)两个子目录。这样数据与程序分离,备份和迁移都方便。
部署步骤
第一步:拉取镜像
打开飞牛NAS 的 Docker 管理界面(在“应用”或“Docker”菜单中),进入“镜像”页面,点击“拉取镜像”。在搜索框中输入 calibre-web,官方推荐使用 linuxserver/calibre-web 这个镜像,它维护活跃,更新及时。点击拉取,等待完成。
如果你更习惯用命令行,也可以通过 SSH 登录 NAS 后执行:
docker pull linuxserver/calibre-web
第二步:创建容器
镜像拉取完成后,点击“创建容器”,进行如下配置:
容器名称随意,比如 calibre-web。端口映射方面,Calibre-Web 默认监听 8083 端口,我们映射到宿主机的 8083(如果冲突可以改成 8084 或任意空闲端口)。具体格式为 0.0.0.0:8083 -> 8083。
存储空间映射是关键。我们需要挂载两个目录:
- 将你刚才创建的
books/data 挂载到容器内的 /config,用于存放 Calibre-Web 的配置文件。
- 将
books/library 挂载到容器内的 /books,用于存放你的电子书文件。
环境变量方面,建议设置 PUID=1000 和 PGID=1000(飞牛NAS 默认用户组,可以避免权限问题),时区设置为 TZ=Asia/Shanghai。如果你需要开启 Calibre-Web 的电子书上传和转换功能,还需要设置 DOCKER_MODS=linuxserver/mods:universal-calibre(这个稍后细说)。
点击“创建”并启动容器。
第三步:初始化配置
容器启动后,在浏览器访问 http://你的NAS地址:8083,你会看到 Calibre-Web 的登录界面。首次运行需要配置数据库位置。在登录框下方点击“登录”旁边的“设置”链接,或者直接访问 http://你的NAS地址:8083/setup。
在设置页面中,数据库位置填写 /books(因为我们的电子书库挂载在这里)。注意,如果 /books 目录下还没有 metadata.db 文件,Calibre-Web 会提示你上传一个。此时你有两个选择:
- 如果你之前用过 Calibre 桌面版,可以将其导出的
metadata.db 上传到这里,直接复用原有书库。
- 如果你是从零开始,可以先用桌面版 Calibre 在本地创建一个空书库,然后把生成的
metadata.db 文件复制到 books/library 目录下。或者,我们也可以通过命令行快速生成一个空数据库。
更快捷的方式是,在 SSH 终端中进入 books/library 目录,执行 touch metadata.db 创建一个空文件,然后重启 Calibre-Web 容器。它会自动初始化这个文件为合法的 SQLite 数据库。
完成设置后,使用默认账号 admin 和密码 admin123 登录(首次登录后强烈建议立即修改密码)。
第四步:开启电子书上传与转换(可选)
默认情况下,Calibre-Web 只支持通过 Calibre 桌面版或 OPDS 上传书籍。如果你希望直接在网页端上传文件,需要启用 Calibre 的二进制工具。在 Docker 容器的“高级设置”或“环境变量”中,添加 DOCKER_MODS=linuxserver/mods:universal-calibre,然后重建容器(删除原容器,用相同配置重新创建)。这一步骤会向镜像内注入 ebook-convert 等工具,使网页端能直接上传 EPUB、PDF 等格式,并自动转换为适合在线阅读的格式。
重建后,进入 Calibre-Web 的管理界面,在“编辑基本配置” -> “功能配置”中,勾选“启用上传”和“启用 Calibre 转换服务”,保存即可。
第五步:日常使用与优化
现在,你可以通过网页端上传书籍、编辑元数据(封面、作者、标签)、创建书评、为不同用户分配不同书库权限。手机端可以安装支持 OPDS 的阅读器(如 Librera、Moon Reader+),在设置中添加 http://你的NAS地址:8083/opds 作为书源,就能随时随地浏览和下载你的藏书。
为了更好的体验,建议在飞牛NAS 的“文件管理”中,将 books/library 文件夹设置为共享,这样你可以直接从电脑拖拽大量书籍到 NAS 上,Calibre-Web 会自动扫描并更新书库。
总结
通过以上五步,你已经在飞牛NAS 上成功部署了一个功能齐全的 Calibre-Web 电子书管理系统。它不仅解决了多设备访问的问题,还通过多用户权限和 OPDS 支持,让家庭或小团队共享书库变得轻松愉快。整个部署过程不到十分钟,但带来的阅读体验提升却是立竿见影的。如果你在配置过程中遇到权限或端口问题,不妨检查一下 PUID/PGID 设置以及防火墙规则。现在,去享受你的私人云端图书馆吧!