Calibre-web на VPS: встановлення, налаштування та обслуговування

Що таке Calibre-web і навіщо він потрібен на VPS?

Для встановлення та запуску Calibre-web на VPS знадобиться віртуальний сервер з мінімум 1 vCPU, 1 GB RAM та 20 GB NVMe-диска, а також базові навички роботи з Linux та Docker, що дозволить створити персональну бібліотеку електронних книг з доступом з будь-якої точки світу. Calibre-web — це потужний веб-інтерфейс для вашої бібліотеки електронних книг Calibre, який дозволяє отримати віддалений доступ до колекції, читати книги прямо в браузері, керувати метаданими, завантажувати нові видання та ділитися ними з іншими користувачами. На відміну від настільної версії Calibre, яка чудово справляється з локальним управлінням, Calibre-web розроблений спеціально для віддаленого доступу та багатокористувацького використання, що робить його ідеальним рішенням для розміщення на VPS.

Розміщення Calibre-web на VPS вирішує низку ключових завдань. По-перше, ви отримуєте цілодобовий доступ до своєї бібліотеки з будь-якого пристрою, будь то смартфон, планшет або інший комп'ютер, без необхідності тримати домашній ПК постійно увімкненим. По-друге, calibre-web vps забезпечує централізоване зберігання вашої колекції, що спрощує резервне копіювання та синхронізацію. По-третє, це відкриває можливості для створення сімейної або навіть невеликої громадської бібліотеки з індивідуальними обліковими записами для кожного користувача, де кожен може читати, завантажувати та керувати доступом до книг. Ви контролюєте свої дані, не покладаючись на сторонні хмарні сервіси, що критично важливо для конфіденційності та незалежності.

Використання VPS для calibre-web self-hosted рішення також надає гнучкість у масштабуванні ресурсів. У міру зростання вашої бібліотеки або збільшення кількості користувачів ви можете легко оновити тарифний план VPS, додавши більше оперативної пам'яті, процесорних ядер або дискового простору. Це набагато ефективніше та економніше, ніж постійно оновлювати домашнє обладнання або платити за дорогі хмарні сховища з обмеженими функціями. Саме тому встановлення Calibre-web на власний сервер стає вибором для тих, хто цінує контроль, доступність та масштабованість.

Системні вимоги Calibre-web: який VPS обрати?

Вибір оптимального VPS для Calibre-web залежить від розміру вашої бібліотеки та очікуваної кількості одночасних користувачів. Для більшості особистих та невеликих сімейних бібліотек (< до 10 000 книг, 1-3 користувачі) вимоги до ресурсів будуть мінімальними. Однак, якщо ви плануєте створити велику бібліотеку або надати доступ більшій кількості людей, варто розглянути більш потужні конфігурації.

Мінімальні вимоги для персонального використання Calibre-web

Для запуску Calibre-web у режимі особистої бібліотеки з кількома сотнями або тисячами книг та одним-двома активними користувачами, базового VPS буде цілком достатньо. Важливо, щоб VPS підтримував Docker, оскільки це найбільш рекомендований метод встановлення calibre-web.

Процесор (CPU): 1 vCPU (віртуальне ядро) з тактовою частотою від 2.0 GHz. Calibre-web не є сильно ресурсоємним додатком для ЦПУ в режимі очікування.
Оперативна пам'ять (RAM): 1 GB. Цього обсягу буде достатньо для роботи Calibre-web, Docker-контейнера та базової операційної системи Linux.
Дисковий простір: 20-30 GB NVMe SSD. NVMe-диски значно прискорюють операції введення-виведення, що критично для швидкого завантаження сторінок та пошуку по бібліотеці. 20 GB вистачить для ОС та кількох тисяч книг (в середньому, електронна книга займає 1-5 MB).
Операційна система: Ubuntu Server 20.04 LTS або 22.04 LTS, Debian 11/12, CentOS Stream 8/9.
Мережа: Стабільний канал 100 Mbps або 1 Gbps.

