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

功能简介

平时喜欢搜集网络上的精品电子书，那么管理成为了一个问题，放在硬盘的一堆电子书文件，想看也不知道看哪本，正好安装了黑群晖，了解到 Calibre web 这样的一个开源项目，于是就完成了这样的项目搭建。功能包括：

管理自己的电子书，可管理海量书籍，包括书籍的分类、作者、简介等
可在线观看、书籍格式转换、推送到Kindle等
可选：通过frp，反向代理等内外穿透工具实现任意地方访问

Calibre Web 安装步骤

前提：安装好了群晖并安装了 Docker（需要 CPU 支持）

本文采用群晖 DSM7.1 部署，其他版本操作类似。

对应的 Docker Hub 地址：linuxserver/calibre-web - Docker Hub

linuxserver/calibre-web 的镜像详细功能如下

无缝集成calibre单机版图书馆，只要将calibre的数据库文件和相应的图书复制进calibre-web指定目录，calibre的所有书籍就可以通过web端管理阅读推送了。
支持上传下载图书、建立编辑书架功能(上传的时候可从互联网获取完善书籍信息并保存)
在线阅读pdf、epub等格式，支持的电子书格式众多。
支持电子书格式在线转换，如pdf—>epub等等
支持图书推送到自己的kindle设备

等待下载完成后，在映像中，双击下载好的映像，则可以创建容器。

calibre-2022-11-28-21.39.50

calibre_2022-11-28_22-39-58

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

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

首先打开 File Station，创建一个用于存放电子书的文件夹，我是直接建立了一个 books 共享文件夹，然后再建立了一个 calibre 文件夹用于存放电子书（推荐），建好之后，回到 Docker 中来。

首先找到刚才下载的映像，双击 Docker 的映像。

calibre-2022-11-28-21.40.47

然后选择网络，选中 bridge 网络即可，然后点击下一步。

calibre_2022-11-28_21-41-50

设置名称为 calibre-web，可根据喜好设置，勾选 启用自动重新启动 然后点击下一步。（可根据需要设置，若不勾选，则重启群晖则不自动运行此容器。）

calibre_2022-11-28_21-43-10

然后点击端口映射，设置一个本地端口，不冲突即可，如我的为9000，那么之后访问即：http://IP:9000，对应代码中的：-p <HTTP PORT>:8083。不推荐使用默认的自动，这样每次重启会改变端口，造成访问地址的改变。

calibre_2022-11-28_21-45-48

点击卷，添加文件夹，选择刚刚创建用于存放电子书的文件夹，转载路径为/books。

calibre_2022-11-28_21-46-48

点击应用即可，然后启动该容器。此时就安装完成了。

这里打开群晖 IP: 端口访问，如我的 IP 为 192.168.0.102，可以看到已经可以成功打开。

配置书库

在书库配置中，设置为 /books，点击保存。

此时会提示数据库路径无效，请输入正确的路径。

报错

由于 Calibre-web 是基于 Calibre 这款软件的，书库里会有 metadata.db 的数据库文件，而我们创建的文件夹是没有任何文件。

因此我们电脑中安装 Calibre，然后用电脑挂载群晖，在此位置建立一个空白书库（注意：群晖需要安装 WebDAV Server）。

创建书库

完成后，就会在该位置生成一个 metadata.db 的文件。然后重试，提示配置已经更新。

配置

若仍出现问题，则在 File Station 中设置一下该文件夹的权限，设置为 Everyone 为读取、写入。

点击登录，用户名：admin 密码：admin123 （后面进入后台，可以修改密码）

终于成功

配置

设置中文

默认为英文界面，在 admin——language 设置即可。

设置中文

开启网页上传，对于少量书籍上传非常实用

在管理权限 —— 编辑基本配置 —— 功能配置中，其它功能也可在此开启。

启用上传

刷新一下页面，在右上角则出现上传书籍。测试上传书籍报错：

数据库错误：(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)。

原因在于无写入权限，将创建的文件夹设置为完全控制（读取、写入应该就可以了），然后重启容器，即可解决此问题。