Arch manual pages

CALIBRE-SERVER(1) calibre CALIBRE-SERVER(1)

calibre-server - calibre-server

calibre-server [options] [path to library folder...]


Запустить контент-сервер calibre. Контент-сервер calibre
предоставляет доступ к вашим библиотекам через Интернет.
Вы можете указать путь к папкам библиотеки в качестве аргументов
для % prog. Если вы не укажете какие-либо пути, будут использоваться все библиотеки, о которых знает основная программа calibre.

Всякий раз, когда вы передаете аргументы calibre-server, в которых есть пробелы, заключите аргументы в кавычки. Например: "/some path/with spaces"

--access-log
Путь к файлу логов доступа. Этот лог содержит информацию, о клиентах, подключающихся к серверу и делающих запросы. По умолчанию лог доступа не ведётся.

--ajax-timeout
Время (в секундах), ожидания ответа от сервера при выполнении запросов.

--auth-mode
Выбрать тип используемой авторизации. Установка режима авторизации HTTP для сервера. Установите "простой", если вы держите этот сервер за SSL-прокси. Иначе, оставьте "автоматический", который будет использовать "простой", если SSL сконфигуировано, иначе будет использовать "digest".

--auto-reload
Автоматическая перезагрузка сервера при изменении исходного кода. Полезно в разработке. Вам также следует указать малое значение таймаута выключения.

--ban-after
Количество неудачных попыток входа в систему. Количество неудачных входов, после которого IP-адрес запрещается

--ban-for
Запретить IP-адреса с повторными ошибками входа. Временно запрещает доступ для IP-адресов с повторными ошибками входа в течение указанного количества минут. Полезно для предотвращения попыток подбора паролей. Если установлено в ноль, запрет не выполняется.

--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 для внесения изменений. Небезопасно запускать сервер без проверки подлинности, с использованием calibredb для внесения изменений в ваши библиотеки. Обратите внимание, что включение этой опции означает, что ЛЮБАЯ программа, запущенная на компьютере, может вносить изменения в ваши библиотеки. По умолчанию эта опция отключена.

--enable-log-not-found, --disable-log-not-found
Логировать HTTP 404 (Not Found) запросы. Обычно сервер регистрирует все HTTP-запросы для ресурсов, которые не найдены.Это может привести к большому количеству спама в журнале, если на ваш сервер нацелились боты. Используйте этот параметр, чтобы отключить логирование. По умолчанию эта опция включена.

--enable-use-bonjour, --disable-use-bonjour
Объявлять фиды OPDS через BonJour. Объявлять фиды OPDS через сервис BonJour, чтобы приложения, оперирующие с OPDS могли их определить и подключиться к серверу автоматически. По умолчанию эта опция включена.

--enable-use-sendfile, --disable-use-sendfile
Zero-copy передача файлов для увеличения производительности. Включение zero-copy для передач внутри ядра при отправке файлов по сети с целью увеличения производительности. Однако, это может привести к возникновению ошибок при передаче файлов в неверные файловые системы. Если вы столкнулись с повреждением файлов при передаче, отключите эту опцию. По умолчанию эта опция включена.

--help, -h
показать это сообщение и выйти

--ignored-fields
Игнорировать определённые пользователем поля метаданных. Список разделенных запятой пользовательских полей метаданных, не отображаемые контент-сервером в представлениях /opds и /mobile. Например: my_rating,my_tags

--listen-on
Интерфейс для прослушивания входящих соединений. По умолчанию - слушать на всех доступных интерфейсах. Вы можете изменить это, например, на "127.0.0.1", чтобы ожидать соединения только от локальной машины, или на "::", чтобы слушать все входящие соединения IPv6 и IPv4.

--log
Путь к файлу лога сервера. Этот лог содержит информацию сервера и ошибки, не ошибки доступа. По умолчанию пишется в stdout.

--manage-users
Управлять пользователями базы данных, которым разрешено подключаться к этому серверу. Смотрите так же параметр --userdb.

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

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

--max-jobs
Максимальное количество рабочих процессов. Рабочие процессы запускаются по мере необходимости для больших заданий, таких как подготовка книги для просмотра, добавление книг, конвертирование и т.п. Обычно макс. количество таких процессов зависит от количества ядер ЦП. Вы можете управлять этим параметром.

--max-log-size
Максимальный размер файла журнала (в МБ). Максимальный размер файлов журнала /лог-файлов/, создаваемых сервером. Как только размер лог-файла превышает заданный, содержимое файла автоматически ротируется. Установка в 0 отключает ротацию.

--max-opds-items
Максимальное число книг в фиде OPDS. Максимальное число книг, которое сервер вернёт в одном принимающем фиде OPDS.

--max-opds-ungrouped-items
Максимальное число несгрупированных элементов в фидах OPDS. Группировать элементы по категориям, таким как автор/теги по первой букве, когда элементов больше, чем это число. Установите в 0 для отключения.

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

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

--pidfile
Записать PID процесса в указанный файл

--port
Порт для входящих соединений.

--search-the-net-urls
Путь к файлу JSON, содержащему URL-адреса для функции Поиск в Интернет. Самый простой способ создать такой файл - перейти в Настройки -> Обмен через сеть -> Поиск в Интернет, создать URL-адреса и экспортировать их.

--shutdown-timeout
Общее время ожидания "чистого" отключения, в секундах .

--ssl-certfile
Путь к файлу сертификата SSL.

--ssl-keyfile
Путь к файлу секретного ключа SSL.

--timeout
Время (в секундах) до отключения холостого соединения.

--url-prefix
Префикс, добавляемый ко всем URL-ам. Полезно, если вы хотите запустить этот сервер за обратным прокси. Например, используйте /calibre в качестве префикса URL.

--userdb
Путь к пользовательской базе данных, используемой для аутентификации. База данных представляет собой SQLite-файл. Для его создания используйте --manage-users. Вы можете узнать больше об управлении пользователями по адресу: https://manual.calibre-ebook.com/server.html#managing-user-accounts-from-the-command-line-only

--version
показать версию программы и выйти

--worker-count
Количество рабочих потоков для обработки запросов.

Kovid Goyal

Kovid Goyal
ноября 08, 2019 4.3.0