5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

1. 前言

亚马逊中国将在 2023 年 6 月 30 日之后停止运营 Kindle 电子书店,正式退出中国市场,自此用户将无法再通过亚马逊中国账户继续购买电子书。

Z-Library 的域名日前被美国邮政检查局查封。

这期我们正好来介绍一下电子书相关的项目 ——Calibre-Web。

Calibre-Web 是一个网络应用,为使用有效的 Calibre 数据库浏览、阅读和下载电子书提供一个简洁的界面。

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

Calibre-Web 适合用来管理哪些内容:

其实除了电子书外,calibre-web 管理漫画、CG 和画集也是很方便的。

除了已经是 epub 格式的内容,其实一些其他常见漫画格式也能很方便的添加进 calibre-web 里。

比如漫画有很多只是把图片打包成 zip 文件而已,而 calibre-web 有人觉得没法直接认出 zip 格式的文件会不方便管理,其实直接把文件后缀从 zip 改成 cbz,calibre-web 就能直接认出来了,并且能直接在线阅读。这样一来很多 zip 漫画就不用费力去转 epub 格式了。(rar 和 7z 格式也是同理,但如果压缩包内有图片之外的文件或者 png 和 gif 格式的图片 calibre-web 目前认在线阅读认不出来,但可以下载下来)。

1.1 主要特点

  • Bootstrap 3 HTML5 界面
  • 全图形化管理界面
  • 具有细化的每个用户权限的用户管理
  • 支持巴西语、捷克语、荷兰语、英语、芬兰语、法语、加利西亚语、德语、希腊语、匈牙利语、意大利语、日语、高棉语、韩国语、波兰语、俄语、简体和繁体中文、西班牙语、瑞典语、土耳其语、乌克兰语、越南语
  • 支持用于电子书阅读器应用程序的 OPDS feed
  • 支持通过标题、作者、标签、系列、书籍格式和语言进行过滤和搜索
  • 支持创建一个自定义的图书集(书架)
  • 支持编辑电子书元数据和从 Calibre 图书馆删除电子书
  • 支持从各种来源下载电子书元数据,来源可以通过外部插件扩展
  • 支持通过 Calibre 二进制文件转换电子书
  • 支持限制电子书下载给已登录的用户
  • 支持公共用户注册
  • 支持通过点击按钮将电子书发送到电子阅读器上
  • 支持通过 Calibre-Web 与您的 Calibre 图书馆同步您的 Kobo 设备
  • 支持在浏览器中直接阅读电子书(.txt, .epub, .pdf, .cbr, .cbt, .cbz, .djvu)
  • 支持上传多种格式的新书,包括音频格式(.mp3、.m4a、.m4b)。
  • 支持 Calibre 自定义列
  • 能够根据类别和每个用户的自定义栏目内容来隐藏内容
  • 自动更新
  • “魔力链接 “登录,使之易于登录电子阅读器
  • 通过 LDAP、google/github oauth 和通过代理认证登录

1.2 相关地址

GitHub:https://github.com/janeczku/calibre-web

Docker 镜像 ——linuxserver.io(专门团队构建,仍在更新中):https://hub.docker.com/r/linuxserver/calibre-web (本次采用)

支持

Architecture Available Tag
x86-64 amd64-
arm64 arm64v8-
armhf arm32v7-

Docker 镜像 ——technosoft2000(国人构建,目前已停止维护):https://hub.docker.com/r/technosoft2000/calibre-web

2. 项目展示

UI 看起来还是略显古老 = =

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

这边直接丢出搭建的 docker-compose.yaml 文件,熟悉 docker 环境的小伙伴可以直接拷贝搭建。

以 root 用户为例子:

---
version: "2.1"
services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - DOCKER_MODS=linuxserver/mods:universal-calibre #optional
      - OAUTHLIB_RELAX_TOKEN_SCOPE=1 #optional
    volumes:
      - ./data:/config
      - ./library:/books
    ports:
      - 8083:8083
    restart: unless-stopped

 

不过只看这个,可能无法彻底解决一些 calibre-web 遇到的问题,可以跳转到后面看如何配置。

以下是详细搭建教程。

