OPDS do calibre-web no iPhone e no iPad: o endereço exato e o login

Resposta rápida: o feed OPDS do calibre-web fica em http://<seu-servidor>:8083/opds. Ele pede o mesmo usuário e senha que você usa na interface web do calibre-web, por autenticação HTTP Basic, e sua sessão do navegador não vale para o feed, então você digita tudo de novo no aplicativo de leitura. O Calibre-Web-Automated usa exatamente o mesmo endereço e o mesmo login. Adicione essa URL como catálogo OPDS personalizado em um leitor no seu iPhone ou iPad e sua biblioteca do Calibre aparece.

Tudo abaixo foi verificado em 2026-08-24 contra o calibre-web 0.6.27 e o Calibre-Web-Automated v4.0.6, ambos rodando a partir das imagens oficiais contra uma biblioteca real do Calibre, em vez de copiado da documentação.

O endereço, e as três coisas que dão errado

1. A sessão web não autentica o feed

Esse é o erro que pega quem está com o calibre-web aberto em uma aba do navegador e presume que o leitor vai entrar da mesma forma. Não entra. O feed usa autenticação Basic, totalmente separada do cookie que seu navegador guarda, e devolve 401 com um cabeçalho WWW-Authenticate até você informar um usuário e uma senha.

Isso é uma boa notícia para a configuração: qualquer leitor OPDS que aceite usuário e senha vai conectar. No justRead, você adiciona o servidor uma vez com a URL, o usuário e a senha, e ele fica salvo.

2. Um redirecionamento em vez de um feed significa que o servidor não está configurado

Antes de o calibre-web estar apontado para um banco de dados do Calibre, todo caminho nele, incluindo /opds, devolve um 302 para /admin/dbconfig. Se o seu leitor reportar algo estranho em vez de pedir uma senha, abra http://<seu-servidor>:8083/ em um navegador. Se ele te mandar para uma página de configuração de banco de dados, a URL nunca foi o problema: um administrador precisa configurar o caminho da biblioteca do Calibre primeiro.

O Calibre-Web-Automated não tem esse problema. Ele já chega com uma biblioteca configurada e serve o OPDS já na primeira inicialização, o que vale saber se você está escolhendo entre os dois e quer o celular funcionando hoje.

3. Porta 8083, não 8080

8080 é o Calibre Content Server, um programa diferente do calibre-web, que cobrimos em o guia do Calibre Content Server. Os dois são constantemente confundidos, e trocar as portas produz uma falha de conexão que parece um problema de rede.

Eles também diferem na autenticação de um jeito que importa aqui: o Calibre Content Server não tem autenticação nenhuma por padrão, enquanto o calibre-web sempre exige login. Se o seu leitor conectou a um servidor parecido com o Calibre sem pedir senha, esse era o Content Server.

O que você recebe quando conecta

A raiz do OPDS do calibre-web serve quinze seções. As quinze estavam presentes nas duas versões testadas:

Livros em ordem alfabética, Livros em alta, Livros mais bem avaliados, Livros adicionados recentemente, Livros aleatórios, Livros lidos, Livros não lidos, Autores, Editoras, Categorias, Séries, Idiomas, Avaliações, Formatos de arquivo, Prateleiras.

Esse é o mesmo formato da interface web, o que é o ponto principal: os metadados que você organizou no Calibre, as séries, as avaliações, as prateleiras personalizadas, passam para o feed em vez de virar uma lista longa e achatada.

A busca aparece duas vezes, como um /opds/search/{searchTerms} no formato de template e como um descritor OpenSearch em /opds/osd, então um leitor que suporte busca no servidor consegue consultar o servidor em vez de baixar tudo e buscar localmente. Essa diferença importa a partir de alguns milhares de livros.

calibre-web vs Calibre-Web-Automated: o que realmente muda

O Calibre-Web-Automated é um fork ativamente desenvolvido que adiciona ingestão automática, conversão e tratamento de metadados sobre o calibre-web. A pergunta óbvia para um celular é se o feed OPDS dele é diferente.

Rodamos os dois lado a lado e comparamos os feeds. A resposta é: mesma URL, mesma autenticação, e exatamente uma seção a mais.

Calibre-Web Automated      (título do feed)
Calibre-Web

Magic Shelves              (presente só no CWA)

Tudo o mais é idêntico: /opds, HTTP Basic, e as mesmas quinze seções na mesma ordem. Tudo o que é verdade sobre o OPDS do calibre-web é verdade sobre o do CWA.

