飞牛nas利用docker部署calibre-web
4framers
2026年02月08日 17:49
飞牛Nas

引言

写这篇专栏的原因是我最近刚装了飞牛,正在折腾研究中,想到部署一个个人文档知识库管理器,就选择了calibre-web(经过了时间的考量),但是各种论坛以及阿B都没有比较新的攻略,并且我自己部署的过程中遇到了许多问题是网上很少有提到的,遂写此篇以供参考。

docker部署calibre-web

首先讲一下最简单的也是最开始的部分,如何在飞牛nas上利用docker部署calibre-web。

如图,目前镜像仓库中有较多的calibre-web镜像,但我选择linuxserver/calibre-web的原因有:

1、该镜像是官方镜像,多年持续更新,虽然有不少民间大神制作的添加了如自动转换格式、自动订阅等功能的第三方镜像,但因为用爱发电的原因没法持续更新,只有官方镜像时常更新优化。

2、calibre和calibre-web中选择后者是因为前者更注重与本地的阅读体验,而后者更倾向仓库管理,如果你只是想在本地对自己的书库进行阅读管理,可以考虑前者。

点击下载

确定

在文件管理中docker文件夹下如图新增文件夹

运行

其他设置保持默认,存储设置和环境变量参考上方两张图

存储位置:

左侧是宿主机文件路径即前面我说的新建的两个文件夹books和config的原始路径,第三个为books和config的母文件夹即calibre,我的该文件夹位于docker/calibre-web

右侧是docker内文件夹路径从上到下分别是/books,/config,/app/calibre-web/cps/metadata_provider(该文件夹用于存放插件)

环境变量照抄即可,特别是PUID和PGID,我一开始没有添加这两个权限设置导致在设置数据库文件位置时无法访问,因为docker内默认是root权限访问的,虽然大部分的镜像都允许root访问但少部分例如calibre-web是只允许1000权限访问

然后添加空数据库文件metadata.db到books文件夹中(metadata.db获取可以通过下载calibre的pc端,从文件夹中导入nas或者到我的115网盘下载: https://115cdn.com/s/swf4y3w3zjk?password=x8f4&#metadata.db 访问码:x8f4)

完成后点击启动来到登录界面,默认账号:admin,默认密码:admin123

初始界面是上图的英文版,此时需要进行数据库配置才能进行别的设置,设置calibre数据库路径为/books

在admin profile中设置语言为中文就可得到中文界面

此时可以看到书架是空的且没有上传书籍按钮,这时需要点击右上角管理权限

在配置一栏中选择编辑基本配置

在功能配置中选择启用上传,此时刷新网页就会发现最上方出现上传书籍按钮,后续需要添加自己的书籍可以由此开始。至此calibre-web的基本功能已经实现

添加豆瓣源实现刮削书籍元数据

停止calibre-web容器,在github上搜索fugary/calibre-web-douban-api仓库下载最新豆瓣源,这是一个py文件,将其传入nas的docker/calibre-web文件夹内,重启calibre-web容器

在已传入书籍的情况下随机选择一本,点击最下方编辑元数据

页面底部点击获取元数据

此时我们发现豆瓣源已启用,选择对应的版本的元数据即可

calibre-web推送书籍到kindle

kindle这玩意我用了大概有十二年了,前几年亚马逊退出中国市场后我注册了美亚账号然后结合zlibrary使用,最早zlib的推送到kindle我记得是免费项目,后来需要每个月捐献,不过那时捐献的最低标准是1刀每月,而现在是5刀每月,钱包实在顶不住,calibre这个功能刚好可以平替,此后zlib只用来搜索以及下载资源

首先点击右上角的账户进行用户配置

填写邮箱地址和发送至电子阅读器的电子邮箱地址

邮箱地址即后续要通过其发送书籍到kindle邮箱的邮箱地址,我这里选择使用网易163邮箱,国内各家邮箱都是可以选用的,尽量不要使用gmail因为设置起来麻烦

电子阅读器的电子邮箱地址即在kindle的设置中点击您的账户,最下方显示的【发送至Kindle】电子邮箱地址

填写完毕后点击最下方的保存

点击右上角管理权限设置,进行SMTP邮件服务器设置

按照上图提示填写

这里的SMTP密码不是你邮箱的密码,而是SMTP邮箱服务器授权密码,接下来以网易163邮箱为例说明如何开启SMTP功能以及如何获取授权密码

在mail.163.com上登录自己的邮箱,点击最上方设置

选择POP3/SMYP/IMAP

开启任一SMTP服务

根据提示获取授权码

在亚马逊账户设置的内容与设备除填写信任kindle邮箱以及发送书籍使用的邮箱

以上工作都做好后返回calibre-web邮件服务器设置页面填写完毕,选择保存设置并发送测试邮件

此时我们能在收件箱中找到该邮件,代表设置成功,后续可以将书籍发送至kindle