3. 搭建环境

  • 服务器:腾讯香港轻量应用服务器 24 元 / 月 VPS 一台咕咕自己搭建用的是 OVH 的独立服务器,演示用的是卢森堡的 BuyVM,如果你只是小范围使用,可以考虑用 腾讯轻量购买链接的服务器,(最好是选非大陆(香港)的服务器 )如果是小白刚开始玩的话,还可以购买 Racknerd 的服务器,最低一年不到 100 块(不过这个建议选择 1G 内存以上的机器)(Racknerd 服务器介绍: 点击查看
  • 系统:Debian 10(DD 脚本 非必需 DD 用原来的系统也 OK,之后教程都是用 Debian 或者 Ubuntu 搭建~)
  • 安装好 Docker、Docker-compose(相关脚本
  • 【非必需但建议】域名一枚,并做好解析到服务器上(域名购买、域名解析 视频教程
  • 【非必需】提前安装好宝塔面板海外版本 aapanel,并安装好 Nginx(安装地址
  • 【非必需本教程选用】安装好 Nginx Proxy Manager(相关教程

3.1 注意点

此项目启动可能会花一点时间,请耐心等待或者用 docker-compose logs 查看日志情况。

4. 搭建视频

YouTube:https://youtu.be/Of9191QD2ng

哔哩哔哩【高清版本可以点击去吐槽到 B 站观看】:

5. 搭建方式

安装系统(腾讯云轻量应用服务器)

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

腾讯云轻量服务器最大的特点就是 “轻量”,相比 CVM,更适合小白上手,这边我们之间选择 Docker 基础镜像,就可以省去后面安装 Docker 的步骤(如果你非要用国内的服务器,这边装的 Docker 镜像还会帮你配置好国内镜像源,让你加速访问 docker 镜像资源)。

登陆(腾讯云轻量应用服务器)

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5.1 服务器前期配置

服务器初始设置,参考:

新买了一台服务器 “必须” 要做的 6 件小事

保护好你的小鸡!保姆级服务器安全教程!

这边由于我们用的是腾讯云轻量应用服务器,系统默认就帮我们创建了名字是 lighthouse 的用户,系统后台也有防火墙(默认就开了几个常用的端口)

对小白用户来说,可以不用再去管繁琐的服务器安全的配置,大大降低了服务器防护的门槛。

【Docker 系列】不用宝塔面板,小白一样可以玩转 VPS 服务器!

sudo -i # 切换到root用户

apt update -y  # 升级packages

apt install wget curl sudo vim git -y  # Debian系统比较干净,安装常用的软件

注意:VPS 的内存如果过小,建议设置一下 SWAP,一般为内存的 1-1.5 倍即可,可以让系统运行更流畅!

设置 SWAP 可以用脚本:

wget -O box.sh https://raw.githubusercontent.com/BlueSkyXN/SKY-BOX/main/box.sh && chmod +x box.sh && clear && ./box.sh

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

选择 18,然后输入你想要扩容的数值即可。

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

使用腾讯云轻量应用服务器的小伙伴可以直接跳到 5.2.4

5.2 安装 Docker(使用腾讯云轻量应用服务器可跳过这一部分)

5.2.1 非大陆服务器 Docker 安装

wget -qO- get.docker.com | bash
docker -v #查看docker版本
systemctl enable docker # 设置开机自动启动

修改 Docker 配置(可选)(来自烧饼博客

以下配置会增加一段自定义内网 IPv6 地址,开启容器的 IPv6 功能,以及限制日志文件大小,防止 Docker 日志塞满硬盘(泪的教训):

cat > /etc/docker/daemon.json <<EOF
{
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "20m",
        "max-file": "3"
    },
    "ipv6": true,
    "fixed-cidr-v6": "fd00:dead:beef:c0::/80",
    "experimental":true,
    "ip6tables":true
}
EOF

然后重启 Docker 服务:

systemctl restart docker

5.2.2 非大陆服务器 Docker-compose 安装

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version #查看docker-compose版本

5.2.3 国内服务器安装 docker

curl -sSL https://get.daocloud.io/docker | sh
docker -v #查看docker版本
systemctl enable docker  # 设置开机自动启动

修改 Docker 配置(可选)(来自烧饼博客

以下配置会增加一段自定义内网 IPv6 地址,开启容器的 IPv6 功能,以及限制日志文件大小,防止 Docker 日志塞满硬盘(泪的教训):

cat > /etc/docker/daemon.json <<EOF
{
    "log-driver": "json-file",
    "log-opts": {
        "max-size": "20m",
        "max-file": "3"
    },
    "ipv6": true,
    "fixed-cidr-v6": "fd00:dead:beef:c0::/80",
    "experimental":true,
    "ip6tables":true
}
EOF

 

然后重启 Docker 服务:

systemctl restart docker

 

5.2.4 国内服务器安装 docker-compose

curl -L https://get.daocloud.io/docker/compose/releases/download/v2.1.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

chmod +x /usr/local/bin/docker-compose

docker-compose --version  #查看docker-compose版本

 

5.3 安装 NginxProxyManager

参考这边的内容:https://blog.laoda.de/archives/nginxproxymanager

5.4 创建安装目录

创建一下安装的目录:

 

sudo -i

mkdir -p /root/data/docker_data/calibre-web

cd /root/data/docker_data/calibre-web

这边我们直接用 docker 的方式安装。

vim docker-compose.yml

英文输入法下,按 i

---
version: "2.1"
services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=0
      - PGID=0
      - TZ=Asia/Shanghai
      - DOCKER_MODS=linuxserver/mods:universal-calibre #optional
      - OAUTHLIB_RELAX_TOKEN_SCOPE=1 #optional
    volumes:
      - ./data:/config
      - ./library:/books
    ports:
      - 8083:8083
    restart: unless-stopped

注意,这边咕咕是以 root 身份来运行的,所以这边的 PUID=0PGID=0

我们可以在命令行里输入 id,查看当前的 id 情况,如果你也是 root 运行的,那么不需要改,如果你是别的用户运行的,请把 0 改成对应 id 输出的数字,不然后续会出现无法连接数据库的情况。

没什么问题的话,复制完上面的内容后,

按一下 esc,然后:wq 保存退出,之后,

最后:

cd /root/data/docker_data/calibre-web    # 来到dockercompose文件所在的文件夹下

docker-compose up -d

配置数据库

docker exec -it calibre-web sh #进入容器内部

cd /app/calibre/bin #进入bin文件夹

calibredb restore_database --really-do-it --with-library /books #创建一个数据库

chmod a+w /books/metadata.db #添加写的权限

exit  # 退出容器

5.5 打开服务器防火墙并访问网页

打开防火墙的端口 8083

腾讯云打开方法如下:

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

图中示例填的是 5230,备注填的是 memos,这边我们填 8083,示例填 calibre-web ,确定即可(如果你在 docker-compose 文件里换了 8081,这边就需要填 8081,以此类推)

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

查看端口是否被占用(以 8083 为例),输入:

lsof -i:8083 #查看8083端口是否被占用,如果被占用,重新自定义一个端口

如果啥也没出现,表示端口未被占用,我们可以继续下面的操作了~

如果出现:

-bash: lsof: command not found

 

运行:

apt install lsof #安装lsof

如果端口没有被占用(被占用了就修改一下端口,比如改成 8081,注意 docker 命令行里和防火墙都要改)

理论上我们就可以输入 http://ip:8083 访问了。

默认账号:admin
默认密码:admin123

注意:

1、不知道服务器 IP,可以直接在命令行输入:curl ip.sb,会显示当前服务器的 IP。

2、遇到访问不了的情况,请再次检查在宝塔面板的防火墙和服务商的后台防火墙是否打开对应了端口。

有的小伙伴可能想搭建起来分享给其他人使用,如果后续想要分享给别人,IP + 端口太不优雅了,咕咕建议大家还是搞一个域名,容易记,看起来也更正规一点。这样可以做 https,会让网页更安全。(非要 IP + 端口访问的,可以直接跳到 5.6,并且跳过 6. 反向代理部分)

而且 namesilo 上面 xyz 后缀的域名一年就 7 块钱,可以年抛。

如果想要长期使用,还是建议买 com 后缀的域名,更加正规一些,可以输入 laodade 来获得 1 美元的优惠(不知道现在还有没有)

namesilo 自带隐私保护,咕咕一直在用这家,价格也是这些注册商里面比较低的,关键是他家不像其他家域名注册商,没有七七八八的套路!(就是后台界面有些 古老 = =)

【域名购买】Namesilo 优惠码和域名解析教程(附带服务器购买推荐和注意事项)

我们接着往下看!

5.6 更新

5.6.1 docker-compose 部署

cd /root/data/docker_data/calibre-web 

docker-compose down 

cp -r /root/data/docker_data/calibre-web /root/data/docker_data/calibre-web .archive  # 万事先备份,以防万一,其实这边没必要,因为我们没有映射到本地文件夹

docker-compose pull

docker-compose up -d    # 请不要使用docker-compose stop来停止容器,因为这么做需要额外的时间等待容器停止;docker-compose up -d直接升级容器时会自动停止并立刻重建新的容器,完全没有必要浪费那些时间。

docker image prune  # prune 命令用来删除不再使用的 docker 对象。删除所有未被 tag 标记和未被容器使用的镜像

提示:

 

WARNING! This will remove all dangling images. Are you sure you want to continue? [y/N]

 

输入 y

利用 Docker 搭建的应用,更新非常容易~

5.7 卸载

cd /root/data/docker_data/calibre-web 

docker-compose down 

rm -rf /root/data/docker_data/calibre-web   # 完全删除映射到本地的数据

可以卸载得很干净。

6. 反向代理

6.1 利用 Nginx Proxy Manager

在添加反向代理之前,确保你已经完成了域名解析,不会的可以看这个:域名一枚,并做好解析到服务器上域名购买、域名解析 视频教程

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

之后,登陆 Nginx Proxy Manager(不会的看这个:安装 Nginx Proxy Manager 相关教程))

注意:

Nginx Proxy Manager(以下简称 NPM)会用到 80443 端口,所以本机不能占用(比如原来就有 Nginx)

直接丢几张图:

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

注意填写对应的域名IP 和端口,按文章来的话,应该是 8083

IP 填写:

如果 Nginx Proxy Manager 和 libreoffice 在同一台服务器上,可以在终端输入:

ip addr show docker0

查看对应的 Docker 容器内部 IP。

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

否则直接填 calibre-web 所在的服务器 IP 就行。

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

再次打开,勾选这些:

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

然后就可以用域名来安装访问了。

6.2 利用宝塔面板

发现还是有不少小伙伴习惯用宝塔面板,这边也贴一个宝塔面板的反代配置:

直接新建一个站点,不要数据库,不要 php,纯静态即可。

然后打开下面的配置,修改 Nginx 的配置。

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

代码如下:

location / {
  proxy_pass http://127.0.0.1:8083/;       # 注意改成你实际使用的端口
  rewrite ^/(.*)$ /$1 break;
  proxy_redirect off;
  proxy_set_header Host $host;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header Upgrade-Insecure-Requests 1;
  proxy_set_header X-Forwarded-Proto https;
}

此方法对 90% 的反向代理都能生效。

有同学可能会问,为什么不直接用宝塔自带的反向代理功能。

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

也可以,不过咕咕自己之前遇到过当有多个网站需要反代的时候,在这边设置会报错的情况 = =

所以后来就不用了,直接用上面的方法来操作了。

7. 使用教程

其他的见咕咕的视频,这边简单贴一下。

7.1 配置数据路径

填入 /books 即可

7.2 更改语言

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

7.3 扩展程序配置(转换格式)

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

Calibre 电子书转换器路径: /usr/bin/ebook-convert

KEpubify 电子书转换器路径: /usr/bin/kepubify

7.4 后台启用上传

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

7.5 启用用户阅读权限

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

7.6 转换书籍格式

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

7.7 搜刮元数据

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

5 分钟搭建一个在线电子书库 / 漫画 / CG / 画集库

注意选一个即可,豆瓣的不可用,因为我们是香港的机器,所以可以直接使用 Google 的搜刮~

其他的见咕咕的视频,或者自己琢磨一下 = =

8. 目前遇到的问题

8.1 数据库无法读取问题

请注意 docker-compose.yml 里面的 PUIDPUID 是否填写正确。

8.2 无法上传问题

请注意你是否打开了用户上传的权限。

8.3 豆瓣元数据无法获取

目前咕咕也没找到好的办法

8.4 移动端阅读器推荐

咕咕手机上看书比较少,大家在 iOS 和 android 上有好用的 app 欢迎在评论区推荐。

9. 结尾

祝大家用得开心,有问题可以去 GitHub 提 Issues,也可以在评论区互相交流探讨。

同时,项目处于刚开始阶段,有能力给项目做贡献的同学,也欢迎积极加入到项目中来,贡献自己的一份力量!

参考资料

GitHub:https://github.com/janeczku/calibre-web

Docker 镜像 ——linuxserver.io(专门团队构建,仍在更新中):https://hub.docker.com/r/linuxserver/calibre-web (本次采用)

Docker 镜像 ——technosoft2000(国人构建,目前已停止维护):https://hub.docker.com/r/technosoft2000/calibre-web

Docker - Calibre-web Container Setup with New Calibre Database:
https://fictionbecomesfact.com/calibre-web-container

Calibre-web 部署后一些细节问题答疑:https://zhuanlan.zhihu.com/p/357220232

本文内容来自网络