Arch manual pages

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

calibre-server - calibre-server

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


Inicie o servidor de conteúdo calibre. O servidor de conteúdo do calibre apresenta sua biblioteca calibre na internet. Você pode especificar o caminho para as pastas da biblioteca com os argumentos para calibre-server. Se você não especificar algum caminho, todas as bibliotecas do programa calibre principal conhecidas serão usadas..

Sempre que você for passar argumentos para calibre-server que possuem espaços em branco, coloque o argumento dentro de aspas. Por exemplo: "/some path/with spaces"

--access-log
Caminho para o arquivo de registro de acessos. Este registro contém informações sobre os clientes que se conectam e fazem requisições. Por padrão nenhum registro de acesso é feito.

--ajax-timeout
Tempo (em segundos) para esperar uma resposta do servidor quando rodando pesquisas.

--auth-mode
Escolha o tipo de autenticação usada. Define o modo de autenticação HTTP usado pelo servidor. Defina como "basic" se usar o servidor por meio de um proxy SSL. Senão, deixe como "auto", que usará "basic" se o SSL estiver configurado, ou "digest" se não estiver configurado.

--auto-reload
Recarregar o servidor automaticamente quando houver mudanças no código fonte. Útil para desenvolvimento. Você também deve especificar um valor mínimo para o tempo de reinicio do servidor.

--ban-after
Número de falhas de login para banimento. O número de falhas de login depois que um endereço IP é banido

--ban-for
Banir endereços IP que tem falhas de logins repetidas. Proíbe temporariamente o acesso a endereços IP que tenham falhas de login repetidas pelo número de minutos especificado. Útil para evitar tentativas de adivinhar senhas. Se definido como zero, nenhum banimento é feito.

--book-list-mode
Escolha o modo de lista de livros padrão. Define o modo de lista de livros padrão que será utilizado para novos usuários. Usuários individuais podem sobrescrever o padrão em suas próprias configurações. O padrão é utilizar uma grade de capas.

--compress-min-size
Tamanho mínimo para que resposta utilize compressão de dados (em bytes).

--custom-list-template
Caminho para um arquivo JSON contendo um modelo para o modo de lista de livros personalizados. A maneira mais fácil de criar esse arquivo de modelo é ir para Preferências-> Compartilhamento pela rede-> Modelo de lista de livros em calibre, criar o modelo e exportá-lo.

--daemonize
Rodar o processo em segundo plano como um daemon. (Linux somente)

--displayed-fields
Somente exibir campos definidos pelo usuário. Lista separada por vírgulas de campos de metadados definidos pelo usuário que serão exibidos pelo servidor de conteúdo nas exibições /opds e /mobile. Se você definir esta opção, quaisquer campos que não estiverem nessa lista não serão exibidos. Por exemplo: my_rating,my_tags

--enable-allow-socket-preallocation, --disable-allow-socket-preallocation
Pré-alocação do soquete, por exemplo, com ativação do soquete systemd. Por padrão, esta opção está habilitada

--enable-auth, --disable-auth
Autenticação baseada em senha para acessar o servidor. Por padrão o servidor é irrestrito, permitindo qualquer pessoa acessá-lo. Você pode restringir o acesso a usuários pré-definidos com esta opção. Por padrão, esta opção está desabilitada

--enable-fallback-to-detected-interface, --disable-fallback-to-detected-interface
Fallback para a interface auto detectada. Se o servidor não conseguir associar a interface especificada na opção "listen_on", ele tentará detectar uma interface que se conecte com o mundo exterior e se associará a ela. Por padrão, esta opção está habilitada

--enable-local-write, --disable-local-write
Permitir que conexões locais não autenticadas façam alterações. Normalmente, se você não ativar a autenticação, o servidor operará no modo somente leitura, para não permitir que usuários anônimos façam alterações em suas bibliotecas de calibre. Essa opção permite que qualquer pessoa conecte-se no mesmo computador em que o servidor está sendo executado para fazer alterações. Isso é útil se você deseja executar o servidor sem autenticação, mas ainda usar o calibredb para fazer alterações em suas bibliotecas de calibre. Observe que ativar essa opção significa que qualquer programa em execução no computador pode fazer alterações em suas bibliotecas de calibre. Por padrão, esta opção está desabilitada

--enable-log-not-found, --disable-log-not-found
Registrar requisições HTTP 404 (Not Found). Por padrão, o servidor loga todas as requisições HTTP para recursos que não são encontrados. Isto pode gerar muito log indesejado se seu servidor for alvo de bots. Utilize essa opção para desativá-lo. Por padrão, esta opção está habilitada

