calibre-server

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

Start the calibre Content server. The calibre Content server exposes your calibre libraries over the internet. You can specify the path to the library folders as arguments to calibre-server. If you do not specify any paths, all the libraries that the main calibre program knows about will be used.

Sempre que passar argumentos para o calibre-server que contenham espaços ponha-os entre aspas. Por exemplo: «/some path/with spaces»

[opções]

--access-log

Path to the access log file. This log contains information about clients connecting to the server and making requests. By default no access logging is done.

--ajax-timeout

O tempo em segundos para aguardar por uma resposta do servidor ao efetuar pedidos.

--auth-mode

Escolher o tipo de autenticação a usar. Set the HTTP authentication mode used by the server. Set to "basic" if you are putting this server behind an SSL proxy. Otherwise, leave it as "auto", which will use "basic" if SSL is configured otherwise it will use "digest".

--auto-reload

Recarregar o servidor automaticamente quando houver mudanças no código fonte. Útil para desenvolvimento. Você também deve especificar um valor pequeno para o tempo limite de encerramento do servidor.

--ban-after

Número de erros de autenticação até ser banido. Número de erros de autenticação até que um endereço de IP seja banido

--ban-for

Banir endereços IP que apresentem erros de autenticação continuados. Temporarily bans access for IP addresses that have repeated login failures for the specified number of minutes. Useful to prevent attempts at guessing passwords. If set to zero, no banning is done.

--book-list-mode

Escolher o modo de listagem de livros predefinido. Define o modo de lista de livros padrão que será utilizado para novos utilizadores. Utilizadores individuais podem sobrepor-se ao modo padrão nas suas próprias configurações. O padrão é utilizar uma grelha de capas.

--compress-min-size

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

--custom-list-template

Path to a JSON file containing a template for the custom book list mode. The easiest way to create such a template file is to go to Preferences-> Sharing over the net-> Book list template in calibre, create the template and export it.

--daemonize

Executar processo em segundo plano como um Daemon (apenas para Linux).

--displayed-fields

Restringir exibição de campos de metadados definidos pelo utilizador. Lista separada por vírgulas de campos de metadados personalizados que serão exibidos pelo servidor de conteúdos nas saídas de /opds e /mobile. Se especificar esta opção, qualquer campo que não esteja na lista não será exibido. Por exemplo: my_rating,my_tags

--enable-allow-socket-preallocation, --disable-allow-socket-preallocation

Socket pre-allocation, for example, with systemd socket activation. Por predefinição, a opção esta ativada.

--enable-auth, --disable-auth

Autenticação por senha para aceder ao servidor. Por padrão, o servidor não tem restrições, permitindo qualquer pessoa lhe possa aceder. Pode restringir o acesso a utilizadores pré-definidos com esta opção. Por predefinição, a opção esta desativada.

--enable-fallback-to-detected-interface, --disable-fallback-to-detected-interface

Voltar à interface automaticamente detetada. If for some reason the server is unable to bind to the interface specified in the listen_on option, then it will try to detect an interface that connects to the outside world and bind to that. Por predefinição, a opção esta ativada.

--enable-local-write, --disable-local-write

Permitir que ligações locais não autenticadas realizem alterações. Normally, if you do not turn on authentication, the server operates in read-only mode, so as to not allow anonymous users to make changes to your calibre libraries. This option allows anybody connecting from the same computer as the server is running on to make changes. This is useful if you want to run the server without authentication but still use calibredb to make changes to your calibre libraries. Note that turning on this option means any program running on the computer can make changes to your calibre libraries. Por predefinição, a opção esta desativada.

--enable-log-not-found, --disable-log-not-found

Registar pedidos HTTP 404 (Não encontrado). Por padrão, o servidor regista todos os pedidos HTTP relativos a recursos que não são encontrados. Isto pode gerar muitos registos indesejados se o seu servidor for alvo de Bots. Utilize esta opção para o desativar. Por predefinição, a opção esta ativada.

--enable-use-bonjour, --disable-use-bonjour