Такий VPS зазвичай коштує від $5 до $10 на місяць у більшості провайдерів, включаючи Valebyte.com. Зверніть увагу на тип віртуалізації: KVM VPS зазвичай пропонує кращу продуктивність та ізоляцію ресурсів порівняно з OpenVZ. Детальніше про відмінності можна дізнатися в нашій статті: KVM VPS vs OpenVZ VPS у 2026: все ще актуально.

Параметр	Персональне використання (до 5000 книг, 1-2 користувачі)	Сімейне/мале співтовариство (до 20000 книг, 3-10 користувачів)	Велике співтовариство/розширене використання (понад 20000 книг, 10+ користувачів)
CPU	1 vCPU (2.0+ GHz)	2 vCPU (2.5+ GHz)	4 vCPU (3.0+ GHz)
RAM	1 GB	2-4 GB	8+ GB
Диск	20-30 GB NVMe SSD	50-100 GB NVMe SSD	200+ GB NVMe SSD
ОС	Ubuntu 20.04/22.04 LTS	Ubuntu 22.04 LTS	Ubuntu 22.04 LTS
Мережа	100 Mbps	1 Gbps	1 Gbps
Орієнтовна вартість/міс.	$5 - $10	$15 - $30	$40+

Підготовка VPS для встановлення Calibre-web

Перед тим як приступити до встановлення calibre-web, необхідно підготувати ваш VPS. Цей процес включає оновлення системи, встановлення Docker та Docker Compose, а також базове налаштування безпеки. Ми будемо використовувати Ubuntu Server 22.04 LTS як найбільш популярну та добре документовану ОС для серверів.

Підключення до VPS та оновлення системи

Спершу підключіться до вашого VPS по SSH. Якщо ви використовуєте Windows, можете скористатися PuTTY або вбудованим OpenSSH клієнтом. Для Linux/macOS достатньо команди ssh.

ssh root@ВАША_IP_АДРЕСА

Після підключення оновіть усі пакети системи до останніх версій:

sudo apt update
sudo apt upgrade -y
sudo apt autoremove -y

Перезавантажте сервер, якщо це було рекомендовано після оновлення ядра або критичних компонентів:

sudo reboot

Після перезавантаження перепідключіться по SSH.

Встановлення Docker та Docker Compose

Calibre-web чудово працює в контейнері Docker, що забезпечує ізоляцію, простоту розгортання та управління. Для встановлення Docker та Docker Compose скористайтеся офіційним скриптом або встановіть їх через менеджер пакетів.

Рекомендується використовувати офіційний скрипт для Docker Engine:

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

Додайте поточного користувача (або користувача, якого ви будете використовувати для управління Docker) до групи docker, щоб не використовувати sudo щоразу:

sudo usermod -aG docker $USER
newgrp docker

Перевірте, що Docker встановлено коректно:

docker run hello-world

Тепер встановимо Docker Compose. Починаючи з Docker Engine 1.28.0, Docker Compose V2 постачається як плагін Docker CLI, тому його встановлення часто зводиться до:

sudo apt install docker-compose-plugin

Якщо це не спрацює або ви хочете встановити старішу версію Compose (V1), використовуйте:

sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose # Для сумісності

Перевірте версію Docker Compose:

docker compose version

З цього моменту ваш VPS готовий до розгортання Calibre-web. Використання контейнерів, таких як Docker, для розгортання додатків на VPS має безліч переваг, про які ми детально розповідали у статті Контейнери vs ВМ vs Bare-metal: хостинг-картина 2026.

rocket_launch Швидкий вибір

Шукаєте сервер, який просто працює?

Valebyte VPS — NVMe, підтримка 24/7, розгортання за 60 секунд.

Переглянути тарифи VPS arrow_forward

Покрокове встановлення Calibre-web на VPS з Docker Compose

