【教程】极空间 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 映像也选择好了， 注意文件夹的权限是一个大坑，搭建不成功很大方面是这个原因。
另外内外穿透方面，这涉及的更多了，提供这一种思路，有能力自行折腾了。