Divulgar sinal OPDS através de BonJour. Anuncia os sinais OPDS através do serviço BonJour, de modo que as aplicações de leitura baseadas em OPDS possam detetar e ligar-se ao servidor automaticamente. Por predefinição, a opção esta ativada.

--enable-use-sendfile, --disable-use-sendfile

Cópia zero na transferência de ficheiros para melhor desempenho. This will use zero-copy in-kernel transfers when sending files over the network, increasing performance. However, it can cause corrupted file transfers on some broken filesystems. If you experience corrupted file transfers, turn it off. Por predefinição, a opção esta ativada.

--help, -h

mostrar esta mensagem de ajuda e sair

--ignored-fields

Campos de metadados personalizados a ignorar. Lista separada por vírgulas de campos de metadados personalizados que não serão exibidos pelo servidor de conteúdos nas saídas de /opds e /mobile. Por exemplo: my_rating,my_tags

--listen-on

A interface sob a qual escutar ligações. Por padrão, irá escutar em todas as interfaces IPv4 disponíveis. Pode mudar isso para, por exemplo, '127.0.0.1' e assim escutar apenas as ligações da máquina local, ou alterar para '::' e escutar todas as ligações de entrada IPv6 e IPv4.

--log

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

--manage-users

Manage the database of users allowed to connect to this server. You can use it in automated mode by adding a –. See calibre-server --manage-users -- help for details. See also the --userdb option.

--max-header-line-size

Tamanho máximo de cabeçalho HTTP individual (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. Worker processes are launched as needed and used for large jobs such as preparing a book for viewing, adding books, converting, etc. Normally, the max. number of such processes is based on the number of CPU cores. You can control it by this setting.

--max-log-size

Tamanho máx. do ficheiro log. (em MB). The maximum size of log files, generated by the server. When the log becomes larger than this size, it is automatically rotated. Set to zero to disable log rotation.

--max-opds-items

Número máximo de livros no sinal OPDS. Número máximo de livros que o servidor fornece por cada sinal de aquisição de OPDS único.

--max-opds-ungrouped-items

Número máximo de itens não agrupados em sinais OPDS. Agrupar itens em categorias tais como autores/etiquetas pela primeira lera quando existir mais que este número de itens. Escolha 0 para desativar.

--max-request-body-size

Tamanho máximo para ficheiros a carregar para o servidor (em MB).

--num-per-page

Número de livros a mostrar numa só pagina. O número de livros a mostrar numa só pagina no navegador.

--pidfile

Escreva o processo com o PID para o ficheiro especificado

--port

A porta onde escutar ligações.

--search-the-net-urls

Path to a JSON file containing URLs for the "Search the internet" feature. The easiest way to create such a file is to go to Preferences-> Sharing over the net->Search the internet in calibre, create the URLs and export them.

--shutdown-timeout

Número de segundos de espera para um encerrar limpo.

--ssl-certfile

Caminho para o ficheiro do certificado SSL.

--ssl-keyfile

Caminho para o ficheiro da chave privada SSL.

--timeout

O tempo em segundos após o qual uma ligação inativa será encerrada.

--trusted-ips

Permitir que ligações não autenticadas, mas de endereços IP específicos, realizem alterações. Normally, if you do not turn on authentication, the server operates in read-only mode, so as to not allow anonymous users to make changes to your calibre libraries. This option allows anybody connecting from the specified IP addresses to make changes. Must be a comma separated list of address or network specifications. This is useful if you want to run the server without authentication but still use calibredb to make changes to your calibre libraries. Note that turning on this option means anyone connecting from the specified IP addresses can make changes to your calibre libraries.

--url-prefix

Prefixo a anteceder todos os URL. Útil se você deseja rodar este servidor por trás de um proxy reverso. Por exemplo, use /calibre como prefixo de URL

--userdb

Path to the user database to use for authentication. The database is a SQLite file. To create it use --manage-users. You can read more about managing users at: https://manual.calibre-ebook.com/pt/server.html#managing-user-accounts-from-the-command-line-only

--version

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

--worker-count

Número máximo de processos de trabalho para executar pedidos.