CALIBRE-SERVER(1)

NAME
calibre-server - calibre-server

            calibre-server [параметри] [шлях до теки бібліотеки...]

Запустити сервер обробки даних calibre. Сервер обробки даних calibre надаватиме змогу працювати із бібліотеками calibre з інтернету. Ви можете передати шлях до тек бібліотеки у аргументах команди calibre-server. Якщо вами не буде вказано шляхів, буде використано усі бібліотеки, про які відомо основній програмі calibre.

Якщо ви передаєте аргументи calibre-server, які містять пробіли, додайте навколо таких аргументів лапки. Приклад: «/some path/with spaces»

[ПАРАМЕТРИ]

    --access-log
        Шлях до файла журналу доступу. У цьому журналі містяться дані щодо клієнтів, які встановлювали з’єднання із сервером, та виконаних запитів. Типово, запис до цього журналу не виконується.

    --ajax-timeout
        Час очікування на відповідь сервера у секундах.

    --auth-mode
        Виберіть тип розпізнавання. Встановити режим розпізнавання HTTP, який використовуватиметься на сервері. Встановіть значення «basic», якщо сервер перебуває за проксі з SSL. Якщо це не так, лишіть значення «auto», за якого використовуватиметься «basic», якщо налаштовано SSL, і «digest», якщо його не налаштовано.

    --auto-reload
        Автоматично перезавантажувати сервер, якщо змінюється початковий код. Корисно для розробників. Вам також слід вказати невеличке значення для часу очікування на завершення роботи перед перезавантаженням.

    --ban-after
        Кількість невдалих спроб для блокування. Кількість невдалих спроб увійти, після виконання яких IP-адресу буде заблоковано

    --ban-for
        Заблокувати IP-адреси, за якими не вдається увійти. Тимчасово заблокувати доступ для IP-адрес, за якими не вдається повторно увійти протягом вказаної кількості хвилин. Корисно для запобігання спробам підібрати пароль. Якщо встановлено значення 0, блокування не виконуватиметься.

    --book-list-mode
        Виберіть типовий режим списку книг. Встановіть типовий режим списку книг, який буде використано для нових користувачів. Окремі користувачі можуть перевизначати цей типовий режим у власних параметрах роботи програми. Типовим є режим таблиці обкладинок.

    --compress-min-size
        Мінімальний розмір для використання стискання даних у відповідях (у байтах).

    --custom-list-template
        Шлях до файла JSON, у якому містяться дані шаблона для режиму нетипового списку книг. Найпростішим способом створення такого файла шаблона є використання пункту «Налаштування -> Обмін мережею -> Шаблон списку книг» у calibre, створення шаблона та його експортування.

    --daemonize
        Запустити процес у тлі як фонову службу (лише Linux).

    --displayed-fields
        Обмежити перелік показаних полів, які визначено користувачем. Список відокремлених комами визначених користувачем полів метаданих, які буде показано сервером вмісту у переглядах /opds та /mobile. Якщо ви вкажете цей параметр, усі поля поза цим списком не буде показано. Приклад: my_rating,my_tags

    --enable-allow-socket-preallocation, --disable-allow-socket-preallocation
        Попереднє резервування сокетів, наприклад для активації сокетів у systemd. Типово, цей параметр увімкнено.

    --enable-auth, --disable-auth
        Розпізнавання за допомогою пароля для доступу до сервера. Зазвичай, доступ до сервера не обмежено: отримати його може будь-хто. За допомогою цього параметра ви можете обмежити доступ переліком попередньо визначних користувачів. Типово, цей параметр вимкнено.

    --enable-fallback-to-detected-interface, --disable-fallback-to-detected-interface
        Повернення на автовизначений інтерфейс. Якщо з якоїсь причини сервер не зможе прив’язатися до інтерфейсу, вказаного за допомогою параметра listen_on, він спробує визначити інтерфейс, за допомогою якого комп’ютер з’єднується з іншими комп’ютерами, і прив’язатися до нього. Типово, цей параметр увімкнено.

    --enable-local-write, --disable-local-write
        Дозволити локальні з’єднання для внесення змін без розпізнавання. Зазвичай, якщо розпізнавання не увімкнено, сервер працюватиму у режимі лише читання, так, щоб забороняти анонімним користувачам вносити зміни до ваших бібліотек calibre. За допомогою цього пункту можна дозволити вносити зміни будь-кому, хто встановлює з’єднання з того комп’ютера, на якому працює сервер. Це корисно, якщо ви хочете, щоб сервер працював без розпізнавання, але не хочете втрачати можливості вносити зміни до ваших бібліотек calibre за допомогою calibredb. Зауважте, що вмикання цього параметра означає, що будь-яка програму, запущена на відповідному комп’ютері, зможе вносити зміни до ваших бібліотек calibre. Типово, цей параметр вимкнено.

    --enable-log-not-found, --disable-log-not-found
        Записувати до журналу запити з HTTP 404 (Не знайдено). Зазвичай, до журналу сервера записуються усі запити HTTP для ресурсів, які не було знайдено. Це може призвести до значного розростання журналу, якщо ваш сервер атакуватимуть боти. За допомогою цього параметра можна вимкнути запис до журналу відповідних повідомлень. Типово, цей параметр увімкнено.

    --enable-use-bonjour, --disable-use-bonjour
        Оголошувати подачі OPDS за допомогою BonJour. Оголошувати про подачі OPDS за допомогою служби BonJour, щоб засновані на OPDS програми для читання могли виявляти сервер і автоматично з ним з’єднуватися. Типово, цей параметр увімкнено.

    --enable-use-sendfile, --disable-use-sendfile
        Нульові передавання файлів при копіюванні для підвищення швидкодії. За допомогою цього можна скористатися передаваннями нульового копіювання у ядрі під час надсилання файлів мережею і підвищити швидкодію. Втім, використання цього способу може призвести до пошкодження файлів у деяких файлових системах із помилками. Якщо у вас виникають проблеми із пошкодженням файлів, вимкніть цю можливість. Типово, цей параметр увімкнено.

    --help, -h
        показати це довідкове повідомлення і завершити роботу

    --ignored-fields
        Ігноровані визначені користувачем поля метаданих. Список полів метаданих, визначених користувачем, які не буде показано сервером вмісту у переглядах /opds та /mobile. Приклад: my_rating,my_tags

    --listen-on
        Інтерфейс, на якому слід очікувати на з’єднання. Типово, програма очікує на з’єднання на усіх інтерфейсах IPv6 та IPv4. Ви можете змінити цю поведінку: наприклад, визначити адресу «127.0.0.1», щоб програма очікувала на з’єднання IPv4 лише на комп’ютері, на якому запущено сервер, або вказати «0.0.0.0», щоб сервер очікував на всі вхідні з’єднання IPv4.

    --log
        Шлях до файла журналу сервера. У цьому журналі зберігаються дані і помилки сервера, а не повідомлення щодо доступу до сервера. Типово, дані журналу записуються до stdout.

    --manage-users
        Керування базою даних користувачів, які можуть встановлювати з'єднання із цим сервером. Можете користуватися автоматичним режимом, додавши до команди --. Див. calibre-server --manage-users -- help, щоб дізнатися більше. Див. також параметр --userdb.

    --max-header-line-size
        Макс. розмір одного заголовка HTTP (у кБ).

    --max-job-time
        Максимальна тривалість процесів обробки. Максимальна тривалість процесів обробки (у хвилинах). Встановіть нульове значення, якщо тривалість не слід обмежувати.

    --max-jobs
        Максимальна кількість процесів обробки. Процеси обробника запускаються за потреби і використовуються для виконання складних завдань, зокрема приготування книги до перегляду, перетворення даних у інший формат. Зазвичай, максимальна кількість процесів таких обробників визначається за кількістю ядер процесора комп’ютера. Ви можете змінити типове значення.

    --max-log-size
        Макс. розмір файла журналу (у МБ). Максимальний розмір файлів журналу, які створюватимуться сервером. Щойно розмір файла журналу перевищить вказане значення, відбудеться автоматична ротація системи файлів журналу. Встановіть нульове значення, щоб вимкнути ротацію журналу.

    --max-opds-items
        Максимальна кількість книг у подачах OPDS. Максимальна кількість книг, дані яких сервер повертатиме у одній подачі OPDS.

    --max-opds-ungrouped-items
        Максимальна кількість незгрупованих записів у подачах OPDS. Групувати записи у категоріях, зокрема іменами авторів та мітками, за першими літерами, якщо літері відповідає кількість записів, більша за вказану. Встановіть нульове значення, щоб вимкнути.

    --max-request-body-size
        Макс. дозволений розмір файлів для вивантаження на сервер (у МБ).

    --num-per-page
        Кількість книг, які може бути показано на одній сторінці. Кількість книг, які може бути показано на одній сторінці у засобі навігації.

    --pidfile
        Записати ідентифікатор процесу до вказаного файла

    --port
        Порт, на якому слід очікувати на з’єднання.

    --search-the-net-urls
        Шлях до файла JSON, у якому містяться адреси для функціональної можливості «Шукати у інтернеті». Найпростішим способом створення такого файла є перехід на сторінку «Налаштування -> Обмін мережею -> Шукати у інтернеті» у головному вікні calibre, створення адрес і їх експортування.

    --shutdown-timeout
        Загальний час очікування на коректне завершення у секундах.

    --ssl-certfile
        Шлях до файла сертифіката SSL.

    --ssl-keyfile
        Шлях до файла закритого ключа SSL.

    --timeout
        Максимальний час (у секундах) підтримання бездіяльного з’єднання перед розірванням.

    --trusted-ips
        Дозволити з’єднання із вказаних IP-адрес для внесення змін без розпізнавання. Зазвичай, якщо розпізнавання не увімкнено, сервер працюватиму у режимі лише читання, так, щоб забороняти анонімним користувачам вносити зміни до ваших бібліотек calibre. За допомогою цього пункту можна дозволити вносити зміни будь-кому, хто встановлює з’єднання з вкзаних IP-адрес. Адреси має бути вказано у форматі списку відокремлених комами адрес або специфікацій мережі. Це корисно, якщо ви хочете, щоб сервер працював без розпізнавання, але не хочете втрачати можливості вносити зміни до ваших бібліотек calibre за допомогою calibredb. Зауважте, що вмикання цього параметра означає, що будь-хто, хто з'єднується із вказаних IP-адрес, зможе вносити зміни до ваших бібліотек calibre.

    --url-prefix
        Префікс для усіх адрес. Корисно, якщо ви хочете користуватися цим сервером за реверсивним проксі. Наприклад, можна скористатися префіксом адреси «/calibre».

    --userdb
        Шлях до бази даних користувачів, якою слід скористатися для розпізнавання. Дані у базі зберігаються у файлі SQLite. Для його створення скористайтеся --manage-users. Докладніше про керування користувачами: <https://manual.calibre-ebook.com/uk/server.html#managing-user-accounts-from-the-command-line-only>

    --version
        показати дані щодо версії програми і завершити роботу

    --worker-count
        Кількість потоків обробника під час обробки запитів.

Author
Kovid Goyal

Copyright
Kovid Goyal