calibre-web——云上的电子书图书馆
📚

calibre-web——云上的电子书图书馆

标签
Docker
创建时间
Jan 10, 2022 01:26 PM
上次编辑时间
Last updated February 13, 2023
notion image

说明

calibre 是一款非常出名的全平台的图书管理工具,可以导入不同平台的图书元数据。而 calibre-web 就是一个用 Python 写的服务端。
特性
  • Bootstrap 3 HTML5 界面
  • 完整的图形设置
  • 具有精细的每用户权限的用户管理
  • 管理界面
  • 用户界面荷兰语,英语,法语,德语,匈牙利语,意大利语,日语,高棉语,波兰语,俄语,简体中文,西班牙语,瑞典语,乌克兰语
  • 电子书阅读器应用程序的 OPDS 提要
  • 按标题,作者,标签,系列和语言过滤和搜索
  • 创建自定义书籍收藏(书架)
  • 支持编辑电子书元数据和从口径库中删除电子书
  • 支持通过口径二进制文件转换电子书
  • 将电子书下载限制为登录用户
  • 支持公共用户注册
  • 只需单击一下按钮即可将电子书发送到 Kindle 设备
  • 支持直接在浏览器中阅读电子书(.txt,.epub,.pdf,.cbr,.cbt,.cbz)
  • 上载多种格式的新书
  • 支持口径自定义列
  • 可以根据类别为某些用户隐藏内容
  • 自我更新能力
  • “ Magic Link”登录可轻松登录电子阅读器

部署方法

准备工作:

先在群晖内创建一个用于做书库的文件夹,不建议直接将共享文件夹当作书库,容易出现权限问题。比如我的,先创建一个共享文件夹 books,切换到权限选项卡,设置 http 群组用户权限为可读写。然后在这个文件夹内创建一个书库文件夹命名为 calibre。
然后在电脑上下载安装 calibre,然后将对应书库文件夹里的的所有文件复制上传到群晖的 calibre 文件夹内。

拉取镜像

👉
原本是推荐使用technosoft2000/calibre-web的镜像,不过technosoft2000因为缺乏精力维护,已经更改为推荐使用 linuxserver/calibre-web镜像。
在docker注册表中搜索 linuxserver/calibre-web 然后点击下载
或者
使用ssh进行拉取和部署(群晖可以通过
🕸️
webssh ——通过浏览器进行ssh连接
的方式)
  • ssh 进入终端的方式
  1. Mac 下,直接使用终端,win 想推荐使用 putty。(Mac 终端的方法为:ssh 群晖管理员账号 @ 群晖 ip ,然后输入密码)
  1. 切换到 root 账号模式的方式,进入后 sudo -i 然后输入密码
  • 查看自己群晖账号对应的用户 id 和组 id:
id admin uid=1026(admin) gid=100(users) groups=100(users),101(administrators)
获取 Docker 镜像(如果你之前已经下载了镜像可以跳过这一步)
docker pull linuxserver/calibre-web:latest

创建容器

  • 创建一个 Docker 容器(注意用户 ID 和组 ID,根据需要更改时区和端口)
docker create --name=calibre-web \ --restart=always \ -v /volume1/docker/calibre-web/data:/config \ -v /volume1/books/calibre:/books \ -e SET_CONTAINER_TIMEZONE=true \ -e CONTAINER_TIMEZONE=Asia/Shanghai \ -e DOCKER_MODS=linuxserver/mods:universal-calibre \ -e PGID=100 \ -e PUID=1026 \ -p 8083:8083 \ linuxserver/calibre-web:latest

参数说明

  1. -v 这一行,/volume1/books/calibre 这里换成你的书库文件夹的位置,比如我的就是在第一个盘的 books 共享文件夹的 calibre 文件夹内。
  1. -e CONTAINER_TIMEZONE=Asia/Shanghai 这一行是时区用的是亚洲上海,如果你是在国内可以不用改
  1. -e PGID=101 -e PUID=1024 这一行,是换成上面你查看出来的用户 ID 和组 ID,换成对应的就好了 pgid 是组 ID,puid 是用户 ID
  1. 如果需要电子书转换功能,需要添加 -e DOCKER_MODS=linuxserver/mods:universal-calibre,这个功能是可选的,仅限x86-64使用Calibre实现电子书转换的需求,部署后在Calibre-Web管理页面(基本配置:外部二进制文件)中将Calibre电子书转换器路径 设置为/usr/bin/ebook-convert
  1. -p 8083:8083 是端口映射

启动 和查看容器

  • 启动Docker 容器
docker start calibre-web
  • 分析日志(用 CTRL + C 停止)
docker logs -f calibre-web

设置 calibre:

用浏览器打开 http://群晖IP:8083 会看到初始设置页面:
  • 默认账号:admin 密码:admin123
  • 在数据库位置,填写/books (书库文件夹映射的地址)
  • 用户和其他配置按照自己需要填写

更新容器

  • 更新图像:docker pull linuxserver/calibre-web:latest
  • 停止正在运行的容器:docker stop calibre-web
  • 删除容器:docker rm calibre-web
  • 使用与上述相同的 docker run 参数重新创建一个新容器(如果正确映射到主机文件夹,您的/config文件夹和设置将被保留)

个人经验:

建议在本地电脑使用 calibre 新增图书,然后使用群晖自带同步套件 drive 与群晖上的图书文件夹自动双向同步。

使用

  • IP 或者域名加端口号,直接使用浏览器打开
  • 使用推送服务将电子书推送到 Kindle 阅读
  • 使用支持 opds 的阅读器打开窗,比较推荐的有 ios 的 kybook,Android 的静读天下
    • calibre-web设置:管理权限-点击 guest用户-编辑用户权限-勾选允许下载书籍
    • ios下载kybook3-目录-添加opds目录-URL输入calibre-web的访问网址(网址后加/opds
    • 下载到手机中使用kybook3打开即可阅读

后记

适合对电子书阅读和收藏有特殊需求的人,是目前发现电子书整理和收集最靠谱的私人云方案。

参考文章