Найбільш ефективний та рекомендований спосіб встановлення calibre-web на сервері — це використання Docker Compose. Він дозволяє визначити всі сервіси, мережі та томи в одному файлі, що спрощує розгортання та управління.

Створення структури каталогів та файлу Docker Compose

Створіть каталог для Calibre-web та підкаталоги для даних бібліотеки та конфігурації:

mkdir -p ~/calibre-web/{library,config}
cd ~/calibre-web

Створіть файл docker-compose.yml:

nano docker-compose.yml

Вставте наступний вміст. Цей файл визначає сервіс Calibre-web, монтує необхідні томи та встановлює базові змінні оточення.

version: '3.8'

services:
  calibre-web:
    image: lscr.io/linuxserver/calibre-web:latest
    container_name: calibre-web
    environment:
      - PUID=1000 # ID користувача, під яким працюватиме Calibre-web
      - PGID=1000 # ID групи користувача
      - TZ=Europe/Moscow # Ваша часова зона
      - DOCKER_MODS=1 # Увімкнення додаткових модифікацій (наприклад, для OPDS)
      - OAUTHLIB_INSECURE_TRANSPORT=1 # Тільки якщо не використовуєте HTTPS (не рекомендується для продакшену)
    volumes:
      - ./config:/config # Каталог для конфігурації Calibre-web
      - ./library:/books # Каталог для вашої бібліотеки Calibre
    ports:
      - 8083:8083 # Порт, на якому буде доступний Calibre-web
    restart: unless-stopped

Важливі примітки щодо конфігурації:

PUID та PGID: Це ID користувача та групи на вашому хост-сервері, під якими створюватимуться файли та папки всередині контейнера. Щоб дізнатися свої ID, виконайте команди id -u та id -g. Зазвичай для першого створеного користувача це 1000.
TZ: Вкажіть вашу часову зону. Список доступних зон можна знайти тут.
./config:/config: Локальний каталог ~/calibre-web/config монтуватиметься в /config всередині контейнера. Тут Calibre-web зберігатиме свою базу даних (app.db), налаштування та інші файли.
./library:/books: Локальний каталог ~/calibre-web/library монтуватиметься в /books всередині контейнера. Сюди ви маєте скопіювати вашу існуючу бібліотеку Calibre (папку, що містить metadata.db). Якщо у вас немає бібліотеки, Calibre-web створить нову.
ports: - 8083:8083: Контейнер Calibre-web слухає на порту 8083. Ми прокидаємо його на той самий порт на хост-машині. Якщо цей порт зайнятий, ви можете змінити першу частину (наприклад, 8084:8083).

Запуск Calibre-web Docker-контейнера

Збережіть файл docker-compose.yml (Ctrl+X, Y, Enter) та запустіть контейнер:

docker compose up -d

Команда -d запускає контейнер у фоновому режимі (detached mode). Docker завантажить образ lscr.io/linuxserver/calibre-web:latest, якщо його немає локально, та запустить сервіс.

Перевірити статус контейнера можна командою:

docker compose ps

Ви побачите статус Up, якщо все пройшло успішно.

Налаштування Calibre-web через веб-інтерфейс

Тепер Calibre-web має бути доступний за IP-адресою вашого VPS та вказаним портом. Відкрийте браузер і перейдіть за адресою: http://ВАША_IP_АДРЕСА:8083.

При першому запуску вас зустріне сторінка налаштування. Вам потрібно вказати шлях до вашої бібліотеки Calibre:

У полі "Path to Calibre database" введіть /books. Це шлях всередині Docker-контейнера, куди ми змонтували локальну папку ~/calibre-web/library.
Натисніть "Submit".

Якщо у вас вже є бібліотека Calibre, скопіюйте її в ~/calibre-web/library на вашому VPS. Наприклад, якщо ваша бібліотека називається "Calibre Library" і знаходиться на локальному комп'ютері, ви можете скопіювати її за допомогою scp:

