本教程适用于以下操作系统版本
- Ubuntu 22.04 (Jammy Jellyfish)
- Ubuntu 20.04 (Focal Fossa)
本页内容
- 先决条件
- 第 1 步 - 配置防火墙
- 第 2 步 - 下载并安装 Calibre server
- 第 3 步 - 创建 Calibre 书库并添加你的第一本书
- 第 4 步 - 启动 Calibre Server
- 第 5 步 - 创建 systemd service 文件
- 第 6 步 - 启用用户认证
- 第 7 步 - 自动向书库添加书籍
- 第 8 步 - 安装 Nginx
- 第 9 步 - 安装 SSL
- 第 10 步 - 配置 Nginx
- 结论
Calibre 是一款免费开源的电子书管理器。它既是一个跨平台的桌面应用程序,也附带一个服务器组件。桌面组件可以在单台设备上管理你的电子书书库。而服务器组件可以让你:
- 从世界任何地方访问你的书籍。
- 轻松将你的书籍传输到移动设备。
- 与你的朋友和家人分享书籍。
- 直接在网页上阅读电子书。
在本教程中,你将学习如何在一台 Ubuntu 22.04 机器上安装 Calibre server。
先决条件
- 一台运行 Ubuntu 22.04 的服务器。
- 一个具有 sudo 权限的非 root 用户。
- Uncomplicated Firewall(UFW) 已启用并正在运行。
- 一个指向该服务器的完全限定域名。在本教程中,我们将使用域名 calibre.example.com。
- 所有内容均已更新。$ sudo apt update && sudo apt upgrade
一台运行 Ubuntu 22.04 的服务器。
一个具有 sudo 权限的非 root 用户。
Uncomplicated Firewall(UFW) 已启用并正在运行。
一个指向该服务器的完全限定域名。在本教程中,我们将使用域名 calibre.example.com。
所有内容均已更新。
$ sudo apt update && sudo apt upgrade
第 1 步 - 配置防火墙
在安装任何软件包之前,第一步是配置防火墙以允许 HTTP 和 HTTPS 连接。
检查防火墙的状态。
$ sudo ufw status
你应该会看到类似下面的内容。
Status: active
To Action From
-- ------ ----
OpenSSH ALLOW Anywhere
OpenSSH (v6) ALLOW Anywhere (v6)
允许 HTTP 和 HTTPs 端口。
$ sudo ufw allow http
$ sudo ufw allow https
再次检查状态以确认。
$ sudo ufw status
Status: active
To Action From
-- ------ ----
OpenSSH ALLOW Anywhere
80/tcp ALLOW Anywhere
443/tcp ALLOW Anywhere
OpenSSH (v6) ALLOW Anywhere (v6)
80/tcp (v6) ALLOW Anywhere (v6)
443/tcp (v6) ALLOW Anywhere (v6)
第 2 步 - 下载并安装 Calibre server
Ubuntu 22.04 自带 Calibre,但最好直接安装它以获取最新版本。
第一步是安装一些依赖项。
$ sudo apt install libopengl0 libxkbcommon-x11-0 libegl1 libfontconfig libgl1-mesa-glx
下载 Calibre server 安装程序。
$ wget https://download.calibre-ebook.com/linux-installer.sh
使安装脚本可执行。
$ chmod +x ./linux-installer.sh
运行安装程序。
$ sudo ./linux-installer.sh
你会收到一些警告,因为安装程序预期的是桌面环境而不是服务器。忽略这些警告是安全的。
第 3 步 - 创建 Calibre 书库并添加你的第一本书
下一步是建立一个 Calibre 书库并向其中添加一些书籍。在本教程中,我们将从 Project Gutenberg 下载 Arthur Conan Doyle 所著的 The Adventures of Sherlock Holmes 一书。
$ wget http://www.gutenberg.org/ebooks/1661.kindle.noimages -O adventuresofsherlockholmes.mobi
始终从该站点获取书籍的 Kindle 版本。这里,我们将 Kindle 版本重命名为 filename.mobi,因为 Mobi 格式在 Kindle 中原生支持,这就是它在站点上如此命名的原因。相比 Epub 版本,它还提供了更好的格式选项。
为 Calibre 书库创建一个目录。
$ mkdir calibre-library
使用 calibredb 命令将你刚下载的书籍添加到书库。我们在命令本身中指定了书库的位置。
$ calibredb add adventuresofsherlockholmes.mobi --with-library calibre-library/
Added book ids: 1
你可以按以下方式一次性添加多本书籍。
$ calibredb add *.mobi --with-library calibre-library/
第 4 步 - 启动 Calibre Server
现在我们已经准备好了书籍,是时候启动 Calibre server 了。
$ calibre-server calibre-library
calibre-server 命令将书库的位置作为其参数。你应该会看到类似的输出。
calibre server listening on 0.0.0.0:8080
OPDS feeds advertised via BonJour at: your_server_ip port: 8080
这会在 8080 端口上暴露 Calibre server。要查看该服务器,你需要先开放该端口。运行以下命令来开放 8080 端口。
$ sudo ufw allow 8080
在浏览器中打开 URL http://

