本教程适用于以下操作系统版本

  • 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://:8080/,你将看到如下画面。根据你操作系统主题的选择,该画面会显示为深色或浅色。

在 Ubuntu 22.04 系统上完整安装 Calibre 电子书服务器教程

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

在 Ubuntu 22.04 系统上完整安装 Calibre 电子书服务器教程

在终端中按 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 命令添加书籍。

将上述代码中的 替换为你的 Linux 系统用户名。按 Ctrl+W 并在提示时输入 Y 来保存并关闭文件。

重新加载服务守护进程以激活该 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 按钮以访问书库。

在 Ubuntu 22.04 系统上完整安装 Calibre 电子书服务器教程

第 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//calibre-watch 目录中的所有文件添加到 calibre 书库,并删除所有原始文件,因为它们不再需要。上述作业将每 5 分钟运行一次。将 替换为你的 Linux 系统用户名,并在相应位置添加你的 Calibre 凭证。

按 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 添加的书籍也已在书库中可用。

在 Ubuntu 22.04 系统上完整安装 Calibre 电子书服务器教程

结论

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