首先感谢GitHub – janeczku/calibre-web↗的二百多个贡献者,他们在GitHub – mutschler/calibreserver↗的基础上进一步实现了一个内容服务器,以下的安装流程也来自GitHub – janeczku/calibre-web Wiki↗。
安装需要如下三个软件:
sudo apt install python-is-python3 python3-pip python3-venv
其中虚拟环境并非必须的,但是考虑到后续的安装维护和可迁移性,建议使用虚拟环境。
检查python版本:
python -V
pip -V
创建虚拟环境:
python3 -m venv /path/to/venvfolder
在虚拟环境安装calibre-web:
/path/to/venvfolder/bin/python3 -m pip install calibreweb
升级与之类似
/path/to/venvfolder/bin/python3 -m pip install --upgrade calibreweb
鉴于官方源太慢,可以使用其他镜像源或者本地安装,如豆瓣:https://pypi.douban.com/simple
或阿里:https://mirrors.aliyun.com/pypi/simple
,形如:
/path/to/venvfolder/bin/python3 -m pip install -i https://mirrors.aliyun.com/pypi/simple /path/to/calibreweb.whl
豆瓣源似乎存在同步问题,部分轮子版本过新或过旧,换阿里源则无问题,使用豆瓣源报错显示如下:
ERROR: Could not find a version that satisfies the requirement advocate<1.1.0,>=1.0.0 (from calibreweb)
ERROR: No matching distribution found for advocate<1.1.0,>=1.0.0
启动:
/path/to/venvfolder/bin/cps
或
/path/to/venvfolder/bin/python3 -m calibreweb
默认的启动端口为8083,如有防火墙需提前放行。初始用户及密码为admin@admin123。日志及配置文件等保存在/home/youruser/.calibre-web/
下。启动后需要一分钟左右等待加载完毕。
最后附上systemed服务写法:
[Unit]
Description=Calibre-Web
[Service]
Type=simple
User=youruser
ExecStart=/path/to/venvfolder/bin/cps
[Install]
WantedBy=multi-user.target
以及必备操作:
sudo nano /etc/systemd/system/calibreweb.service
sudo systemctl daemon-reload
sudo systemctl start calibreweb.service
sudo systemctl status calibreweb.service
sudo systemctl enable calibreweb.service
另外,即使在配置ExecStart=/path/to/venvfolder/bin/cps
,但在实际执行中仍会变成ExecStart=/path/to/venvfolder/bin/python3 /path/to/venvfolder/bin/cps
。