--enable-use-bonjour, --disable-use-bonjour
Anunciar feeds OPDS via BonJour. Anuncia os feeds OPDS através do serviço BonJour, de maneira que os aplicativos de leitura baseados em OPDS possam detectar e conectar ao servidor automaticamente. Por padrão, esta opção está habilitada

--enable-use-sendfile, --disable-use-sendfile
Ativar ou desativar a transferência de arquivos zero-copy para aumento de performance. Isto usará transferências zero-copy no kernel ao enviar arquivos pela rede, aumentado a performance. Entretanto, pode causar transferência de arquivos corrompidas em alguns sistemas de arquivos falhos. Se você experimentar transferências de arquivos corrompidas, desative-o. Por padrão, esta opção está habilitada

--help, -h
mostrar esta mensagem de ajuda e sair

--ignored-fields
Campos de metadados definidos pelo usuário ignorados. Lista separada por vírgulas de campos de metadados definidos pelo usuário que não serão exibidos pelo servidor de conteúdo nas exibições de /opds e de /mobile. Por exemplo: my_rating,my_tags

--listen-on
A interface que escurará por conexões. O padrão é escutar em todas as interfaces disponíveis. Você pode mudar isto para, por exemplo, "127.0.0.1" para somente escutar por conexões da máquina local, ou para "::" para escutar por todas as conexões IPv6 e IPv4.

--log
Caminho para o arquivo de registros do servidor. Este arquivo contém informações e erros do servidor, não contém informações de acesso. Por padrão é escrito no stdout.

--manage-users
Gerenciar o banco de dados de usuários com permissão de conectar nesse servidor. Veja também a opção --userdb.

--max-header-line-size
Tamanho máximo de cabeçalho HTTP único (em KB).

--max-job-time
Tempo máximo para processos de trabalho. Quantidade máxima de tempo permitida para a execução dos processos de trabalho (em minutos). Defina para zero para não ter limite.

--max-jobs
Número máximo de processos de trabalho. Processos de trabalho são criados e utilizados conforme necessário para tarefas maiores como a preparação de um livro para exibição, adição de livros, conversão, etc. Por padrão, o número máximo de tais processos é baseado no número de núcleos da CPU. Você pode controlá-lo por meio desta opção.

--max-log-size
Tamanho máximo do arquivo de log (em MB). Tamanho máximo dos arquivos de log gerado pelo servidor. Quando o log se tornar maior que este tamanho, ele é rotacionado automaticamente. Defina para zero para desabilitar rotação de log.

--max-opds-items
Número máximo de livros nos feeds OPDS. Número máximo de livros retornados pelo servidor em uma única aquisição de feed OPDS.

--max-opds-ungrouped-items
Número máximo de itens desagrupados nos feeds OPDS. Agrupa itens em categorias como autor/etiquetas pela primeira letra quando houver mais que esse número de itens. Insira zero para desativar.

--max-request-body-size
Tamanho máximo de arquivos enviados ao servidor (em MB).

--num-per-page
Número de livros a serem exibidos em uma página. Número de livros a serem exibidos em uma página do navegador.

--pidfile
Escreva o processo com o PID para o arquivo especificado

--port
A porta que escutará por conexões.

--search-the-net-urls
Caminho para um arquivo JSON contendo URLs para a função "Pesquisar na internet". O jeito mais fácil de criar este arquivo é ir em Preferências->Compartilhar pela rede->Pesquisar na internet, criar as URLs e exportá-las.

--shutdown-timeout
Tempo total em segundos de espera para um encerramento limpo.

--ssl-certfile
Caminho para o arquivo de certificado SSL.

--ssl-keyfile
Caminho para o arquivo de chave privada SSL.

--timeout
Tempo (em segundos) de espera para que uma conexão ociosa seja fechada.

--url-prefix
Um prefixo para adicionar à todas as URLs. Útil se você deseja rodar este servidor por meio de um proxy reverso.

--userdb
Caminho para o banco de dados do usuário usado para autenticação. O banco de dados é um arquivo SQLite. Para criá-lo use --manage-users. Você pode ler mais sobre como gerenciar usuários em: https://manual.calibre-ebook.com/server.html#managing-user-accounts-from-the-command-line-only

--version
mostrar número da versão do programa e sair

--worker-count
Número de threads de trabalho utilizadas para processar requisições.

Kovid Goyal

Kovid Goyal
julho 19, 2019 3.46.0