calibre-server - calibre-server
calibre-server [options] [path to library folder ...]
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 calibre-server. Se não especificar
qualquer caminho, serão utilizadas todas as bibliotecas que o
programa principal Calibre conheça.
Sempre que passar argumentos para o calibre-server que
contenham espaços ponha-os entre aspas. Por exemplo: "/some
path/with spaces"
- --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.
- --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. Define o modo de
autenticação HTTP usado pelo servidor. Definir como
"basic" se usar o servidor atrás 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 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. 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.
- --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.
- --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.
- --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-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.
- --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.
- --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.
- --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. 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.
- --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. A
predefinição é escutar em todas as interfaces IPv4 e
IPv6 disponíveis. Pode mudar isto para, por exemplo,
'127.0.0.1' e assim escutar apenas as ligações
da máquina local, ou alterar para '0.0.0.0' e escutar
todas as ligações de entrada 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
predefinição é escrito no stdout.
- --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 --manage-users -- help para detalhes. Veja
também a opção --userdb.
- --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. 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.
- --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.
- --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.
- --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
- Caminho para um ficheiro JSON contendo URLs para a funcionalidade
"Pesquisar na internet". 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.
- --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.
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.
- --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
- Caminho para a base de dados de utilizadores a usar para
autenticação. A base de dados é um ficheiro SQLite.
Para o criar use --manage-users. Pode ler mais sobre como gerir
utilizadores em:
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.