A única diferença prática nem está no feed. O CWA já vem com uma biblioteca configurada e responde na primeira inicialização; o calibre-web puro redireciona tudo para /admin/dbconfig até alguém configurar o caminho do banco de dados.

Conectando no iPhone ou no iPad

1. Encontre o endereço do seu servidor na rede. Um IP local como 192.168.1.20, ou um hostname se você tiver um. Fixe esse endereço nas reservas de DHCP do seu roteador, senão ele muda e o catálogo para de funcionar sem motivo aparente.
2. Confirme o feed em um navegador primeiro. Abra http://<seu-servidor>:8083/opds. Você deve ser solicitado a informar usuário e senha, e então ver uma parede de XML. Se for redirecionado para uma página de configuração, volte ao ponto 2 acima.
3. Adicione no seu leitor como um catálogo OPDS personalizado: a URL, seu usuário do calibre-web, sua senha do calibre-web.
4. Navegue e baixe. O OPDS entrega arquivos em vez de transmitir páginas, então um livro é baixado para o dispositivo e lido ali. Isso também significa que continua funcionando quando você está longe do servidor, e que sua posição de leitura fica no celular em vez de sincronizar de volta para o calibre-web.

Para a versão genérica desses passos, válida para qualquer servidor, veja como configurar OPDS no iPhone e no iPad.

Acessando de fora de casa

Dentro da sua própria rede, HTTP puro funciona bem e é a coisa mais simples que dá certo.

De fora, não simplesmente encaminhe a porta 8083. Duas abordagens valem o esforço:

• Um proxy reverso com um certificado de verdade. Caddy ou nginx na frente do calibre-web, com um certificado do Let's Encrypt, te dá HTTPS que o iOS confia sem nenhuma configuração no aparelho.
• Uma VPN ou uma rede mesh de volta para a sua LAN, depois do que o endereço local funciona sem alterações de qualquer lugar.

O que não funciona de forma casual é um certificado autoassinado. O iOS recusa um a menos que o certificado esteja instalado no dispositivo e explicitamente confiado em Ajustes, Geral, Sobre, Configurações de Confiança de Certificado. Até lá a conexão simplesmente falha, e a falha parece exatamente com o servidor estar fora do ar em vez de um problema de certificado.

Falhas comuns, na ordem em que costumam acontecer

"Ele pede uma senha e recusa a certa." O calibre-web tem suas próprias contas de usuário, separadas de qualquer login do sistema operacional. Use a conta com que você entra na interface web do calibre-web. O padrão em uma instalação nova é admin com a senha admin123, que você deve trocar antes de deixar qualquer coisa acessível de fora.

"Recebo um redirecionamento, não um feed." O caminho do banco de dados não está configurado. Veja acima.

"Funcionou ontem e não funciona hoje." Quase sempre o IP do servidor mudou. Reserve-o no seu roteador.

"O catálogo está vazio." O calibre-web está apontado para uma biblioteca do Calibre sem livros, ou para um diretório que não é uma biblioteca do Calibre. A interface web vai parecer igualmente vazia; confira ali primeiro, porque o feed só reflete o que o próprio calibre-web consegue ver.

"Alguns livros não baixam." O calibre-web serve os formatos presentes na sua biblioteca do Calibre. Se um livro existe só como AZW3 ou MOBI, converta para EPUB no Calibre no computador e o formato convertido aparece no feed.

Onde isso se encaixa entre as outras opções

Se seus livros estão no Calibre e você quer eles no iPhone, existem três rotas, e elas são genuinamente diferentes:

• calibre-web, esta página: um front-end web que roda sem o aplicativo de desktop do Calibre aberto, com contas de usuário e um feed OPDS em :8083/opds.
• O Calibre Content Server, em :8080/opds, que vem embutido no próprio Calibre e precisa do aplicativo de desktop ou do calibre-server rodando. Não tem autenticação até você habilitar. Veja o guia do Content Server.
• Uma pasta na nuvem ou cópia direta de arquivo, que não precisa de servidor nenhum. Veja como sincronizar o Calibre com o iPhone e o iPad.

O justRead se conecta às três, e também ao Komga, ao Kavita, ao COPS e a qualquer outro servidor OPDS, com filtragem e paginação por servidor para que uma biblioteca grande continue utilizável no celular. A página do leitor OPDS traz a URL e o método de autenticação verificados de cada servidor que já testamos, e a lista de catálogos OPDS gratuitos cobre catálogos públicos, não a sua própria biblioteca.

Baixe o justRead na App Store e aponte-o para o seu servidor calibre-web.