scp -r "/path/to/your/Calibre Library" root@ВАША_IP_АДРЕСА:~/calibre-web/library/

Після успішного вказання шляху до бібліотеки Calibre-web перезавантажиться та запропонує створити обліковий запис адміністратора. Задайте ім'я користувача та пароль. За замовчуванням логін та пароль для першого входу: admin / admin123. Одразу після входу рекомендується змінити їх.

Тепер ваша бібліотека доступна через веб-інтерфейс, але поки що тільки за IP-адресою та без HTTPS. Наступний крок — налаштування зворотного проксі та безпечного доступу.

Налаштування зворотного проксі та HTTPS для Calibre-web

Прямий доступ до Calibre-web за IP-адресою та портом 8083 не є безпечним або зручним. Для забезпечення безпечного доступу за доменним ім'ям з використанням HTTPS необхідний зворотний проксі. Ми розглянемо налаштування за допомогою Nginx та Caddy — двох популярних та надійних веб-серверів.

Перш ніж почати, переконайтеся, що у вас є доменне ім'я, яке вказує на IP-адресу вашого VPS (наприклад, books.вашдомен.com).

Варіант 1: Налаштування Nginx з Let's Encrypt (Certbot)

Nginx — це потужний та широко використовуваний зворотний проксі та веб-сервер. Для автоматичного отримання та оновлення SSL-сертифікатів від Let's Encrypt ми будемо використовувати Certbot.

Встановлення Nginx та Certbot

sudo apt install nginx certbot python3-certbot-nginx -y

Налаштування Nginx для Calibre-web

Створіть новий файл конфігурації Nginx для вашого домену:

sudo nano /etc/nginx/sites-available/calibre-web.conf

Вставте наступну конфігурацію, замінивши books.вашдомен.com на ваше доменне ім'я:

server {
    listen 80;
    listen [::]:80;
    server_name books.вашдомен.com;

    location / {
        proxy_pass http://127.0.0.1:8083;
        proxy_set_header Host $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;
        proxy_buffering off;
        proxy_request_buffering off;
    }
}

Створіть символічне посилання на цей файл у sites-enabled, щоб Nginx почав його використовувати:

sudo ln -s /etc/nginx/sites-available/calibre-web.conf /etc/nginx/sites-enabled/

Перевірте синтаксис конфігурації Nginx та перезавантажте його:

sudo nginx -t
sudo systemctl reload nginx

Отримання SSL-сертифіката з Certbot

Тепер використовуйте Certbot для автоматичного отримання та налаштування SSL-сертифіката:

sudo certbot --nginx -d books.вашдомен.com

Дотримуйтесь інструкцій Certbot. Він автоматично виявить вашу конфігурацію Nginx, отримає сертифікат та налаштує Nginx для використання HTTPS, включаючи перенаправлення з HTTP на HTTPS. Після цього ваш файл конфігурації Nginx буде оновлено приблизно до наступного вигляду:

server {
    listen 80;
    listen [::]:80;
    server_name books.вашдомен.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name books.вашдомен.com;

    ssl_certificate /etc/letsencrypt/live/books.вашдомен.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/books.вашдомен.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    location / {
        proxy_pass http://127.0.0.1:8083;
        proxy_set_header Host $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;
        proxy_buffering off;
        proxy_request_buffering off;
    }
}

Тепер Calibre-web доступний за адресою https://books.вашдомен.com.

Варіант 2: Налаштування Caddy з автоматичним HTTPS

