.. _calibre-server-ru: .. raw:: html ``calibre-server`` =================================================================== .. code-block:: none calibre-server [опции] [путь к папке библиотеки…] Запустить контент-сервер calibre. Контент-сервер показывает ваши библиотеки calibre через интернет. Вы можете указать пути к папкам библиотек в качестве аргументов для :command:`calibre-server`. Если вы не укажете какие-либо пути, будут использоваться все библиотеки, о которых знает основная программа calibre. Когда вы передаёте аргументы с пробелами в :command:`calibre-server`, заключайте их в кавычки. Например: "/some path/with spaces" [опции] ---------------------------------------- .. program:: calibre-server .. option:: --access-log Путь к файлу журнала доступа. Журнал содержит информацию о клиентах, подключающихся к серверу и делающих запросы. По умолчанию журнал доступа не ведётся. .. option:: --ajax-timeout Время (в секундах), ожидания ответа от сервера при выполнении запросов. .. option:: --auth-mode Выбрать тип используемой авторизации. Установка используемого сервером режима проверки подлинности HTTP. Выберите «basic», если размещаете этот сервер за SSL-прокси. Или оставьте «auto», который будет использовать «basic», если SSL настроен, а в противном случае — «digest». .. option:: --auto-reload Автоматическая перезагрузка сервера при изменении исходного кода. Полезно в разработке. Вам также следует указать малое значение таймаута выключения. .. option:: --ban-after Количество неудачных попыток входа в систему. Количество неудачных входов, после которого IP-адрес запрещается .. option:: --ban-for Запретить IP-адреса с повторными ошибками входа. Временно запрещает доступ для IP-адресов с повторными ошибками входа в течение указанного количества минут. Полезно для предотвращения попыток подбора паролей. Если установлено в ноль, запрет не выполняется. .. option:: --book-list-mode Выберите умолчальный режим списка книг. Режим списка книг по умолчанию, используемый для новых пользователей. Отдельные пользователи могут переопределить настройки по умолчанию в своих настройках. По умолчанию используется сетка покрытия. .. option:: --compress-min-size Мин. размер, для использования сжатия данных в ответах (в байтах). .. option:: --custom-list-template Путь к файлу JSON, содержащему шаблон для настраиваемого режима списка книг. Простейший способ создать такой файл шаблона - перейти в calibre Настройки -> Обмен через сеть -> Шаблон списка книг , создать шаблон и экспортировать его. .. option:: --daemonize Запустить процесс в фоне как демон (только Linux). .. option:: --displayed-fields Ограничить отображаемые пользовательские поля. Список разделенных пользователем полей метаданных, которые будут отображаться контент-сервером в представлениях /opds и /mobile. Если вы укажете этот параметр, любые поля, не входящие в этот список, не будут отображаться. Например: my_rating,my_tags .. option:: --enable-allow-socket-preallocation, --disable-allow-socket-preallocation Предварительное выделение сокета, например, systemd активация сокета. По умолчанию эта опция включена. .. option:: --enable-auth, --disable-auth Аутентификация на основе пароля для доступа к серверу. Как правило, сервер неограничен, что позволяет всем получить к нему доступ. Эта опция ограничит доступ предопределенными пользователями. По умолчанию эта опция отключена. .. option:: --enable-fallback-to-detected-interface, --disable-fallback-to-detected-interface Откат к автоматически определяемому интерфейсу. Если по какой-то причине сервер неспособен присоединиться к интерфейсу, заданному в настройке listen_on, он попробует определить интерфейс, который подключён к внешнему миру, и присоединиться к нему. По умолчанию эта опция включена. .. option:: --enable-local-write, --disable-local-write Разрешить не аутентифицированным локальным подключениям вносить изменения. Обычно, если вы не включаете аутентификацию, сервер работает в режиме только для чтения, чтобы анонимные пользователи не вносили изменений в ваши библиотеки. Эта опция позволяет любому пользователю подключаться к серверу calibre для внесения изменений. Небезопасно запускать сервер без проверки подлинности, с использованием calibredb для внесения изменений в ваши библиотеки. Обратите внимание, что включение этой опции означает, что ЛЮБАЯ программа, запущенная на компьютере, может вносить изменения в ваши библиотеки. По умолчанию эта опция отключена. .. option:: --enable-log-not-found, --disable-log-not-found Логировать HTTP 404 (Not Found) запросы. Обычно сервер регистрирует все HTTP-запросы для ресурсов, которые не найдены.Это может привести к большому количеству спама в журнале, если на ваш сервер нацелились боты. Используйте этот параметр, чтобы отключить логирование. По умолчанию эта опция включена. .. option:: --enable-use-bonjour, --disable-use-bonjour Объявлять фиды OPDS через BonJour. Объявлять фиды OPDS через сервис BonJour, чтобы приложения, оперирующие с OPDS могли их определить и подключиться к серверу автоматически. По умолчанию эта опция включена. .. option:: --enable-use-sendfile, --disable-use-sendfile Zero-copy передача файлов для увеличения производительности. Включение zero-copy для передач внутри ядра при отправке файлов по сети с целью увеличения производительности. Однако, это может привести к возникновению ошибок при передаче файлов в неверные файловые системы. Если вы столкнулись с повреждением файлов при передаче, отключите эту опцию. По умолчанию эта опция включена. .. option:: --help, -h показать это сообщение и выйти .. option:: --ignored-fields Игнорировать определённые пользователем поля метаданных. Список разделенных запятой пользовательских полей метаданных, не отображаемые контент-сервером в представлениях /opds и /mobile. Например: my_rating,my_tags .. option:: --listen-on Интерфейс для прослушивания входящих соединений. По умолчанию прослушивание осуществляется на всех доступных интерфейсах IPv6 и IPv4. Вы можете изменить это, например, на \ ``"``\ 127.0.0.1\ ``"``\ , чтобы прослушивать только IPv4-соединения с локальной машины, или на \ ``"``\ 0.0.0.0\ ``"``\ , чтобы прослушивать все входящие IPv4-соединения. .. option:: --log Путь к файлу журнала сервера. Журнал содержит информацию сервера и ошибки, а не журналы доступа. По умолчанию пишется в stdout. .. option:: --manage-users Управляйте базой данных пользователей, которым разрешено подключаться к этому серверу. Возможно использование в автоматическом режиме добавив --. Подробнее см. calibre-server :option:`--manage-users` ``--`` help. См. также параметр :option:`--userdb`. .. option:: --max-header-line-size Макс. размер одного заголовка HTTP (в КБ). .. option:: --max-job-time Макс. время жизни рабочих процессов. Максимально допустимое время жизни запущенного рабочего процесса (в минутах). Установите в ноль для снятия ограничения по времени. .. option:: --max-jobs Максимальное количество рабочих процессов. Рабочие процессы запускаются по мере необходимости для больших заданий, таких как подготовка книги для просмотра, добавление книг, конвертирование и т.п. Обычно макс. количество таких процессов зависит от количества ядер ЦП. Вы можете управлять этим параметром. .. option:: --max-log-size Максимальный размер файла журнала (в МБ). Максимальный размер файлов журнала /лог-файлов/, создаваемых сервером. Как только размер лог-файла превышает заданный, содержимое файла автоматически ротируется. Установка в 0 отключает ротацию. .. option:: --max-opds-items Максимальное число книг в фиде OPDS. Максимальное число книг, которое сервер вернёт в одном принимающем фиде OPDS. .. option:: --max-opds-ungrouped-items Максимальное число несгрупированных элементов в фидах OPDS. Группировать элементы по категориям, таким как автор/теги по первой букве, когда элементов больше, чем это число. Установите в 0 для отключения. .. option:: --max-request-body-size Макс. допустимый размер файлов, загружаемых на сервер (в МБ). .. option:: --num-per-page Количество книг для показа на одной странице. Количество книг, отображаемых на одной странице в браузере. .. option:: --pidfile Записать PID процесса в указанный файл .. option:: --port Порт для входящих соединений. .. option:: --search-the-net-urls Путь к файлу JSON, содержащему URL-адреса для функции Поиск в Интернет. Самый простой способ создать такой файл - перейти в Настройки -> Обмен через сеть -> Поиск в Интернет, создать URL-адреса и экспортировать их. .. option:: --shutdown-timeout Общее время ожидания «чистого» отключения, в секундах . .. option:: --ssl-certfile Путь к файлу сертификата SSL. .. option:: --ssl-keyfile Путь к файлу секретного ключа SSL. .. option:: --timeout Время (в секундах) до отключения холостого соединения. .. option:: --trusted-ips Разрешить неаутентифицированным соединениям с определенных IP-адресов вносить изменения. Обычно, если вы не включаете аутентификацию, сервер работает в режиме только для чтения, чтобы анонимные пользователи не вносили изменений в ваши библиотеки. Эта опция позволяет любому пользователю подключаться к серверу calibre для внесения изменений. Должен быть список адресов или спецификаций сетей через запятую. Небезопасно запускать сервер без проверки подлинности, с использованием calibredb для внесения изменений в ваши библиотеки. Обратите внимание, что включение этой опции означает, что любой, кто подключается с указанных IP-адресов, может вносить изменения в ваши библиотеки. .. option:: --url-prefix Префикс, добавляемый ко всем URL-ам. Полезно, если вы хотите запустить этот сервер за обратным прокси. Например, используйте /calibre в качестве префикса URL. .. option:: --userdb Путь к пользовательской базе данных, используемой для аутентификации. База данных представляет собой SQLite-файл. Для его создания используйте :option:`--manage-users`. Вы можете узнать больше об управлении пользователями по адресу: https://manual.calibre-ebook.com/ru/server.html#managing-user-accounts-from-the-command-line-only .. option:: --version показать версию программы и выйти .. option:: --worker-count Количество рабочих потоков для обработки запросов.