点击 calibre-library 链接以查看你在上一步中添加的书籍。

在终端中按 Ctrl + C 键关闭服务器。
你可以使用不同的端口来暴露 Calibre server。为此,请使用以下命令。你需要确保该端口已在防火墙中开放。
$ calibre-server calibre-library --port 7654
第 5 步 - 创建 systemd service 文件
要使 Calibre server 进程持久化并在重启后继续运行,你需要为此创建一个 systemd service 文件。
在 /etc/sytemd/system/ 目录中创建一个名为 calibre-server.service 的文件并打开它进行编辑。
$ sudo nano /etc/systemd/system/calibre-server.service
将以下代码粘贴到其中。
[Unit]
Description=Calibre Server
After=network.target
[Service]
Type=simple
User=<username>
Group=<username>
ExecStart=/opt/calibre/calibre-server /home/<username>/calibre-library --enable-local-write
[Install]
WantedBy=multi-user.target
--enable-local-write 标志赋予服务器写权限,以便向书库添加新书籍。这是因为当服务器运行时,你无法使用 calibredb 命令添加书籍。
将上述代码中的
重新加载服务守护进程以激活该 service 文件。
$ sudo systemctl daemon-reload
启用并启动 Calibre 服务。
$ sudo systemctl enable calibre-server
$ sudo systemctl start calibre-server
检查服务的状态。
$ sudo systemctl status calibre-server
? calibre-server.service - Calibre Server
Loaded: loaded (/etc/systemd/system/calibre-server.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2022-07-25 07:23:42 UTC; 15s ago
Main PID: 1877 (BonJour)
Tasks: 13 (limit: 2241)
Memory: 53.3M
CPU: 762ms
CGroup: /system.slice/calibre-server.service
??1877 /opt/calibre/bin/calibre-server /home/<username>/calibre-library --enable-local-write
Jul 25 07:23:42 calibre systemd[1]: Started Calibre Server.
Jul 25 07:23:42 calibre calibre-server[1877]: QStandardPaths: XDG_RUNTIME_DIR not set, defaulting to '/tmp/runtime-<username>'
Jul 25 07:23:42 calibre calibre-server[1877]: calibre server listening on 0.0.0.0:8080
Jul 25 07:23:43 calibre calibre-server[1877]: OPDS feeds advertised via BonJour at: 69.28.84.201 port: 8080
第 6 步 - 启用用户认证
你可以为 Calibre 添加用户认证,以保护你的书库不被任何人访问。首先,停止 Calibre server。
$ sudo systemctl stop calibre-server
Calibre 使用 SQLite 数据库来存储用户凭证。启动 Calibre 的用户管理脚本来添加一个用户。
$ sudo calibre-server --manage-users
你会看到四个选项并被要求做出选择。按 1 添加一个新用户,并提供用户名和密码以完成新用户的添加。
1) Add a new user
2) Edit an existing user
3) Remove a user
4) Cancel
What do you want to do? [1-4]: (Press 1)
Enter the username: howtoforge
Enter the new password for howtoforge:
Re-enter the new password for howtoforge, to verify:
User howtoforge added successfully!
接下来,你需要编辑 service 文件以启用认证检查。打开该文件进行编辑。
$ sudo nano /etc/systemd/system/calibre-server.service
在以 ExecStart 开头的行末尾添加 --enable-auth 标志以启用用户认证。
...
ExecStart=/opt/calibre/calibre-server "/home/<username>/calibre-library" --userdb "/home/<username>/.config/calibre/server-users.sqlite" --enable-local-write --enable-auth
...
按 Ctrl+W 并在提示时输入 Y 来保存并关闭文件。
重新加载服务守护进程并启动该服务。
$ sudo systemctl daemon-reload
$ sudo systemctl start calibre-server
如果你打开书库 URL,在允许你访问之前会提示输入你的用户名和密码。输入你的凭证并按 Sign in 按钮以访问书库。