Caddy — це сучасний веб-сервер, який славиться своєю простотою налаштування, особливо в частині автоматичного отримання та оновлення SSL-сертифікатів (завдяки вбудованій інтеграції з Let's Encrypt).

Встановлення Caddy

Встановіть Caddy, дотримуючись офіційної документації. Для Ubuntu це зазвичай виглядає так:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

Налаштування Caddyfile для Calibre-web

Створіть або відредагуйте файл /etc/caddy/Caddyfile:

sudo nano /etc/caddy/Caddyfile

Видаліть усі існуючі записи та вставте наступну конфігурацію, замінивши books.вашдомен.com на ваше доменне ім'я:

books.вашдомен.com {
    reverse_proxy 127.0.0.1:8083 {
        header_up Host {host}
        header_up X-Real-IP {remote_ip}
        header_up X-Forwarded-For {remote_ip}
        header_up X-Forwarded-Proto {scheme}
    }
}

Caddy автоматично отримає SSL-сертифікат для books.вашдомен.com та налаштує HTTPS. Перевірте конфігурацію та перезапустіть Caddy:

sudo caddy validate
sudo systemctl reload caddy

Тепер Calibre-web також доступний за адресою https://books.вашдомен.com.

Обидва варіанти забезпечують безпечний доступ до вашої бібліотеки. Вибір між Nginx та Caddy часто зводиться до особистих уподобань та вже наявного досвіду.

Обслуговування Calibre-web: резервні копії, оновлення та моніторинг

Підтримка calibre-web на сервері вимагає регулярного обслуговування, що включає резервне копіювання даних, своєчасні оновлення та моніторинг стану. Це гарантує збереження вашої бібліотеки та стабільну роботу сервісу.

Резервне копіювання (бекапи) Calibre-web

Ваша бібліотека електронних книг та конфігурація Calibre-web — це цінні дані, які необхідно регулярно бекапувати. Використовуючи Docker Compose, ми монтуємо постійні томи, що спрощує цей процес.

Основні дані для бекапу:

~/calibre-web/library/: Це вся ваша бібліотека Calibre, включаючи файли книг та базу даних metadata.db. Це найважливіше.
~/calibre-web/config/: Тут зберігаються конфігураційні файли Calibre-web, база даних користувачів (app.db) та інші налаштування.

Найпростіший спосіб бекапу — це створити стиснутий архів цих папок:

# Спершу зупиніть Calibre-web, щоб уникнути пошкодження бази даних під час бекапу
docker compose down

# Створіть архів
tar -czvf ~/calibre-web_backup_$(date +%F).tar.gz ~/calibre-web/library ~/calibre-web/config

# Знову запустіть Calibre-web
docker compose up -d

Рекомендується зберігати резервні копії не тільки на тому ж VPS, але й на віддаленому сховищі (наприклад, S3-сумісному хмарному сховищі, Google Drive, Dropbox, або іншому VPS). Для автоматизації можна використовувати cron та утиліти на кшталт rclone або rsync.

Приклад скрипта для щоденного бекапу та перенесення на віддалений сервер (з використанням rsync):

#!/bin/bash

BACKUP_DIR="/var/backups/calibre-web"
REMOTE_USER="backup_user"
REMOTE_HOST="your_remote_backup_server.com"
REMOTE_PATH="/path/to/remote/backups"

mkdir -p $BACKUP_DIR
cd ~/calibre-web

# Зупиняємо Calibre-web
docker compose down

# Створюємо тимчасовий архів
TIMESTAMP=$(date +%Y%m%d%H%M%S)
tar -czf $BACKUP_DIR/calibre-web-$TIMESTAMP.tar.gz ./library ./config

# Запускаємо Calibre-web
docker compose up -d

# Видаляємо старі бекапи (наприклад, старші за 7 днів)
find $BACKUP_DIR -type f -name "calibre-web-*.tar.gz" -mtime +7 -delete

# Копіюємо бекап на віддалений сервер
rsync -avz $BACKUP_DIR/calibre-web-$TIMESTAMP.tar.gz $REMOTE_USER@$REMOTE_HOST:$REMOTE_PATH/

echo "Calibre-web backup completed at $TIMESTAMP"

Збережіть цей скрипт як ~/backup_calibre_web.sh, зробіть його виконуваним (chmod +x ~/backup_calibre_web.sh) та додайте до cron для щоденного виконання (наприклад, sudo crontab -e та додайте рядок 0 3 * * * /home/youruser/backup_calibre_web.sh > /dev/null 2>&1 для запуску о 3:00 ранку).

Оновлення Calibre-web та Docker-образу

Оновлення важливі для отримання нових функцій, виправлень помилок та патчів безпеки. Завдяки Docker Compose, процес оновлення calibre-web docker дуже простий.

Щоб оновити Calibre-web до останньої версії:

Перейдіть до каталогу з вашим файлом docker-compose.yml:
```
cd ~/calibre-web
```
Завантажте останні версії образів Docker та видаліть старі контейнери, а потім створіть нові:
```
docker compose pull
docker compose up -d
```
Команда pull завантажить новий образ, а up -d перестворить контейнер, використовуючи новий образ, зберігаючи при цьому всі ваші дані завдяки змонтованим томам.

Рекомендується виконувати ці команди раз на кілька тижнів або після анонсів важливих оновлень. Перед оновленням завжди корисно зробити резервну копію.

Моніторинг продуктивності Calibre-web

Моніторинг вашого VPS допоможе виявити потенційні проблеми з продуктивністю або доступністю Calibre-web. Ви можете використовувати такі інструменти, як htop, glances, або більш просунуті рішення, наприклад, Netdata.

Завантаження CPU: Високе завантаження CPU може вказувати на активну індексацію бібліотеки або велику кількість одночасних запитів.
Використання RAM: Calibre-web зазвичай не споживає багато RAM, але якщо ваша бібліотека дуже велика, кешування може збільшити споживання.
Операції введення-виведення диска (IOPS): Активне читання/запис на диск може бути пов'язане із завантаженням книг або пошуком. NVMe SSD мінімізують цей фактор.
Мережевий трафік: Якщо користувачі активно завантажують книги, мережевий трафік зростатиме.

Регулярно перевіряйте логи Docker-контейнера Calibre-web на наявність помилок:

docker compose logs calibre-web

Це допоможе оперативно реагувати на будь-які збої або попередження.

rocket_launch Швидкий вибір

Шукаєте сервер, який просто працює?

Valebyte VPS — NVMe, підтримка 24/7, розгортання за 60 секунд.

Переглянути тарифи VPS arrow_forward

Оптимальний VPS для Calibre-web під реальне навантаження

Вибір конфігурації VPS для Calibre-web під реальне навантаження вимагає розуміння того, як ваше використання впливатиме на системні ресурси. "Реальне навантаження" може сильно варіюватися від десятків тисяч книг для сімейного використання до сотень тисяч для великої спільноти або навіть публічного доступу.

Фактори, що впливають на продуктивність Calibre-web:

Розмір бібліотеки: Чим більше книг, тим більше місця на диску потрібно і тим довше може займати індексація та пошук.
Кількість користувачів: Одночасні запити від кількох користувачів збільшують навантаження на CPU та RAM.
Тип контенту: Книги у форматі PDF або з великою кількістю зображень споживатимуть більше трафіку та вимагатимуть більше ресурсів для відображення у браузері.
Частота операцій: Якщо користувачі часто завантажують нові книги, змінюють метадані або виконують повнотекстовий пошук, навантаження буде вищим.

Висновки

Встановлення та налаштування Calibre-web на VPS з використанням Docker Compose — це надійний та масштабований спосіб створити власну хмарну бібліотеку електронних книг. Правильний вибір конфігурації VPS, грамотне налаштування зворотного проксі з HTTPS та регулярне обслуговування гарантують стабільну роботу та безпеку вашої колекції. Почніть з базового тарифу та масштабуйте ресурси в міру зростання бібліотеки та збільшення кількості користувачів, щоб отримати оптимальне співвідношення ціни та продуктивності.

Готові обрати сервер?

VPS та виділені сервери у 72+ країнах з миттєвою активацією та повним root-доступом.

Почати зараз →