.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "CALIBRE-SERVER" "1" "abril 19, 2024" "7.9.0" "calibre" .SH NAME calibre-server \- calibre-server .INDENT 0.0 .INDENT 3.5 .sp .nf .ft B calibre\-server [options] [path to library folder ...] .ft P .fi .UNINDENT .UNINDENT .sp Inicie o servidor de conteúdos Calibre. O servidor de conteúdos do Calibre expõe a sua biblioteca Calibre na Internet. Você pode especificar o caminho para a pasta da biblioteca com os argumentos para \fBcalibre\-server\fP\&. Se não especificar qualquer caminho, serão utilizadas todas as bibliotecas que o programa principal Calibre conheça. .sp Sempre que passar argumentos para o \fBcalibre\-server\fP que contenham espaços ponha\-os entre aspas. Por exemplo: \(dq/some path/with spaces\(dq .SH [OPÇÕES] .INDENT 0.0 .TP .B \-\-access\-log Caminho para o ficheiro de historial de acessos. Este historial contém informações sobre os clientes que se ligam e fazem pedidos ao servidor. Por predefinição, não é efetuado qualquer historial de acesso. .UNINDENT .INDENT 0.0 .TP .B \-\-ajax\-timeout O tempo em segundos para aguardar por uma resposta do servidor ao efetuar pedidos. .UNINDENT .INDENT 0.0 .TP .B \-\-auth\-mode Escolher o tipo de autenticação a usar. Define o modo de autenticação HTTP usado pelo servidor. Definir como \fB\(dq\fPbasic\fB\(dq\fP se usar o servidor atrás de um proxy SSL. Senão, deixe como \fB\(dq\fPauto\fB\(dq\fP, que usará \fB\(dq\fPbasic\fB\(dq\fP se o SSL estiver configurado, ou \fB\(dq\fPdigest\fB\(dq\fP se não estiver configurado. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-ban\-for Banir endereços IP que apresentem erros de autenticação continuados. Banir temporariamente o acesso a endereços IP que tenham falhas de autenticação repetidas no número de minutos especificado. Útil para evitar tentativas de adivinhar senhas. Se definido como zero, nenhum banimento será efetuado. .UNINDENT .INDENT 0.0 .TP .B \-\-book\-list\-mode Escolher o modo de listagem de livros predefinido. Define o modo de lista de livros predefinida que será utilizada para novos utilizadores. Utilizadores individuais podem sobrepor\-se ao modo predefinido nas suas próprias configurações. O predefinido é utilizar uma grelha de capas. .UNINDENT .INDENT 0.0 .TP .B \-\-compress\-min\-size Tamanho mínimo para que a resposta utilize compressão de dados (em bytes). .UNINDENT .INDENT 0.0 .TP .B \-\-custom\-list\-template Caminho para um ficheiro JSON contendo um modelo para o modo de lista de livros personalizados. A maneira mais fácil de criar esse ficheiro de modelo é ir a Preferências\-> Partilha na rede\-> Modelo para lista de livros, criar o modelo e exportá\-lo. .UNINDENT .INDENT 0.0 .TP .B \-\-daemonize Executar processo em segundo plano como um Daemon (apenas para Linux). .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-allow\-socket\-preallocation, \-\-disable\-allow\-socket\-preallocation Pré\-alocação de encaixe, por exemplo, com ativação de encaixe systemd. Por predefinição, a opção esta ativada. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-auth, \-\-disable\-auth Autenticação por senha para aceder ao servidor. Por predefinição, o servidor não tem restrições, permitindo que qualquer pessoa lhe possa aceder. Pode restringir o acesso a utilizadores predefinidos com esta opção. Por predefinição, a opção esta desativada. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-fallback\-to\-detected\-interface, \-\-disable\-fallback\-to\-detected\-interface Substituir pela interface detetada automaticamente. Se. por algum motivo, o servidor não conseguir associar a interface especificada na opção listen_on, ele tentará detetar uma interface que se ligue ao mundo exterior e associar\-se a ela. Por predefinição, a opção esta ativada. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-local\-write, \-\-disable\-local\-write Permitir que ligações locais não autenticadas realizem alterações. Normalmente, se não ativar a autenticação o servidor operará no modo de apenas leitura, para não permitir que utilizadores anónimos façam alterações nas suas bibliotecas Calibre. Essa opção permite que qualquer pessoa que se ligue no mesmo computador em que o servidor está a ser executado possa fazer alterações. Isto é útil se deseja executar o servidor sem autenticação, mas ainda usar o calibredb para fazer alterações nas suas bibliotecas Calibre. Note que ativar esta opção significa que qualquer programa em execução no computador também pode fazer alterações nas suas bibliotecas Calibre. Por predefinição, a opção esta desativada. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-log\-not\-found, \-\-disable\-log\-not\-found Registar pedidos HTTP 404 (Não encontrado). Por predefiniçã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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-enable\-use\-sendfile, \-\-disable\-use\-sendfile Cópia zero na transferência de ficheiros para melhor desempenho. Isto usará transferências de tipo zero\-copy no Kernel ao enviar ficheiros pela rede, aumentado a performance. Entretanto, pode causar transferências corrompidas de ficheiros em alguns sistemas de ficheiros com problemas. Desative se verificar transferências de corrompidas. Por predefinição, a opção esta ativada. .UNINDENT .INDENT 0.0 .TP .B \-\-help, \-h mostrar esta mensagem de ajuda e sair .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-listen\-on A interface sob a qual escutar ligações. A predefinição é escutar em todas as interfaces IPv4 e IPv6 disponíveis. Pode mudar isto para, por exemplo, \fB\(aq\fP127.0.0.1\fB\(aq\fP e assim escutar apenas as ligações da máquina local, ou alterar para \fB\(aq\fP0.0.0.0\fB\(aq\fP e escutar todas as ligações de entrada IPv4. .UNINDENT .INDENT 0.0 .TP .B \-\-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 predefinição é escrito no stdout. .UNINDENT .INDENT 0.0 .TP .B \-\-manage\-users Gere a base de dados de utilizadores com permissão para ligar a este servidor. Pode usar de modo automático ao adicionar um \-\-. Ver calibre\-server \fI\%\-\-manage\-users\fP \fB\-\-\fP help para detalhes. Veja também a opção \fI\%\-\-userdb\fP\&. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-header\-line\-size Tamanho máximo de cabeçalho HTTP individual (em KB). .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-jobs Número máximo de processos de trabalho. As aplicações de processos de trabalho são iniciadas conforme necessário e usadas em grandes trabalhos, como preparar um livro para visualização, adicionar livros, converter etc. Normalmente, o número máx. de tais processos é baseado no número de núcleos de CPU. Você pode controlar esse número nesta configuração. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-log\-size Tamanho máx. do ficheiro log. (em MB). Tamanho máximo dos ficheiros de diário gerado pelo servidor. Quando o registo diário se tornar maior que este tamanho, será feita uma rotação automática. Defina para zero para desativar rotação de diário. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-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. .UNINDENT .INDENT 0.0 .TP .B \-\-max\-request\-body\-size Tamanho máximo para ficheiros a carregar para o servidor (em MB). .UNINDENT .INDENT 0.0 .TP .B \-\-num\-per\-page Número de livros a mostrar numa só pagina. O número de livros a mostrar numa só pagina no navegador. .UNINDENT .INDENT 0.0 .TP .B \-\-pidfile Escreva o processo com o PID para o ficheiro especificado .UNINDENT .INDENT 0.0 .TP .B \-\-port A porta onde escutar ligações. .UNINDENT .INDENT 0.0 .TP .B \-\-search\-the\-net\-urls Caminho para um ficheiro JSON contendo URLs para a funcionalidade \fB\(dq\fPPesquisar na internet\fB\(dq\fP\&. A maneira mais fácil de criar esse ficheiro é ir a Preferências\-> Partilhar na rede\->Pesquisar internet no Calibre, criar os URL e exportá\-los. .UNINDENT .INDENT 0.0 .TP .B \-\-shutdown\-timeout Número de segundos de espera para um encerrar limpo. .UNINDENT .INDENT 0.0 .TP .B \-\-ssl\-certfile Caminho para o ficheiro do certificado SSL. .UNINDENT .INDENT 0.0 .TP .B \-\-ssl\-keyfile Caminho para o ficheiro da chave privada SSL. .UNINDENT .INDENT 0.0 .TP .B \-\-timeout O tempo em segundos após o qual uma ligação inativa será encerrada. .UNINDENT .INDENT 0.0 .TP .B \-\-trusted\-ips Permitir que ligações não autenticadas, mas de endereços IP específicos, realizem alterações. Normalmente, se não ativar a autenticação o servidor operará no modo de apenas leitura, para não permitir que utilizadores anónimos façam alterações nas suas bibliotecas Calibre. Essa opção permite que qualquer pessoa que se ligue a partir do endereço IP especificado possa fazer alterações. Deve ser uma lista separada por vírgulas de endereços ou especificações de redes. Isto é útil se deseja executar o servidor sem autenticação, mas ainda usar o calibredb para fazer alterações nas suas bibliotecas Calibre. Note que ativar esta opção significa que qualquer pessoa que se ligue a partir dos endereços de IP especificados pode fazer alterações nas suas bibliotecas Calibre. .UNINDENT .INDENT 0.0 .TP .B \-\-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 .UNINDENT .INDENT 0.0 .TP .B \-\-userdb Caminho para a base de dados de utilizadores a usar para autenticação. A base de dados é um ficheiro SQLite. Para o criar use \fI\%\-\-manage\-users\fP\&. Pode ler mais sobre como gerir utilizadores em: \fI\%https://manual.calibre\-ebook.com/pt/server.html#managing\-user\-accounts\-from\-the\-command\-line\-only\fP .UNINDENT .INDENT 0.0 .TP .B \-\-version mostrar o número da versão do programa e sair .UNINDENT .INDENT 0.0 .TP .B \-\-worker\-count Número máximo de processos de trabalho para executar pedidos. .UNINDENT .SH AUTHOR Kovid Goyal .SH COPYRIGHT Kovid Goyal .\" Generated by docutils manpage writer. .