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-адресов с
повторными
ошибками
входа в
течение
указанного
количества
минут.
Полезно
для
предотвращения
попыток
подбора
паролей.
Если
установлено
в ноль,
запрет не
выполняется.
- --custom-list-template
- Путь к
файлу JSON,
содержащему
шаблон для
режима
списка
пользовательских
книг.Самый
простой
способ
создать
такой файл
шаблона -
перейти в
Настройки->
Общий
доступ к
шаблону
списка->
Создать
список в calibre,
создать
шаблон и
экспортировать
его.
- --daemonize
- Запустить
процесс в
фоне как
демон
(только Linux).
- --displayed-fields
- Ограничить
отображаемые
пользовательские
поля.
Список
разделенных
пользователем
полей
метаданных,
которые
будут
отображаться
контент-сервером
в
представлениях
/opds и /mobile. Если вы
укажете
этот
параметр,
любые поля,
не
входящие в
этот
список, не
будут
отображаться.
Например:
my_rating,my_tags
- --enable-auth,
--disable-auth
- Аутентификация
на основе
пароля для
доступа к
серверу.
Как
правило,
сервер
неограничен,
что
позволяет
всем
получить к
нему
доступ. Эта
опция
ограничит
доступ
предопределенными
пользователями.
По
умолчанию
эта опция
отключена.
- --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 для
передач
внутри
ядра при
отправке
файлов по
сети с
целью
увеличения
производительности.
Однако, это
может
привести к
возникновению
ошибок при
передаче
файлов в
неверные
файловые
системы.
Если вы
столкнулись
с
повреждением
файлов при
передаче,
отключите
эту опцию.
По
умолчанию
эта опция
включена.
- --ignored-fields
- Игнорировать
определённые
пользователем
поля
метаданных.
Список
разделенных
запятой
пользовательских
полей
метаданных,
не
отображаемые
контент-сервером
в
представлениях
/opds и /mobile.
Например:
my_rating,my_tags
- --listen-on
- Интерфейс
для
прослушивания
входящих
соединений.
По
умолчанию -
слушать на
всех
доступных
интерфейсах.
Вы можете
изменить
это,
например,
на "127.0.0.1",
чтобы
ожидать
соединения
только от
локальной
машины, или
на "::",
чтобы
слушать
все
входящие
соединения
IPv6 и IPv4.
- --log
- Путь к
файлу лога
сервера.
Этот лог
содержит
информацию
сервера и
ошибки, не
ошибки
доступа. По
умолчанию
пишется в
stdout.
- --manage-users
- Управлять
пользователями
базы
данных,
которым
разрешено
подключаться
к этому
серверу.
Смотрите
так же
параметр
--userdb.
- --max-job-time
- Макс. время
жизни
рабочих
процессов.
Максимально
допустимое
время
жизни
запущенного
рабочего
процесса (в
минутах).
Установите
в ноль для
снятия
ограничения
по
времени.
- --max-jobs
- Максимальное
количество
рабочих
процессов.
Рабочие
процессы
запускаются
по мере
необходимости
для
больших
заданий,
таких как
подготовка
книги для
просмотра,
добавление
книг,
конвертирование
и т.п.
Обычно
макс.
количество
таких
процессов
зависит от
количества
ядер ЦП. Вы
можете
управлять
этим
параметром.
- --max-log-size
- Максимальный
размер
файла
журнала (в
МБ).
Максимальный
размер
файлов
журнала
/лог-файлов/,
создаваемых
сервером.
Как только
размер
лог-файла
превышает
заданный,
содержимое
файла
автоматически
ротируется.
Установка
в 0
отключает
ротацию.
- --max-opds-items
- Максимальное
число книг
в фиде OPDS.
Максимальное
число книг,
которое
сервер
вернёт в
одном
принимающем
фиде OPDS.
- --max-opds-ungrouped-items
- Максимальное
число
несгрупированных
элементов
в фидах OPDS.
Группировать
элементы
по
категориям,
таким как
автор/теги
по первой
букве,
когда
элементов
больше, чем
это число.
Установите
в 0 для
отключения.
- --num-per-page
- Количество
книг для
показа на
одной
странице.
Количество
книг,
отображаемых
на одной
странице в
браузере.
- --pidfile
- Записать PID
процесса в
указанный
файл
- --port
- Порт для
входящих
соединений.
- --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