群晖nas搭建个人图书馆一(calibre-web环境搭建)

如果你家里有一台群晖或者可以安装docker的服务器,不妨跟我一起从零开始搭建一个电子书图书馆,这个图书馆使用了开源项目calibre-web,这个项目是基于calibre这个单机版图书馆做出来的,这也是为什么下面需要在相应目录下存放一个calibre的数据库文件的原因。

calibre-web的功能很强大主要有以下几大功能点:

1、无缝集成calibre单机版图书馆,只要将calibre的数据库文件和相应的图书复制进calibre-web指定目录,calibre的所有书籍就可以通过web端管理阅读推送了。

2、支持上传下载图书、建立编辑书架功能(上传的时候可从互联网获取完善书籍信息并保存)

3、在线阅读pdf、epub等格式,支持的电子书格式众多。

3、支持电子书格式在线转换,如pdf--->epub等等

4、支持图书推送到自己的kindle设备

5、支持在线注册用户,用户权限管理(如管理员可指定用户是否拥有上传、阅读、下载等权限)

下面就开始一步步来搭建calibre-web:

打开群晖docker

在docker注册表中搜索calibre,出现很多镜像,星星最多的是linuxserver/calibre-web,为什么这个镜像星星最多,因为这个开发团队一直在维护更新,目前的版本已经非常完善了,所以选择这个镜像没有错,在下载之前我们需要了解这个镜像,点击这个镜像右上角的箭头去docker-hub看这个镜像的使用方法,群晖的镜像启动配置都要去看官方的说明文档而不要去参照网上博客的参数生搬硬套,一旦版本变了官方文档会变化,博客几乎不会更新。
来到镜像的说明网址:
https://registry.hub.docker.com/r/linuxserver/calibre-web/ 翻到参数一栏

这里我们可以看到需要配置的完整内容,-p 代表端口映射是8083,-e代表环境变量配置 ,PUID\PGID是处理权限的,DOCKER_MODS是电子书转换功能需要配置的,OAUTHLIB_RELAX_TOKEN_SCOPE是谷歌登录所需的(当然如果要实现这个肯定要去google申请应用),-v表示目录挂载 需要挂载两个目录分别是/config /books

当我们分析了官方文档后就知道下载完成后启动容器需要配置哪些内容了,这个无论是群晖内的docker还是其他系统的docker,查看官网说明文档是最直接的,切记不要盲目去看别人博客中写的。

前面我们看到要挂载两个目录,我们在群晖docker目录中建一个文件夹linuxserver-cabibre-books,这个文件夹名称根据自己喜好来定,在文件夹里边建立books,config文件夹,文件名也是根据喜欢来写,没必要和我写的一样。
下完镜像后我们点击启动
勾选使用高权限执行容器
在存储空间中添加要挂载的两个文件夹,装载路径是根据官网文档的固定写法,不可变,左侧的文件夹是刚自己建立的两个文件夹。
容器端口8083是官方文档要求的不可变,本地端口只要是没占用的,可以自己定,这边填9000,这个是一会访问需要用到的。

把官网要求加的环境变量全部加上,因为我们要使用全功能的容器,需要添加以下四个环境变量,如上图

PUID $(id -u) 这个写法是指用户的uid是当前用户,也就是哪个用户启动了这个容器,这个容器就使用哪个用户的权限,这个直接关系到挂载的文件夹是否可以读写,很重要。

PGID $(id -g) 这是指定当前用户组的id,保持这个写法即可

OAUTHLIB_RELAX_TOKEN_SCOPE 1 开启谷歌auth

DOCKER_MODS linuxserver/calibre-web:calibre 开启电子书格式转换的能力

补充:官方文档写的GUID\PGID 都填1000 这边不能按照官方的来,因为你不知道你系统的用户id是多少,如果要填写具体数据,就要开启ssh 在群晖中执行 id 用户名 来查看具体的GUID PGID,这里使用$(id -u) $(id -g)是一劳永逸的写法,实际上在读到这边的时候就是执行命令获取相应的id。

检查下各项参数有没有问题
点应用启动,后面在我的网盘中下载一个空白的数据库文件

链接: https://pan.baidu.com/s/13Y-DSQGvezoQiNyLXZW6tg 提取码: cjmt
--来自百度网盘超级会员v5的分享 如下图

补充:为什么要这个数据库文件,因为calibre-web是基于calibre的,它并不负责图书库的创建,所以需要有一个数据仓库,metadata.db就是这个数据仓库,john schember是这个数据仓库中的一本指南书。如果你不使用我的这个空库文件,你也可以去电脑本地安装一个calibre软件,官方下载地址:https://calibre-ebook.com/download,下载安装会让你指定一个数据库存放目录,安装完成后就会自动生成这个数据库文件和第一本一本指南书,去这个目录下拿文件即可。

将文件拖动到群晖linuxserver-calibre-books/books目录中,这一步是calibre-web需要有一个数据库文件,没有后面会报错,做完以后可以登录,根据上面一步步下来,后面的配置会相当顺滑,所有的坑都不复存在了。
输入群晖nas ip:9000 上面配置的端口号访问网站即可登录,登录用户默认是admin, 密码admin123

搭建完毕需要对calibre-web进行详细的配置,可以移步我的另一片博文:

https://www.lategege.com/?p=643
build with Hugo, theme Stack, visits 0