【教程】极空间 NAS 配置 Calibre-Web 搭建个人图书馆
# 极空间 NAS 配置 Calibre-Web 搭建个人图书馆
# 功能简介
平时喜欢搜集网络上的精品电子书,那么管理成为了一个问题,放在硬盘的一堆电子书文件,想看也不知道看哪本,然后就想到是否可以搭建一个电子书管理平台,方便管理、搜索和下载阅读。 后来再往上了解到 Calibre web (opens new window) 这样的一个开源项目,可以比较方便的管理电子书,而且支持docker安装。比较容易集成到群晖NAS中,于是就完成了这样的项目搭建。功能包括:
- 管理自己的电子书,可管理海量书籍,包括书籍的分类、作者、简介等
- 可在线观看、书籍格式转换、推送到 Kindle 等
- 可选:通过 frp 等内外穿透工具实现任意地方访问
# 镜像配置
# 1. 下载镜像
打开 Docker 仓库,搜索 calibre-web
下载
star 数量比较多的有两个,linuxserver/calibre-web
和 technosoft2000/calibre-web
,据说后者支持电子书转换等功能,功能更加强大,因此选择后者。
对应的 Docker Hub 地址:technosoft2000/calibre-web (opens new window) - Docker Hub
PS:试过很多的 Calibre web 镜像,这个镜像是功能最强大的,包括电子书格式转换和在线阅读,而 linuxserver/calibre-web (opens new window) 只能没有在线阅读和转换的功能。
# 2. 文件夹路径设置
下载完成后,双击打开我们的镜像,直接来到【文件夹路径】。新建一个 Docker 文件夹,Docker 文件夹下新建一个 Calibre_Web_latest 文件夹,并选中它
# 3. 端口设置
配置端口,可以自定义,容器端口是 8083
# 4. 文件夹访问权限
添加文件夹读写权限,否则后面上传书籍数据库会报错没有权限。
然后应用,其他配置可以不修改。可以启动容器了,启动过程比较慢,因为需要从github上下载不少资源。
# 网页登录管理
启动好容器之后在浏览器输入网址:http://NAS_IP:8083/ 可以访问管理界面了,默认登录账号是:admin/admin123
登录好之后可以修改管理界面语言,修改管理员密码等操作。
在书库配置中,设置为 /books
,点击保存。
此时会提示 数据库路径无效,请输入正确的路径
。
由于 Calibre-web 是基于 Calibre 这款软件的,书库里会有 metadata.db
的数据库文件,而我们创建的文件夹是没有任何文件。
因此我们电脑中安装 Calibre (opens new window),然后用电脑挂载群晖,在此位置建立一个空白书库(注意:群晖需要安装 WebDAV Server)。
完成后,就会在该位置生成一个 metadata.db
的文件。然后重试,提示配置已经更新。
点击登录,用户名:admin 密码:admin123
# 网页配置
# 1. 设置中文
默认为英文界面,在 admin → language 设置即可。
# 2. 开启网页上传,对于少量书籍上传非常实用
在管理权限 → 编辑基本配置 → 功能配置中,其它功能也可在此开启。
刷新一下页面,在右上角则出现上传书籍。测试上传书籍报错:
数据库错误:(sqlite3.OperationalError) attempt to write a readonly database [SQL: INSERT INTO authors (name, sort, link) VALUES (?, ?, ?)] [parameters: (u'\u672a\u77e5', u'\u672a\u77e5', u'')] (Background on this error at: http://sqlalche.me/e/e3q8)。
原因在于无写入权限,将容器的环境配置中设置一下该文件夹的权限,新增两行, PGID
和 PUID
值为 0
(表示,可读取、写入)。(读取、写入应该就可以了),然后重启容器,即可解决此问题。
成功在 Web 上传:
上传或编辑书籍时,可点击最下面的获取元数据,即可获得作者、解决、封面图片等各类信息,这是我非常喜欢的一个功能,很强大。获取后保存即可,封面更改有时会迟一点生效。
# 3. 转换书籍为 epub 格式从而在线观看
此程序可以在线观看 TXT、pdf 和 epub 格式,epub 格式是一个通用的电子书格式,因此将其它书籍转换为此格式从而在线阅读。
这样就可以在线阅读了,有目录导航,可以添加书签,全屏阅读等,并且可以记住阅读位置,下一次打开接着阅读(不可跨设备,书签可以跨设备),体验非常棒。
# 批量上传电子书
那么如果有大量电子书该如何上传呢?思路还是一样,直接用电脑挂载极空间的文件夹,使用 Calibre (opens new window) 打开该书库,然后就可以批量上传、管理了。
# 总结
总之,搭建过程还是较为麻烦,涉及的方面较多,需要了解相关的基础知识,但是此篇教程我写的较为详细,相信只要耐心都能搭建成功,毕竟我使用这个有一段时间了,有的需要注意的地方我都写出来了,Docker 映像也选择好了, 注意文件夹的权限是一个大坑,搭建不成功很大方面是这个原因。
另外内外穿透方面,这涉及的更多了,提供这一种思路,有能力自行折腾了。