Calibre-Web

安装

安装环境

FreeBSD13.2

jail(iocage)

前置条件

由于calibreweb没有标准的FreeBSD安装包，既没有pkg，也没有ports，仅提供使用pip安装的方式。

首先要安装python及一些依赖包，经简单测试，至少需要安装以下包：

xxxxxxxxxx
# pkg install py39-pip py39-libxml2 libxslt rust py39-sqlite3　

安装calibreweb

使用pip安装calibreweb：

xxxxxxxxxx
#　pip install calibreweb

善后工作

Calibre-Web需要一个Calibre数据库(metadata.db)，而以上安装方式不会生成此数据库，所以在首次登录时会要求提供此数据库存放的路径。

官方github项目提供了一个空数据库，下载后放置到书库的根目录即可。

https://github.com/janeczku/calibre-web/raw/master/library/metadata.db

启动Calibre-Web

安装完成后执行以下命令可以启动Calibre-Web：

xxxxxxxxxx
# cps

但关闭此命令后Calibre-Web也将停止。可使用以下命令使其运行在后台模式：

xxxxxxxxxx
# cps &
[1] 94758
# sockstat -4l
USER     COMMAND    PID   FD PROTO  LOCAL ADDRESS         FOREIGN ADDRESS
root     python3.9  94758 8  tcp4   192.168.5.192:8083    *:*

cps命令执行需要一些时间(大约两秒左右)，可以使用sockstat -4l命令查看8083端口是否已经开启，从而确定Calibre-Web是否已经启动。

登录页面

浏览器中输入Calibre-Web服务器地址：

http://[hostname]:8083

默认管理的账号为admin，密码为admin123。

登入后会看到Database Configuration提示，要求指定Calibre数据库路径，实际上就是找metadata.db所在的位置。

此步骤正确设置完成之前，其他任何操作均无法进行。

一些设置

上传权限

默认情况下系统不允许上传文件，需要在“管理权限”→“基本配置”→“功能配置”中开启上传功能。

默认允许上传的文件格式如下：

odt,azw,m4b,wav,ogg,cbz,cbt,rtf,lit,epub,djvu,doc,docx,flac,txt,mp3,pdf,fb2,kepub,mobi,azw3,html,prc,opus,mp4,cbr,m4a

做完以上设置之后，admin账号可以上传书籍。

若新增加用户，需要勾选“允许上传书籍”才能使其具有上传书籍的权限。

上传书籍的大小

默认允许上传小于200MB的书籍，可以通过修改以下文件来更改限制：

xxxxxxxxxx
/usr/local/lib/python3.9/site-packages/calibreweb/cps/server.py

大约在235行：

xxxxxxxxxx
#Max Buffersize set to 200MB
http_server.....
     max_buffer_size=2097000000,

将max_buffer_size的值修改为希望的值。

然后重启cps。

但过大的书籍可能会影响后续阅读，尤其是客户端到服务器的网速不佳时，可能读取失败。

关于calibre

FreeBSD有calibre，可以通过pkg安装，安装完后并没有介绍如何启动它。

可以在/usr/local/bin/目录中找到以下相关程序：

calibre

calibre-complete

calibre-customize

calibre-debug

calibre-parallel

calibre-server

calibre-smtp

calibredb

calibre可以在rc.conf中设置自启动：

xxxxxxxxxx
calibre_enable="YES"
calibre_library="/ebook"
calibre_user="root"

calibre服务启动会打开8080端口，不需要登录即可访问。

可以阅读mobi和azw3文档。