第 7 步 - 自动向书库添加书籍
Calibre 允许你使用 Cron 作业自动向书库添加书籍。它通过每隔固定时间监视一个目录中的新书籍,然后将它们添加到书库来实现。这是添加书籍最快的方式,你只需将它们上传到该目录,它们很快就会出现在书库中,无需任何人工干预。
第一步是创建一个监视目录。
$ mkdir ~/calibre-watch
$ cd ~/calibre-watch
从 Project Gutenberg 将 Leo Tolstoy 所著的 War and Peace 一书下载到该目录。
$ wget https://www.gutenberg.org/ebooks/2600.kindle.images -O warandpeace.mobi
如果你留意的话,这次我们下载的是带图片的版本。在 Project Gutenberg 上,这因书而异。有些提供带图片的版本,有些则没有。Calibre 对这两种格式都能很好地处理。
打开 Crontab 编辑器。
$ crontab -e
如果这是你第一次使用 Crontab,系统会要求你选择一个编辑器。
no crontab for <username> - using an empty one
Select an editor. To change later, run 'select-editor'.
1. /bin/nano <---- easiest
2. /usr/bin/vim.basic
3. /usr/bin/vim.tiny
4. /bin/ed
Choose 1-4 [1]:
输入 1 选择 Nano 编辑器,因为它是最容易操作的。
在文件底部添加以下命令。
*/5 * * * * calibredb add /home/<username>/calibre-watch/ -r --with-library http://localhost:8080#calibre-library --username mycalibreuser --password StrongPassword! && rm -r /home/<username>/calibre-watch/*
该脚本会将 /home/
按 Ctrl+W 并在提示时输入 Y 来保存并关闭文件。等待几分钟,然后重新加载 calibre server 站点,即可看到你刚添加的书籍出现在书库中。
第 8 步 - 安装 Nginx
Ubuntu 22.04 自带较旧版本的 Nginx。要安装最新版本,你需要下载官方的 Nginx 仓库。
导入 Nginx 的签名密钥。
$ curl https://nginx.org/keys/nginx_signing.key | gpg --dearmor \
| sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
添加 Nginx 稳定版的仓库。
$ echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg arch=amd64] \
http://nginx.org/packages/ubuntu `lsb_release -cs` nginx" \
| sudo tee /etc/apt/sources.list.d/nginx.list
更新系统仓库。
$ sudo apt update
安装 Nginx。
$ sudo apt install nginx
验证安装。
$ nginx -v
nginx version: nginx/1.22.0
第 9 步 - 安装 SSL
目前,Calibre 通过 IP 地址暴露在一个 HTTP 端口上。为了更好地保护它,我们将使用 SSL 证书启用通过专用域名的访问。
我们需要安装 Certbot 来为 Calibre 生成 SSL 证书。你既可以使用 Ubuntu 的仓库安装 Certbot,也可以使用 Snapd 工具获取最新版本。我们将使用 Snapd 版本。
Ubuntu 22.04 默认安装了 Snapd。运行以下命令以确保你的 Snapd 版本是最新的。
$ sudo snap install core
安装 Certbot。
$ sudo snap install --classic certbot
使用以下命令,通过创建指向 /usr/bin 目录的符号链接来确保可以运行 Certbot 命令。
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot
运行以下命令以生成 SSL 证书。
$ sudo certbot certonly --standalone --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m
[email protected]
-d calibre.example.com
上述命令会将证书下载到服务器上的 /etc/letsencrypt/live/calibre.example.com 目录。
生成一个 Diffie-Hellman 组证书。
$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096
打开文件 /etc/letsencrypt/renewal/calibre.example.com.conf 进行编辑。
$ sudo nano /etc/letsencrypt/renewal/calibre.example.com.conf
在底部粘贴以下代码。
pre_hook = systemctl stop nginx
post_hook = systemctl start nginx
按 Ctrl + X 并在提示时输入 Y 来保存文件。
我们使用 Certbot 的 standalone 选项生成了 SSL 证书。它会运行自己的 Web 服务器来创建证书,这意味着在续期期间应关闭 Nginx。pre_hook 和 post_hook 命令分别在续期之前和之后运行,以自动关闭并重启 Nginx 服务器,从而无需任何人工干预。
要检查 SSL 续期是否正常工作,请对该过程进行一次 dry run。
$ sudo certbot renew --dry-run
如果没有看到任何错误,就一切就绪了。你的证书将自动续期。
第 10 步 - 配置 Nginx
打开文件 /etc/nginx/nginx.conf 进行编辑。
$ sudo nano /etc/nginx/nginx.conf
在 include /etc/nginx/conf.d/*.conf; 这一行之前添加以下行。
server_names_hash_bucket_size 64;
按 Ctrl + X 并在提示时输入 Y 来保存文件。
创建并打开文件 /etc/nginx/conf.d/calibre.conf 进行编辑。
$ sudo nano /etc/nginx/conf.d/calibre.conf
将以下代码粘贴到其中。将 calibre.example.com 替换为你的域名。我们已将 client_max_body_size 变量的值设置为 50MB。你可以根据需要更改它。
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
http2_push_preload on; # Enable HTTP/2 Server Push
# Enable TLSv1.3's 0-RTT. Use $ssl_early_data when reverse proxying to
# prevent replay attacks.
#
# @see: https://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_early_data
ssl_early_data on;
server_name calibre.example.com;
client_max_body_size 50M;
access_log /var/log/nginx/calibre.access.log;
error_log /var/log/nginx/calibre.error.log;
ssl_certificate /etc/letsencrypt/live/calibre.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/calibre.example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/calibre.example.com/chain.pem;
ssl_session_timeout 5m;
ssl_session_cache shared:MozSSL:10m;
ssl_session_tickets off;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers on;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_ecdh_curve X25519:prime256v1:secp384r1:secp521r1;
ssl_stapling on;
ssl_stapling_verify on;
ssl_dhparam /etc/ssl/certs/dhparam.pem;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
# enforce HTTPS
server {
listen 80;
listen [::]:80;
server_name calibre.example.com;
return 301 https://$host$request_uri;
}
按 Ctrl + X 并在提示时输入 Y 来保存文件。
验证你的 Nginx 配置。
$ sudo nginx -t
重启 Nginx 服务器以启用配置文件。
$ sudo systemctl restart nginx
在浏览器中访问 https://calibre.example.com 以访问 Calibre。你可以看到通过 Cron 添加的书籍也已在书库中可用。

结论
本教程到此结束,我们介绍了如何使用 Nginx 在 Ubuntu 22.04 机器上安装 Calibre Server。我们还配置了 Calibre 以启用基本认证,并增加了自动添加新书籍的支持。Calibre Server 附带了许多命令行工具。要了解更多相关信息,你可以访问 Calibre Documentation。如果你有任何问题,请在下方评论中提出。