calibre-server - calibre-server
calibre-server [опции] [путь к папке библиотеки…]
Запустить
контент-сервер
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-адресов с
повторными
ошибками
входа в
течение
указанного
количества
минут.
Полезно
для
предотвращения
попыток
подбора
паролей.
Если
установлено
в ноль,
запрет не
выполняется.
- --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
- Интерфейс
для
прослушивания
входящих
соединений.
По
умолчанию -
слушать на
всех
доступных
IPv4
интерфейсах.
Вы можете
изменить
это,
например,
на "127.0.0.1",
чтобы
ожидать
соединения
только от
локальной
машины, или
на "::",
чтобы
слушать
все
входящие
соединения
IPv6 и IPv4.
- --log
- Путь к
файлу
журнала
сервера.
Журнал
содержит
информацию
сервера и
ошибки, а
не журналы
доступа. По
умолчанию
пишется в
stdout.
- --manage-users
- Управляйте
базой
данных
пользователей,
которым
разрешено
подключаться
к этому
серверу.
Возможно
использование
в
автоматическом
режиме
добавив --.
Подробнее
см. calibre-server --manage-users -- help.
См. также
параметр
--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
- Время (в
секундах)
до
отключения
холостого
соединения.
- --trusted-ips
- Разрешить
неаутентифицированным
соединениям
с
определенных
IP-адресов
вносить
изменения.
Обычно,
если вы не
включаете
аутентификацию,
сервер
работает в
режиме
только для
чтения,
чтобы
анонимные
пользователи
не вносили
изменений
в ваши
библиотеки.
Эта опция
позволяет
любому
пользователю
подключаться
к серверу calibre
для
внесения
изменений.
Должен
быть
список
адресов
или
спецификаций
сетей
через
запятую.
Небезопасно
запускать
сервер без
проверки
подлинности,
с
использованием
calibredb для
внесения
изменений
в ваши
библиотеки.
Обратите
внимание,
что
включение
этой опции
означает,
что любой,
кто
подключается
с
указанных
IP-адресов,
может
вносить
изменения
в ваши
библиотеки.
- --url-prefix
- Префикс,
добавляемый
ко всем URL-ам.
Полезно,
если вы
хотите
запустить
этот
сервер за
обратным
прокси.
Например,
используйте
/calibre в
качестве
префикса URL.
- --version
- показать
версию
программы
и выйти
- --worker-count
- Количество
рабочих
потоков
для
обработки
запросов.
Kovid Goyal
Kovid Goyal